Configurare Google Play Services

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

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

  • Un dispositivo Android compatibile con sistema operativo Android 7.0 (livello API 24) o superiore e con l'app Google Play Store installata.
  • L'emulatore Android con un AVD che esegue la piattaforma API di Google basata su Android 7.0 (livello API 24) o superiore.

Dichiarare le dipendenze per i servizi Google Play

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

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

  2. Per ogni SDK richiesto dalla tua app, includi la dipendenza relativa a tale SDK. Questa pagina include una sezione che elenca le dipendenze comuni dei servizi Google Play per le app Android. Potresti anche voler aggiungere Firebase al tuo progetto.

  3. Salva le modifiche e sincronizza il tuo progetto.

Il seguente frammento mostra un esempio di file build.gradle che utilizza la libreria location:

apply plugin: 'com.android.application'

...

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

Periodicamente vengono rilasciate nuove versioni degli SDK di 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 che è stata aggiornata, passa alla versione più recente nelle dipendenze della tua app per usufruire di queste correzioni.

Verifica se Google Play Services è installato.

Come descritto nella Panoramica di Google Play Services, Google Play Services viene aggiornato automaticamente su Android 7.0 (livello API 24) e versioni successive tramite l'app Google Play Store. Tuttavia, i dispositivi senza Google Play Store non hanno Google Play Services installato. Se la tua app viene eseguita su dispositivi sprovvisti di Google Play Services, dovresti sempre verificare se Google Play Services è installato prima di tentare di utilizzare le API di Google o di abilitare funzionalità che li richiedono.

Per verificare la presenza di Google Play Services sul dispositivo, utilizzare 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 una specifica API, consulta la guida Accesso alle API di Google.

Dipendenze di Google Play Services

La tabella seguente elenca 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 puoi cercare un caso d'uso specifico o il nome di una dipendenza inserendo del testo nella casella che appare dopo i pulsanti.

