Configurare Google Play Services

Per sviluppare un'app utilizzando le API Google Play Services, segui le istruzioni riportate in questa pagina per configurare il tuo progetto con gli SDK pertinenti, disponibili nel repository GKE di Google.

Per testare la tua app quando utilizzi Google Play Services, devi utilizzare uno dei seguenti:

  • Un dispositivo Android compatibile con Android 5.0 (livello API 21) o versioni successive su cui è installata l'app Google Play Store.
  • L'emulatore Android con un AVD che esegue la piattaforma API di Google basata su Android 5.0 (livello API 21) o versioni successive.

Dichiarare le dipendenze per Google Play Services

Per sviluppare funzionalità che dipendono dalle API Google Play Services nella tua app, completa questi passaggi:

  1. Apri il file build.gradle nella directory del modulo dell'app.

  2. Per ogni SDK richiesto dalla tua app, includi la dipendenza per quell'SDK. Questa pagina include una sezione che elenca le dipendenze di Google Play Services comuni per le app per Android. Potresti anche voler aggiungere dipendenze Firebase al tuo progetto.

  3. Salva le modifiche e sincronizza il progetto.

Lo snippet seguente mostra un file build.gradle di esempio che utilizza la libreria delle posizioni:

apply plugin: 'com.android.application'

...

dependencies {
    implementation 'com.google.android.gms:play-services-location:21.2.0'
}

Vengono rilasciate periodicamente nuove versioni degli SDK di Google Play Services con correzioni di bug e nuove funzionalità. Questi aggiornamenti vengono annunciati nelle note di rilascio. Se la tua app utilizza una dipendenza che è stata aggiornata, passa alla versione più recente nelle dipendenze dell'app per sfruttare queste correzioni.

Controllare se Google Play Services è installato

Come descritto nella panoramica di Google Play Services, Google Play Services riceve aggiornamenti automatici su Android 5.0 (livello API 21) e versioni successive tramite l'app Google Play Store. Tuttavia, sui dispositivi Android senza Google Play Store non è installato Google Play Services. Se la tua app viene eseguita su dispositivi senza Google Play Services, ti consigliamo di verificare se Google Play Services è installato sul dispositivo prima di provare a utilizzare le API di Google oppure di attivare le funzionalità nell'app che richiedono il funzionamento di Google Play Services.

Per verificare la presenza di Google Play Services sul dispositivo, usa il metodo isGooglePlayServicesAvailable().

Per avviare una connessione a Google Play Services o per scoprire come rilevare se la versione di Google Play Services installata supporta un'API specifica, leggi la guida relativa all'accesso alle API di Google.

Dipendenze di Google Play Services

Nella tabella che segue sono elencate le dipendenze di Google Play Services che puoi includere nella tua app per Android. Puoi filtrare l'elenco in base al tipo di dispositivo selezionando uno dei pulsanti e cercare un nome di dipendenza o un caso d'uso specifico inserendo il testo nella casella visualizzata dopo i pulsanti.

Tabella 1. Dipendenze di Google Play Services da includere nelle app per Android
Caso d'uso e nome della dipendenza Dispositivi supportati
Annunci per dispositivi mobili di Google
com.google.android.gms:play-services-ads:22.6.0
Smartphone, tablet
ID pubblicità di Android (AAID)
com.google.android.gms:play-services-ads-identifier:18.0.1
Telefono, tablet, Android TV, ChromeOS
Versione leggera di Google Mobile Ads
com.google.android.gms:play-services-ads-lite:22.6.0
Smartphone, tablet
Annunci personalizzati della rete di ricerca (CSA) di AdSense per la ricerca (AFS)
com.google.android.gms:play-services-afs-native:19.0.3
Smartphone, tablet, ChromeOS
SDK Google Analytics Services per Android
com.google.android.gms:play-services-analytics:18.0.4
Obsoleta. Utilizza Google Analytics per Firebase.
Indice di app
com.google.android.gms:play-services-appindex:16.1.0
Smartphone, tablet, Android TV
ID set di app per Android
com.google.android.gms:play-services-appset:16.0.2
Telefono, tablet, Android TV, ChromeOS
Accedi con Google per Android
com.google.android.gms:play-services-auth:21.0.0
Telefono, tablet, Android TV, Auto, Android Go, ChromeOS
API SMS Retriever
com.google.android.gms:play-services-auth-api-phone:18.0.2
Smartphone, tablet, Android Go
API Block Store (include l'archiviazione delle credenziali dell'utente)
com.google.android.gms:play-services-auth-blockstore:16.2.0
Smartphone, tablet, Android Go, ChromeOS
API Google Awareness
com.google.android.gms:play-services-awareness:19.0.1
Telefono, tablet, auto, Android Go, ChromeOS
Classi di utilità
com.google.android.gms:play-services-base:18.3.0
Telefono, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Test dei falsi per le classi di utenze
com.google.android.gms:play-services-base-testing:16.0.0
Telefono, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Altre classi di utilità
com.google.android.gms:play-services-basement:18.3.0
Telefono, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Google Cast
com.google.android.gms:play-services-cast:21.4.0
Smartphone, tablet, Android Go, ChromeOS
Google Cast Application Framework (CAF)
com.google.android.gms:play-services-cast-framework:21.4.0
Smartphone, tablet, Android Go, ChromeOS
Ricevitori Android TV
com.google.android.gms:play-services-cast-tv:21.0.1
Android TV
Scanner di codice Google
com.google.android.gms:play-services-code-scanner:16.1.0
Smartphone, tablet, Android Go, ChromeOS
Stack di rete Chromium (Cronet)
com.google.android.gms:play-services-cronet:18.0.1
Telefono, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Interazioni tra dispositivi (DTDI)
com.google.android.gms:play-services-dtdi:16.0.0-beta01
Smartphone, tablet, Android Go
Autenticazione FIDO (Fast Identity Online)
com.google.android.gms:play-services-fido:20.1.0
Telefono, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS

Supportato sui dispositivi con Android 7.0 (livello API 24) o versioni successive.
API Google Fit per Android
com.google.android.gms:play-services-fitness:21.1.0
Telefono, tablet, Android Go, ChromeOS, Wear OS
Servizi per i giochi di Google Play v2 per Android
com.google.android.gms:play-services-games-v2:19.0.0
Telefono, tablet, Android TV, Android Go, ChromeOS
SDK C nativo della versione 2 dei servizi per i giochi di Google Play per Android
com.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1
Telefono, tablet, Android TV, Android Go, ChromeOS
Servizi per i giochi di Google Play v1 per Android
com.google.android.gms:play-services-games:23.1.0
Telefono, tablet, Android TV, Android Go, ChromeOS
API Matter
com.google.android.gms:play-services-home:16.0.0
Smartphone, tablet
Google Play Instant
com.google.android.gms:play-services-instantapps:18.0.1
Smartphone, tablet, Android TV, Android Go, ChromeOS

Funzionalità supportata sui dispositivi con Android 5.0 (livello API 21) o versioni successive.
Servizi di geolocalizzazione per Android
com.google.android.gms:play-services-location:21.2.0
Telefono, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
SDK Google Maps per Android
com.google.android.gms:play-services-maps:18.2.0
Telefono, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Scansione di codici a barre ML Kit
com.google.android.gms:play-services-mlkit-barcode-scanning:18.3.0
Smartphone, tablet, Android Go, ChromeOS
Scanner di documenti ML Kit
com.google.android.gms:play-services-mlkit-document-scanner:16.0.0-beta1
Smartphone, tablet, Android Go, ChromeOS
Rilevamento dei volti ML Kit
com.google.android.gms:play-services-mlkit-face-detection:17.1.0
Smartphone, tablet, Android Go, ChromeOS
Etichettatura delle immagini ML Kit
com.google.android.gms:play-services-mlkit-image-labeling:16.0.8
Smartphone, tablet, Android Go, ChromeOS
Etichettatura personalizzata delle immagini ML Kit
com.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta5
Smartphone, tablet, Android Go, ChromeOS
Identificazione del linguaggio ML Kit
com.google.android.gms:play-services-mlkit-language-id:17.0.0
Smartphone, tablet, Android Go, ChromeOS
Risposta rapida ML Kit
com.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1
Smartphone, tablet, Android Go, ChromeOS
Segmentazione dei soggetti ML Kit
com.google.android.gms:play-services-mlkit-subject-segmentation:16.0.0-beta1
Smartphone, tablet, Android Go, ChromeOS
Riconoscimento del testo ML Kit
com.google.android.gms:play-services-mlkit-text-recognition:19.0.0
Smartphone, tablet, Android Go, ChromeOS
Riconoscimento del testo ML Kit per il cinese
com.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.0
Smartphone, tablet, Android Go, ChromeOS
Riconoscimento del testo di ML Kit per Devanagari
com.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.0
Smartphone, tablet, Android Go, ChromeOS
Riconoscimento del testo ML Kit per il giapponese
com.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.0
Smartphone, tablet, Android Go, ChromeOS
Riconoscimento del testo ML Kit per il coreano
com.google.android.gms:play-services-mlkit-text-recognition-korean:16.0.0
Smartphone, tablet, Android Go, ChromeOS
Rilevamento e connessione di dispositivi nelle vicinanze
com.google.android.gms:play-services-nearby:19.1.0
Telefono, tablet, Android TV, Auto, Android Go
Mostra licenze open source
com.google.android.gms:play-services-oss-licenses:17.0.1
Telefono, tablet, Android TV, Auto, Android Go, ChromeOS
Supportato sui dispositivi con Android 5.0 (livello API 21) o versioni successive.
Controllo qualità del blocco schermo
com.google.android.gms:play-services-password-complexity:18.0.1
Smartphone, tablet, Android Go, ChromeOS, Wear OS

