Questa pagina è stata tradotta dall'API Cloud Translation.

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 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:

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

Nota: i progetti Android Studio contengono un file build.gradle di primo livello e un file build.gradle per ogni modulo. Assicurati di modificare il file del modulo della tua app. Scopri di più sulla creazione del progetto con Gradle.
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.
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.2.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.2.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.2.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`	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