Tabella 1. Dipendenze di Google Play Services da includere nelle app per Android
Nome del caso d'uso e della dipendenza Dispositivi supportati
Google Mobile Ads
com.google.android.gms:play-services-ads:25.4.0
Telefono, tablet
ID pubblicità di Android (AAID)
com.google.android.gms:play-services-ads-identifier:18.3.0
Telefono, tablet, Android TV, ChromeOS
Versione leggera di Google Mobile Ads
com.google.android.gms:play-services-ads-lite:25.0.0
Smartphone, tablet
AdSense per la ricerca (AFS) annunci della rete di ricerca personalizzata (CSA)
com.google.android.gms:play-services-afs-native:19.1.0
Smartphone, tablet, ChromeOS
SDK Google Analytics Services per Android
com.google.android.gms:play-services-analytics:18.1.1
Deprecato. Utilizza Google Analytics per Firebase invece.
Indice delle app
com.google.android.gms:play-services-appindex:16.2.0
Telefono, tablet, Android TV
AppSearch
com.google.android.gms:play-services-appsearch:16.0.1
Smartphone, tablet, Android TV
ID set di app Android
com.google.android.gms:play-services-appset:16.1.0
Telefono, tablet, Android TV, ChromeOS
Accedi con Google per Android
com.google.android.gms:play-services-auth:22.0.0
Telefono, Tablet, Android TV, Auto, Android Go, ChromeOS
API SMS Retriever
com.google.android.gms:play-services-auth-api-phone:18.3.1
Telefono, tablet, Android Go
API Block Store (include l'archivio credenziali utente)
com.google.android.gms:play-services-auth-blockstore:16.4.0
Telefono, tablet, Android Go, ChromeOS
API di Google Awareness
com.google.android.gms:play-services-awareness:20.0.0
Telefono, Tablet, Auto, Android Go, ChromeOS
classi di utilità
com.google.android.gms:play-services-base:18.10.1
Telefono, Tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Testare i modelli fittizi per le classi di utilità
com.google.android.gms:play-services-base-testing:16.2.0
Smartphone, tablet, Android TV, auto, Android Go, ChromeOS, Wear OS
Altre classi di utilità
com.google.android.gms:play-services-basement:18.11.0
Telefono, Tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Miglioramento in condizioni di scarsa illuminazione della fotocamera
com.google.android.gms:play-services-camera-low-light-boost:16.0.1-beta09
Telefono, tablet
Google Cast
com.google.android.gms:play-services-cast:22.3.1
Telefono, tablet, Android Go, ChromeOS
Google Cast Application Framework (CAF)
com.google.android.gms:play-services-cast-framework:22.3.1
Telefono, tablet, Android Go, ChromeOS
Scanner di codici 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.1.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-beta02
Telefono, tablet, Android Go
Key Verifier SDK
com.google.android.gms:contactkeys:16.0.0
Telefono, tablet
Autenticazione Fast IDentity Online (FIDO)
com.google.android.gms:play-services-fido:21.3.0
Telefono, Tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS

Compatibile con dispositivi che eseguono Android 7.0 (livello API 24) o versioni successive.
API Google Fit per Android EAPI di registrazione su dispositivi mobili (per i dati sul fitness dell'utente)
com.google.android.gms:play-services-fitness:21.3.0
Smartphone, tablet, Android Go, ChromeOS, Wear OS
Fraud Protect
com.google.android.gms:play-services-fraudprotect:16.0.1
Telefono, tablet, Android Go
Google Play Games Services v2 per Android
com.google.android.gms:play-services-games-v2:22.1.0
Smartphone, tablet, Android TV, Android Go, ChromeOS
Google Play Games Services v2 SDK nativo C per Android
com.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1
Telefono, tablet, Android TV, Android Go, ChromeOS
Google Play Game Services v1 per Android
com.google.android.gms:play-services-games:25.0.0
Deprecato. Utilizza Google Play Games Services v2.
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.2.0
Deprecato. Per ulteriori informazioni, consulta Google Play Instant.
Servizi di localizzazione per Android
com.google.android.gms:play-services-location:21.4.0
Telefono, Tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
SDK di Google Maps per Android
com.google.android.gms:play-services-maps:20.0.0
Telefono, Tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
SDK 3D di Google Maps per Android
com.google.android.gms:play-services-maps3d:0.2.2
Telefono, tablet
Miglioramento degli effetti multimediali
com.google.android.gms:play-services-media-effect-enhancement:16.0.0-beta08
Telefono, tablet
Scansione del codice a barre di ML Kit
com.google.android.gms:play-services-mlkit-barcode-scanning:18.3.1
Telefono, tablet, Android Go, ChromeOS
Scanner per documenti ML Kit
com.google.android.gms:play-services-mlkit-document-scanner:16.0.0
Telefono, tablet, Android Go, ChromeOS
Rilevamento del volto tramite ML Kit
com.google.android.gms:play-services-mlkit-face-detection:17.1.0
Telefono, tablet, Android Go, ChromeOS
Etichettatura delle immagini con ML Kit
com.google.android.gms:play-services-mlkit-image-labeling:16.0.8
Telefono, tablet, Android Go, ChromeOS
Etichettatura personalizzata delle immagini con ML Kit
com.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta5
Telefono, tablet, Android Go, ChromeOS
Identificazione della lingua di ML Kit
com.google.android.gms:play-services-mlkit-language-id:17.0.0
Telefono, tablet, Android Go, ChromeOS
Risposta intelligente del kit ML
com.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1
Telefono, tablet, Android Go, ChromeOS
Segmentazione dei soggetti del kit ML
com.google.android.gms:play-services-mlkit-subject-segmentation:16.0.0-beta1
Telefono, tablet, Android Go, ChromeOS
Riconoscimento del testo ML Kit
com.google.android.gms:play-services-mlkit-text-recognition:19.0.1
Telefono, tablet, Android Go, ChromeOS
Riconoscimento del testo ML Kit per il cinese
com.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.1
Telefono, tablet, Android Go, ChromeOS
Riconoscimento del testo Devanagari con ML Kit
com.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.1
Telefono, tablet, Android Go, ChromeOS
Riconoscimento del testo ML Kit per il giapponese
com.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.1
Telefono, tablet, Android Go, ChromeOS
Riconoscimento del testo ML Kit per il coreano
com.google.android.gms:play-services-mlkit-text-recognition-korean:16.0.1
Telefono, tablet, Android Go, ChromeOS
Rilevamento e connessione di dispositivi nelle vicinanze
com.google.android.gms:play-services-nearby:19.5.0
Telefono, Tablet, Android TV, Auto, Android Go
Mostra le licenze open source
com.google.android.gms:play-services-oss-licenses:17.5.2
Telefono, Tablet, Android TV, Auto, Android Go, ChromeOS
Compatibile con dispositivi che eseguono Android 5.0 (livello API 21) o versioni successive.
Biblioteche ad accesso programmatico (PAL)
com.google.android.gms:play-services-pal:23.0.0
Telefono, tablet, Android TV
Compatibile con dispositivi che eseguono Android 5.0 (livello API 21) o versioni successive.
Controllo qualità del blocco schermo
com.google.android.gms:play-services-password-complexity:18.1.0
Telefono, Tablet, Android Go, ChromeOS, Wear OS

Compatibile con dispositivi che eseguono Android dalla versione 4.4 (livello API 19) alla 9 (livello API 28).
Google Wallet (precedentemente Google Pay per i Pass)
com.google.android.gms:play-services-pay:16.5.0
Telefono, tablet, Android Go, ChromeOS

Compatibile con dispositivi che eseguono Android 5.0 (livello API 20) o versioni successive.
reCAPTCHA Enterprise per l'instrumentazione delle app
com.google.android.gms:play-services-recaptcha:17.1.0
Smartphone, tablet, Android TV, Android Go, ChromeOS
API dei gesti remoti
com.google.android.gms:play-services-remotegestures:16.0.0
Telefono, tablet
Navigazione sicura v5
com.google.android.gms:play-services-safebrowsing:16.0.0
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS
API SafetyNet (incluse navigazione sicura e verifica delle app)
com.google.android.gms:play-services-safetynet:18.1.0
Telefono, Tablet, Android TV, Auto, Android Go, ChromeOS
Google Tag Manager
com.google.android.gms:play-services-tagmanager:18.3.0
Smartphone, tablet, Android TV, Android Go, ChromeOS
API Tasks su Android
com.google.android.gms:play-services-tasks:18.4.1
Telefono, Tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Servizio di accelerazione per Android
com.google.android.gms:play-services-tflite-acceleration-service:16.5.0-beta02
Telefono, tablet, Android Go, ChromeOS
API TensorFlow Lite GPU Delegate per i servizi Google Play
com.google.android.gms:play-services-tflite-gpu:16.5.0
Telefono, tablet, Android Go, ChromeOS
API Java TensorFlow Lite per i servizi Google Play
com.google.android.gms:play-services-tflite-java:16.5.0
Telefono, tablet, Android Go, ChromeOS
API di supporto per TensorFlow Lite per i servizi Google Play
com.google.android.gms:play-services-tflite-support:16.5.0
Telefono, tablet, Android Go, ChromeOS
API di rete Thread
com.google.android.gms:play-services-threadnetwork:16.3.0
Telefono, tablet
API Trusted Time
com.google.android.gms:play-services-time:16.0.1
Telefono, Tablet, Auto, Android Go, Wear OS
Visione mobile
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:20.0.0
Telefono, Tablet, Auto, Android Go, ChromeOS, Wear OS
API Wearable Data Layer
com.google.android.gms:play-services-wearable:20.0.1
Telefono, tablet, Wear OS

Plugin Gradle

I servizi Google Play includono anche diversi plugin Gradle, come mostrato nella tabella seguente. Si noti che i pulsanti che compaiono 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 plugin Gradle Dispositivi supportati
Mostra licenze open source
com.google.android.gms:oss-licenses-plugin:0.13.0
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