Funzionalità supportata sui dispositivi con sistema operativo Android da 4.4 (livello API 19) ad Android 9 (livello API 28).
Google Wallet (in precedenza Google Pay for Passes)
com.google.android.gms:play-services-pay:16.4.0
Smartphone, tablet, Android Go, ChromeOS

Funzionalità supportata sui dispositivi con Android 5.0 (livello API 20) o versioni successive.
reCAPTCHA Enterprise per la strumentazione di app
com.google.android.gms:play-services-recaptcha:17.0.1
Telefono, tablet, Android TV, Android Go, ChromeOS
API SafetyNet (include attestazione dei dispositivi, Navigazione sicura, reCAPTCHA e verifica delle app)
com.google.android.gms:play-services-safetynet:18.0.1
Telefono, tablet, Android TV, Auto, Android Go, ChromeOS
Google Tag Manager
com.google.android.gms:play-services-tagmanager:18.0.4
Telefono, tablet, Android TV, Android Go, ChromeOS
API Tasks su Android
com.google.android.gms:play-services-tasks:18.1.0
Telefono, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Acceleration Service per Android
com.google.android.gms:play-services-tflite-acceleration-service:16.0.0-beta01
Smartphone, tablet, Android Go, ChromeOS
API GPU Delega TensorFlow Lite per Google Play Services
com.google.android.gms:play-services-tflite-gpu:16.2.0
Smartphone, tablet, Android Go, ChromeOS
API Java TensorFlow Lite per Google Play Services
com.google.android.gms:play-services-tflite-java:16.2.0-beta02
Smartphone, tablet, Android Go, ChromeOS
API TensorFlow Lite Support per Google Play Services
com.google.android.gms:play-services-tflite-support:16.1.0
Smartphone, tablet, Android Go, ChromeOS
API Thread Network
com.google.android.gms:play-services-threadnetwork:16.0.0
Smartphone, tablet
Visione per dispositivi mobili
com.google.android.gms:play-services-vision:20.1.3
Smartphone, tablet, Android Go, ChromeOS
Google Pay per i pagamenti su Android
com.google.android.gms:play-services-wallet:19.3.0
Telefono, Tablet, Auto, Android Go, ChromeOS, Wear OS
API Wearable Data Layer
com.google.android.gms:play-services-wearable:18.1.0
Smartphone, tablet, Wear OS

Plug-in Gradle

Google Play Services include anche diversi plug-in Gradle, come mostrato nella seguente tabella. Tieni presente che i pulsanti visualizzati prima della tabella precedente non modificano le informazioni visualizzate in questa tabella.

Tabella 2. Elenco dei plug-in Gradle inclusi nei servizi Google Play
Caso d'uso e nome del plug-in Gradle Dispositivi supportati
Mostra licenze open source
com.google.android.gms:oss-licenses-plugin:0.10.6
Smartphone, tablet, ChromeOS
Controllo rigoroso della versione
com.google.android.gms:strict-version-matcher-plugin:1.2.4
Telefono, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS