Configurare Google Play Services

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

Per testare l'app quando utilizzi Google Play Services, devi usare uno dei seguenti metodi:

  • Un dispositivo Android compatibile con Android 4.4 (livello API 19) 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 4.4 (livello API 19) o successive.

Dichiarare le dipendenze per Google Play Services

Per sviluppare funzionalità che dipendono dalle API di Google Play Services nella tua app:

  1. Apri il file build.gradle all'interno della directory del modulo dell'app.

  2. Per ogni SDK richiesto dalla tua app, includi la dipendenza per l'SDK. Questa pagina include una sezione in cui sono elencate le dipendenze comuni di Google Play Services per le app Android. Puoi anche aggiungere le dipendenze Firebase al progetto.

  3. Salva le modifiche e sincronizza il progetto.

Il seguente snippet mostra un file build.gradle di esempio che utilizza la libreria degli indirizzi:

apply plugin: 'com.android.application'

...

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

Vengono rilasciate periodicamente nuove versioni degli SDK Google Play Services con correzioni di bug e nuove funzionalità. Questi aggiornamenti sono annunciati nelle note di rilascio. Se la tua app utilizza una dipendenza aggiornata, passa all'ultima versione nelle dipendenze dell'app per usufruire di queste correzioni.

Controllare se Google Play Services è installato

Come descritto nella panoramica di Google Play Services, Google Play Services riceve aggiornamenti automatici su Android 4.4 (livello API 19) 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 funziona 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à dell'app che richiedono il funzionamento di Google Play Services.

Per verificare la presenza di Google Play Services sul dispositivo, utilizza 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, consulta la guida all'accesso alle API di Google.

Dipendenze Google Play Services

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

Tabella 1. Dipendenze Google Play Services da includere nelle app Android
Nome del caso d'uso e delle dipendenze Dispositivi supportati
Annunci per dispositivi mobili di Google
com.google.android.gms:play-services-ads:22.1.0
Telefono, 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.1.0
Telefono, tablet
Annunci associati alla ricerca personalizzata (AFS) di AdSense per la ricerca
com.google.android.gms:play-services-afs-native:19.0.3
Telefono, tablet, ChromeOS
SDK Google Analytics Services per Android
com.google.android.gms:play-services-analytics:18.0.2
Obsoleto. Utilizza invece Google Analytics for Firebase.
Indice app
com.google.android.gms:play-services-appindex:16.1.0
Telefono, tablet, Android TV
ID set di app 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:20.5.0
Telefono, tablet, Android TV, Auto, Android Go, ChromeOS
API SMS Retriever
com.google.android.gms:play-services-auth-api-phone:18.0.1
Telefono, tablet, Android Go
API Block Store (include l'archiviazione delle credenziali utente)
com.google.android.gms:play-services-auth-blockstore:16.2.0
Telefono, 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.2.0
Telefono, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Testare i falsi per le classi di utilità
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.2.0
Telefono, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Google Cast
com.google.android.gms:play-services-cast:21.3.0
Telefono, tablet, Android Go, ChromeOS
Framework delle applicazioni Google Cast (CAF)
com.google.android.gms:play-services-cast-framework:21.3.0
Telefono, tablet, Android Go, ChromeOS
Ricevitori Android TV
com.google.android.gms:play-services-cast-tv:21.0.0
Android TV
Scanner Google Code
com.google.android.gms:play-services-code-scanner:16.0.0
Telefono, tablet, Android Go, ChromeOS
Stack di rete di Chromium (Cronet)
com.google.android.gms:play-services-cronet:18.0.1
Telefono, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Interazioni dispositivo-dispositivo (DTDI)
com.google.android.gms:play-services-dtdi:16.0.0-beta01
Telefono, tablet, Android Go
Autenticazione FIDO (IDID online)
com.google.android.gms:play-services-fido:20.0.1
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 Google Play Giochi v2 per Android
com.google.android.gms:play-services-games-v2:17.0.0
Telefono, tablet, Android TV, Android Go, ChromeOS
SDK Google Play Giochi v2 Native C per Android
com.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1
Telefono, tablet, Android TV, Android Go, ChromeOS
Servizi Google Play Giochi 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
Telefono, tablet
Google Play Instant
com.google.android.gms:play-services-instantapps:18.0.1
Telefono, tablet, Android TV, Android Go, ChromeOS

Supportato per i dispositivi con Android 5.0 (livello API 21) o versioni successive.
Fused Location Provider for Android (include riconoscimento delle attività e geofencing)
com.google.android.gms:play-services-location:21.0.1
Telefono, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
SDK Google Maps per Android
com.google.android.gms:play-services-maps:18.1.0
Telefono, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Scansione del codice a barre del kit ML
com.google.android.gms:play-services-mlkit-barcode-scanning:18.2.0
Telefono, tablet, Android Go, ChromeOS
Rilevamento dei volti ML Kit
com.google.android.gms:play-services-mlkit-face-detection:17.1.0
Telefono, tablet, Android Go, ChromeOS
Etichettatura dell'immagine del kit ML
com.google.android.gms:play-services-mlkit-image-labeling:16.0.8
Telefono, tablet, Android Go, ChromeOS
Etichettatura personalizzata dell'immagine del kit ML
com.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta4
Telefono, tablet, Android Go, ChromeOS
Identificazione lingua del kit ML
com.google.android.gms:play-services-mlkit-language-id:17.0.0
Telefono, tablet, Android Go, ChromeOS
Risposta rapida del kit ML
com.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1
Telefono, tablet, Android Go, ChromeOS
Riconoscimento del testo del kit ML
com.google.android.gms:play-services-mlkit-text-recognition:19.0.0
Telefono, tablet, Android Go, ChromeOS
Riconoscimento del testo del Kit ML per il cinese
com.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.0
Telefono, tablet, Android Go, ChromeOS
Riconoscimento del testo del Kit ML per Devanagari
com.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.0
Telefono, tablet, Android Go, ChromeOS
Riconoscimento del testo del Kit ML per il giapponese
com.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.0
Telefono, tablet, Android Go, ChromeOS
Riconoscimento del testo del Kit ML per il coreano
com.google.android.gms:play-services-mlkit-text-recognition-korean:16.0.0
Telefono, tablet, Android Go, ChromeOS
Rilevamento e connessione di dispositivi nelle vicinanze
com.google.android.gms:play-services-nearby:18.5.0
Telefono, tablet, Android TV, Android, 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
Supportati su dispositivi con Android 5.0 (livello API 21) o versioni successive.
Controllo della qualità del blocco schermo
com.google.android.gms:play-services-password-complexity:18.0.1
Telefono, tablet, Android Go, ChromeOS, Wear OS

Supportato per i dispositivi con sistema operativo Android 4.4 (livello API 19) e Android 9 (livello API 28).
Google Pay for Passes
com.google.android.gms:play-services-pay:16.1.0
Telefono, tablet, Android Go, ChromeOS

Supportato per dispositivi con Android 5.0 (livello API 20) o versioni successive.
reCAPTCHA Enterprise per la strumentazione delle app
com.google.android.gms:play-services-recaptcha:17.0.1
Telefono, tablet, Android TV, Android Go, ChromeOS
API SafetyNet (include l'attestazione del dispositivo, la navigazione sicura, reCAPTCHA e la 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.2
Telefono, tablet, Android TV, Android Go, ChromeOS
API Tasks su Android
com.google.android.gms:play-services-tasks:18.0.2
Telefono, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Acceleration Service for Android
com.google.android.gms:play-services-tflite-acceleration-service:16.0.0-beta01
Telefono, tablet, Android Go, ChromeOS
API Delegato GPU TensorFlow Lite per Google Play Services
com.google.android.gms:play-services-tflite-gpu:16.2.0
Telefono, tablet, Android Go, ChromeOS
API Java TensorFlow Lite per Google Play Services
com.google.android.gms:play-services-tflite-java:16.1.0
Telefono, tablet, Android Go, ChromeOS
API TensorFlow Lite Support per Google Play Services
com.google.android.gms:play-services-tflite-support:16.1.0
Telefono, tablet, Android Go, ChromeOS
API Thread Network
com.google.android.gms:play-services-threadnetwork:16.0.0
Telefono, tablet
Visione mobile
com.google.android.gms:play-services-vision:20.1.3
Telefono, tablet, Android Go, ChromeOS
Google Pay per i pagamenti su Android
com.google.android.gms:play-services-wallet:19.2.0-beta01
Telefono, tablet, auto, Android Go, ChromeOS, Wear OS
API Wearable Data Layer
com.google.android.gms:play-services-wearable:18.0.0
Telefono, tablet, Wear OS

Plug-in Gradle

Google Play Services include anche numerosi plug-in Gradle, come mostrato nella tabella riportata di seguito. 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 in Google Play Services
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
Telefono, tablet, ChromeOS
Rigoroso controllo della versione
com.google.android.gms:strict-version-matcher-plugin:1.2.4
Telefono, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS