Configurare Google Play Services

Stay organized with collections Save and categorize content based on your preferences.

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 maven di Google.

Per testare la tua app quando utilizzi Google Play Services, devi usare una delle seguenti opzioni:

  • 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 una funzionalità AVD che esegue la piattaforma API di Google basata su Android 4.4 (livello API 19) o versioni successive.

Dichiarare le dipendenze per Google Play Services

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

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

  2. Includi la dipendenza per ogni SDK richiesto dalla tua app. Questa pagina include una sezione che elenca le dipendenze comuni di Google Play Services per le app 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 di località:

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 che è stata aggiornata, passa alla versione più recente nelle dipendenze dell'app per utilizzare 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 viene eseguita su dispositivi senza Google Play Services, ti consigliamo di verificare se Google Play Services è installato sul dispositivo prima di tentare di utilizzare le API di Google oppure di attivare le funzionalità della tua app che richiedono il funzionamento di Google Play Services.

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

Per iniziare a stabilire 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 Accesso alle API di Google.

Dipendenze Google Play Services

La tabella riportata di seguito elenca le dipendenze per Google Play Services che puoi includere nell'app Android. Puoi filtrare l'elenco per tipo di dispositivo selezionando uno dei pulsanti e puoi 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:21.5.0
Telefono, tablet
ID pubblicità 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:21.5.0
Telefono, tablet
Annunci AdSense per la ricerca (AFS) Custom Search Ads (CSA)
com.google.android.gms:play-services-afs-native:19.0.3
Telefono, tablet, Chrome OS
SDK Google Analytics Services per Android
com.google.android.gms:play-services-analytics:18.0.2
Deprecato. 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.4.1
Telefono, tablet, Android TV, Auto, Android Go, Chrome OS
API SMS Fetcher
com.google.android.gms:play-services-auth-api-phone:18.0.1
Telefono, tablet, Android Go
API Store Store (include l'archiviazione delle credenziali utente)
com.google.android.gms:play-services-auth-blockstore:16.1.0
Telefono, tablet, Android Go, Chrome OS
API Google Awareness
com.google.android.gms:play-services-awareness:19.0.1
Telefono, tablet, auto, Android Go, Chrome OS
Classi di utilità
com.google.android.gms:play-services-base:18.1.0
Telefono, tablet, Android TV, Auto, Android Go, Chrome OS, 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, Chrome OS, Wear OS
Altre classi di utilità
com.google.android.gms:play-services-basement:18.1.0
Telefono, tablet, Android TV, Auto, Android Go, Chrome OS, Wear OS
Google Cast
com.google.android.gms:play-services-cast:21.2.0
Telefono, tablet, Android Go, Chrome OS
Framework delle applicazioni di Google Cast (CAF)
com.google.android.gms:play-services-cast-framework:21.2.0
Telefono, tablet, Android Go, Chrome OS
Ricevitori Android TV
com.google.android.gms:play-services-cast-tv:20.0.0
Android TV
Scanner di codici Google
com.google.android.gms:play-services-code-scanner:16.0.0-beta3
Telefono, tablet, Android Go, Chrome OS
Stack di rete Chromium (Cront)
com.google.android.gms:play-services-cronet:18.0.1
Telefono, tablet, Android TV, Auto, Android Go, Chrome OS, Wear OS
Interazioni tra dispositivi (DTDI)
com.google.android.gms:play-services-dtdi:16.0.0-beta01
Telefono, tablet, Android Go
Autenticazione Fast IDentity Online (FIDO)
com.google.android.gms:play-services-fido:19.0.1
Telefono, tablet, Android TV, Auto, Android Go, Chrome OS, Wear OS

Supportato su 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, Chrome OS, 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, Chrome OS
SDK Google Play Games Services v2 nativo per Android
com.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1
Telefono, tablet, Android TV, Android Go, Chrome OS
Servizi Google Play Giochi v1 per Android
com.google.android.gms:play-services-games:23.1.0
Telefono, tablet, Android TV, Android Go, Chrome OS
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, Chrome OS

Supportato su dispositivi con Android 5.0 (livello API 21) o versioni successive.
Fused Location Provider per Android (include riconoscimento delle attività e geofencing)
com.google.android.gms:play-services-location:21.0.1
Telefono, tablet, Android TV, Auto, Android Go, Chrome OS, Wear OS
SDK Google Maps per Android
com.google.android.gms:play-services-maps:18.1.0
Telefono, tablet, Android TV, Auto, Android Go, Chrome OS, Wear OS
Scansione codice a barre ML Kit
com.google.android.gms:play-services-mlkit-barcode-scanning:18.1.0
Telefono, tablet, Android Go, Chrome OS
Rilevamento dei volti con ML Kit
com.google.android.gms:play-services-mlkit-face-detection:17.1.0
Telefono, tablet, Android Go, Chrome OS
Etichettatura delle immagini di ML Kit
com.google.android.gms:play-services-mlkit-image-labeling:16.0.8
Telefono, tablet, Android Go, Chrome OS
Etichettatura dell'immagine del kit ML personalizzata
com.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta4
Telefono, tablet, Android Go, Chrome OS
Identificazione della lingua di ML Kit
com.google.android.gms:play-services-mlkit-language-id:17.0.0
Telefono, tablet, Android Go, Chrome OS
Risposta rapida di ML Kit
com.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1
Telefono, tablet, Android Go, Chrome OS
Riconoscimento del testo del ML Kit
com.google.android.gms:play-services-mlkit-text-recognition:18.0.2
Telefono, tablet, Android Go, Chrome OS
Rilevamento e connessione di dispositivi nelle vicinanze
com.google.android.gms:play-services-nearby:18.4.0
Telefono, tablet, Android TV, auto, Android Go
Mostra licenze open source
com.google.android.gms:play-services-oss-licenses:17.0.0
Telefono, tablet, Android TV, Auto, Android Go, Chrome OS
Supportato 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, Chrome OS, Wear OS

Supportato su dispositivi con 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, Chrome OS

Supportato su 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, Chrome OS
API SafetyNet (include attestazione del dispositivo, Navigazione sicura, reCAPTCHA e verifica dell'app)
com.google.android.gms:play-services-safetynet:18.0.1
Telefono, tablet, Android TV, Auto, Android Go, Chrome OS
Google Tag Manager
com.google.android.gms:play-services-tagmanager:18.0.2
Telefono, tablet, Android TV, Android Go, Chrome OS
API Tasks su Android
com.google.android.gms:play-services-tasks:18.0.2
Telefono, tablet, Android TV, Auto, Android Go, Chrome OS, Wear OS
API TensorFlow Lite GPU Delegato per Google Play Services
com.google.android.gms:play-services-tflite-gpu:16.1.0
Telefono, tablet, Android Go, Chrome OS
API TensorFlow Lite di Java per Google Play Services
com.google.android.gms:play-services-tflite-java:16.0.1
Telefono, tablet, Android Go, Chrome OS
API TensorFlow Lite Support per Google Play Services
com.google.android.gms:play-services-tflite-support:16.0.1
Telefono, tablet, Android Go, Chrome OS
API Thread Network
com.google.android.gms:play-services-threadnetwork:16.0.0-beta02
Telefono, tablet
Visione mobile
com.google.android.gms:play-services-vision:20.1.3
Telefono, tablet, Android Go, Chrome OS
Google Pay per i pagamenti su Android
com.google.android.gms:play-services-wallet:19.1.0
Telefono, tablet, auto, Android Go, Chrome OS, Wear OS
API Wear Data Layer
com.google.android.gms:play-services-wearable:18.0.0
Telefono, 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 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 plug-in Gradle Dispositivi supportati
Mostra licenze open source
com.google.android.gms:oss-licenses-plugin:0.10.6
Telefono, tablet, Chrome OS
Controllo rigoroso della versione
com.google.android.gms:strict-version-matcher-plugin:1.2.4
Telefono, tablet, Android TV, Auto, Android Go, Chrome OS, Wear OS