Questa pagina è stata tradotta dall'API Cloud Translation.

Configurare Google Play Services

Per sviluppare un'app che utilizza le API di 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 utilizzare uno dei seguenti elementi:

Un dispositivo Android compatibile con Android 6.0 (livello API 23) o versioni successive e con l'app Google Play Store installata.
L'emulatore Android con un AVD che esegue la piattaforma API di Google basata su Android 6.0 (livello API 23) 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 seguenti passaggi:

Apri il file build.gradle nella 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 per il modulo della tua app. Scopri di più sulla costruzione del progetto con Gradle.
Per ogni SDK richiesto dalla tua app, includi la dipendenza relativa. Questa pagina include una sezione che elenca le dipendenze di Google Play Services comuni per le app per Android. Ti consigliamo inoltre di aggiungere le 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 Location:

apply plugin: 'com.android.application'

...

dependencies {
    implementation 'com.google.android.gms:play-services-location:21.3.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 aggiornata, passa alla versione più recente 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 6.0 (livello API 23) e versioni successive tramite l'app Google Play Store. Tuttavia, i dispositivi Android senza Google Play Store non hanno 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 o 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 una connessione a Google Play Services o scoprire come rilevare se la versione di Google Play Services installata supporta un'API specifica, consulta la guida sull'accesso alle API di Google.

Dipendenze di Google Play Services

La tabella seguente elenca le dipendenze per 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 o il nome di una dipendenza specifico inserendo del testo nella casella visualizzata 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:23.6.0`	Smartphone, tablet
ID pubblicità di Android (AAID) `com.google.android.gms:play-services-ads-identifier:18.2.0`	Smartphone, tablet, Android TV, ChromeOS
Versione leggera di Google Ads per il mobile `com.google.android.gms:play-services-ads-lite:23.6.0`	Smartphone, tablet
Annunci associati alla ricerca personalizzata (ASA) di AdSense per la ricerca (AFS) `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`	Ritiro. Utilizza Google Analytics per Firebase.
Indice app `com.google.android.gms:play-services-appindex:16.2.0`	Smartphone, 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`	Smartphone, tablet, Android TV, ChromeOS
Accedi con Google per Android `com.google.android.gms:play-services-auth:21.3.0`	Smartphone, tablet, Android TV, auto, Android Go, ChromeOS
API SMS Retriever `com.google.android.gms:play-services-auth-api-phone:18.1.0`	Smartphone, tablet, Android Go
API Block Store (include lo spazio di archiviazione delle credenziali utente) `com.google.android.gms:play-services-auth-blockstore:16.4.0`	Smartphone, tablet, Android Go, ChromeOS
API Google Awareness `com.google.android.gms:play-services-awareness:19.1.0`	Smartphone, tablet, auto, Android Go, ChromeOS
Classi di utilità `com.google.android.gms:play-services-base:18.5.0`	Smartphone, tablet, Android TV, auto, Android Go, ChromeOS, Wear OS
Test di falsi per le classi di utilità `com.google.android.gms:play-services-base-testing:16.1.0`	Smartphone, tablet, Android TV, auto, Android Go, ChromeOS, Wear OS
Altre classi di utilità `com.google.android.gms:play-services-basement:18.5.0`	Smartphone, tablet, Android TV, auto, Android Go, ChromeOS, Wear OS
Google Cast `com.google.android.gms:play-services-cast:22.0.0`	Smartphone, tablet, Android Go, ChromeOS
Google Cast Application Framework (CAF) `com.google.android.gms:play-services-cast-framework:22.0.0`	Smartphone, tablet, Android Go, ChromeOS
Scanner codici Google `com.google.android.gms:play-services-code-scanner:16.1.0`	Smartphone, tablet, Android Go, ChromeOS
Pila di rete di Chromium (Cronet) `com.google.android.gms:play-services-cronet:18.1.0`	Smartphone, tablet, Android TV, auto, Android Go, ChromeOS, Wear OS
Interazioni dispositivo-dispositivo (DTDI) `com.google.android.gms:play-services-dtdi:16.0.0-beta02`	Smartphone, tablet, Android Go
Fast IDentity Online (FIDO) Authentication `com.google.android.gms:play-services-fido:21.1.0`	Smartphone, 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 e API Registrazione su dispositivi mobili (per i dati sull'attività fisica dell'utente) `com.google.android.gms:play-services-fitness:21.2.0`	Smartphone, tablet, Android Go, ChromeOS, Wear OS
Google Play Services per giochi v2 per Android `com.google.android.gms:play-services-games-v2:20.1.2`	Smartphone, tablet, Android TV, Android Go, ChromeOS
SDK C nativo di Google Play Services per i giochi v2 per Android `com.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1`	Smartphone, tablet, Android TV, Android Go, ChromeOS
Google Play Services per giochi v1 per Android `com.google.android.gms:play-services-games:23.2.0`	Smartphone, 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.1.0`	Smartphone, tablet, Android TV, Android Go, ChromeOS Supportato su dispositivi con Android 5.0 (livello API 21) o versioni successive.
Localizzazione per Android `com.google.android.gms:play-services-location:21.3.0`	Smartphone, tablet, Android TV, auto, Android Go, ChromeOS, Wear OS
SDK Google Maps per Android `com.google.android.gms:play-services-maps:19.0.0`	Smartphone, tablet, Android TV, auto, Android Go, ChromeOS, Wear OS
Scansione di codici a barre con ML Kit `com.google.android.gms:play-services-mlkit-barcode-scanning:18.3.1`	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 di ML Kit `com.google.android.gms:play-services-mlkit-face-detection:17.1.0`	Smartphone, tablet, Android Go, ChromeOS
Etichettatura delle immagini di ML Kit `com.google.android.gms:play-services-mlkit-image-labeling:16.0.8`	Smartphone, tablet, Android Go, ChromeOS
Etichettatura delle immagini di ML Kit personalizzata `com.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta5`	Smartphone, tablet, Android Go, ChromeOS
Identificazione della lingua di ML Kit `com.google.android.gms:play-services-mlkit-language-id:17.0.0`	Smartphone, tablet, Android Go, ChromeOS
Risposta rapida di ML Kit `com.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1`	Smartphone, tablet, Android Go, ChromeOS
Segmentazione degli argomenti di ML Kit `com.google.android.gms:play-services-mlkit-subject-segmentation:16.0.0-beta1`	Smartphone, tablet, Android Go, ChromeOS
Riconoscimento del testo di ML Kit `com.google.android.gms:play-services-mlkit-text-recognition:19.0.1`	Smartphone, tablet, Android Go, ChromeOS
Riconoscimento del testo di ML Kit per il cinese `com.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.1`	Smartphone, tablet, Android Go, ChromeOS
Riconoscimento del testo di ML Kit per il devanagari `com.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.1`	Smartphone, tablet, Android Go, ChromeOS
Riconoscimento del testo di ML Kit per il giapponese `com.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.1`	Smartphone, tablet, Android Go, ChromeOS
Riconoscimento del testo di ML Kit per il coreano `com.google.android.gms:play-services-mlkit-text-recognition-korean:16.0.1`	Smartphone, tablet, Android Go, ChromeOS
Rilevamento e connessione dei dispositivi nelle vicinanze `com.google.android.gms:play-services-nearby:19.3.0`	Smartphone, tablet, Android TV, auto, Android Go
Mostra le licenze open source `com.google.android.gms:play-services-oss-licenses:17.1.0`	Smartphone, tablet, Android TV, auto, Android Go, ChromeOS Supportato su dispositivi con Android 5.0 (livello API 21) o versioni successive.
Librerie di accesso programmatico (PAL) `com.google.android.gms:play-services-pal:21.0.0`	Smartphone, tablet, Android TV 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.1.0`	Smartphone, tablet, Android Go, ChromeOS, Wear OS Supportato sui dispositivi con Android 4.4 (livello API 19) e versioni successive fino ad Android 9 (livello API 28).
Google Wallet (in precedenza Google Pay per tessere) `com.google.android.gms:play-services-pay:16.5.0`	Smartphone, tablet, Android Go, ChromeOS Supportato sui dispositivi con 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 SafetyNet (include attestazione del dispositivo, navigazione sicura, reCAPTCHA e verifica dell'app) `com.google.android.gms:play-services-safetynet:18.1.0`	Smartphone, tablet, Android TV, auto, Android Go, ChromeOS
Google Tag Manager `com.google.android.gms:play-services-tagmanager:18.1.1`	Smartphone, tablet, Android TV, Android Go, ChromeOS
API Tasks su Android `com.google.android.gms:play-services-tasks:18.2.0`	Smartphone, tablet, Android TV, auto, Android Go, ChromeOS, Wear OS
Acceleration Service per Android `com.google.android.gms:play-services-tflite-acceleration-service:16.4.0-beta01`	Smartphone, tablet, Android Go, ChromeOS
API Delegate GPU di TensorFlow Lite per Google Play Services `com.google.android.gms:play-services-tflite-gpu:16.4.0`	Smartphone, tablet, Android Go, ChromeOS
API Java di TensorFlow Lite per Google Play Services `com.google.android.gms:play-services-tflite-java:16.4.0`	Smartphone, tablet, Android Go, ChromeOS
API di supporto di TensorFlow Lite per i servizi Google Play `com.google.android.gms:play-services-tflite-support:16.4.0`	Smartphone, tablet, Android Go, ChromeOS
API Thread Network `com.google.android.gms:play-services-threadnetwork:16.2.1`	Smartphone, tablet
API Trusted Time `com.google.android.gms:play-services-time:16.0.0`	Smartphone, 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:19.4.0`	Smartphone, tablet, auto, Android Go, ChromeOS, Wear OS
API Wearable Data Layer `com.google.android.gms:play-services-wearable:19.0.0`	Smartphone, tablet, Wear OS

Plug-in Gradle

Google Play Services include anche diversi plug-in Gradle, come mostrato nella tabella seguente. 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 le licenze open source `com.google.android.gms:oss-licenses-plugin:0.10.6`	Smartphone, tablet, ChromeOS
Controllo rigoroso delle versioni `com.google.android.gms:strict-version-matcher-plugin:1.2.4`	Smartphone, tablet, Android TV, auto, Android Go, ChromeOS, Wear OS