Configurare Google Play Services

Sviluppare un'app utilizzando Google Play Services API, segui le istruzioni in questa pagina per impostare il tuo progetto con gli SDK pertinenti, disponibili Repository di Google Maven.

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

  • Un dispositivo Android compatibile con sistema operativo Android 6.0 (API livello 23) o superiore e che disponga dell'app Google Play Store installato.
  • L'emulatore Android con Durata di visualizzazione media che esegue le API di Google basata su Android 6.0 (livello API 23) o versioni successive.

Dichiara le dipendenze per Google Play Services

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

  1. Apri il file build.gradle nella directory del modulo dell'app.

  2. Per ogni SDK richiesto dalla tua app, includi la dipendenza per quell'SDK. Questa pagina include una sezione che elenca Google Play Services delle dipendenze per le app per Android. Potresti anche voler aggiungere le dipendenze di Firebase progetto.

  3. Salva le modifiche e sincronizza progetto.

Lo snippet seguente mostra un file build.gradle di esempio che utilizza la proprietà libreria delle località:

apply plugin: 'com.android.application'

...

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

Nuove versioni degli SDK Google Play Services con correzioni di bug e nuove funzionalità vengono rilasciate periodicamente. Questi aggiornamenti sono annunciati nella note. Se la tua app utilizza una dipendenza che è stata aggiornato, passa alla versione più recente nelle dipendenze dell'app per e potrai 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 Sul Google Store non è installato Google Play Services. Se l'app viene eseguita su dispositivi senza Google Play Services, potresti verificare se Google Play servizi sia installato sul dispositivo prima di tentare di utilizzare le API di Google oppure attivare funzionalità nella tua app che richiedono Google Play Services per il funzionamento.

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

Per avviare una connessione a Google Play Services o scoprire come rilevare se la versione di Google Play Services installata supporta un'API specifica, leggi 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 per tipo di dispositivo selezionando uno dei pulsanti e puoi cercare un caso d'uso o una dipendenza inserendo il testo nella casella visualizzata dopo i pulsanti.

Tabella 1. Dipendenze di Google Play Services da includere App per Android
Caso d'uso e nome della dipendenza Dispositivi supportati
Annunci per dispositivi mobili di Google
com.google.android.gms:play-services-ads:23.2.0
Smartphone, tablet
ID pubblicità per Android (AAID)
com.google.android.gms:play-services-ads-identifier:18.1.0
Smartphone, tablet, Android TV, ChromeOS
Versione leggera degli annunci per dispositivi mobili di Google
com.google.android.gms:play-services-ads-lite:23.2.0
Smartphone, tablet
Annunci personalizzati 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.0
Obsoleta. Utilizza Google Analytics per Firebase.
Indice delle 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.0
Smartphone, tablet, Android TV
ID set di app per 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.2.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 l'archiviazione delle credenziali dell'utente)
com.google.android.gms:play-services-auth-blockstore:16.3.1
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 utenza
com.google.android.gms:play-services-base:18.5.0
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Testare 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 utenze
com.google.android.gms:play-services-basement:18.4.0
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Google Cast
com.google.android.gms:play-services-cast:21.5.0
Smartphone, tablet, Android Go, ChromeOS
Google Cast Application Framework (CAF)
com.google.android.gms:play-services-cast-framework:21.5.0
Smartphone, tablet, Android Go, ChromeOS
Ricevitori Android TV
com.google.android.gms:play-services-cast-tv:21.1.0
Android TV
Scanner di codici di 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.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-beta01
Smartphone, tablet, Android Go
Autenticazione FIDO (Fast Identity Online)
com.google.android.gms:play-services-fido:21.1.0
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS

Funzionalità supportata sui dispositivi con Android 7.0 (livello API 24) o versioni successive.
API Google Fit per Android e API di registrazione su dispositivi mobili (per i dati relativi all'attività fisica dell'utente)
com.google.android.gms:play-services-fitness:21.2.0
Smartphone, tablet, Android Go, ChromeOS, Wear OS
Servizi per i giochi di Google Play v2 per Android
com.google.android.gms:play-services-games-v2:20.1.2
Smartphone, tablet, Android TV, Android Go, ChromeOS
SDK C nativo dei servizi per i giochi di Google Play v2 per Android
com.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1
Smartphone, tablet, Android TV, Android Go, ChromeOS
Servizi per i giochi di Google Play 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

Funzionalità supportata sui dispositivi con Android 5.0 (livello API 21) o versioni successive.
Servizi di geolocalizzazione 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 codici a barre ML Kit
com.google.android.gms:play-services-mlkit-barcode-scanning:18.3.0
Smartphone, tablet, Android Go, ChromeOS
Scanner di documenti del kit ML
com.google.android.gms:play-services-mlkit-document-scanner:16.0.0-beta1
Smartphone, tablet, Android Go, ChromeOS
Rilevamento dei volti del kit ML
com.google.android.gms:play-services-mlkit-face-detection:17.1.0
Smartphone, tablet, Android Go, ChromeOS
Etichettatura delle immagini del kit ML
com.google.android.gms:play-services-mlkit-image-labeling:16.0.8
Smartphone, tablet, Android Go, ChromeOS
Etichettatura delle immagini personalizzata del kit ML
com.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta5
Smartphone, tablet, Android Go, ChromeOS
Identificazione del linguaggio del kit ML
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 dei soggetti del kit ML
com.google.android.gms:play-services-mlkit-subject-segmentation:16.0.0-beta1
Smartphone, tablet, Android Go, ChromeOS
Riconoscimento del testo del kit ML
com.google.android.gms:play-services-mlkit-text-recognition:19.0.0
Smartphone, 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
Smartphone, 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
Smartphone, 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
Smartphone, 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
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 licenze open source
com.google.android.gms:play-services-oss-licenses:17.1.0
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS
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

Funzionalità supportata sui dispositivi con versioni da Android da 4.4 (livello API 19) ad Android 9 (livello API 28).
Google Wallet (in precedenza Google Pay for Passes)
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 la strumentazione delle app
com.google.android.gms:play-services-recaptcha:17.1.0
Smartphone, tablet, Android TV, Android Go, ChromeOS
API SafetyNet (incluse l'attestazione dei dispositivi, Navigazione sicura, reCAPTCHA e verifica delle 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.0
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
Servizio di accelerazione per Android
com.google.android.gms:play-services-tflite-acceleration-service:16.0.0-beta01
Smartphone, tablet, Android Go, ChromeOS
API GPU TensorFlow Lite per Google Play Services
com.google.android.gms:play-services-tflite-gpu:16.2.0
Smartphone, tablet, Android Go, ChromeOS
API Java TensorFlow per Google Play Services
com.google.android.gms:play-services-tflite-java:16.2.0-beta02
Smartphone, tablet, Android Go, ChromeOS
API di assistenza TensorFlow Lite per Google Play Services
com.google.android.gms:play-services-tflite-support:16.1.0
Smartphone, tablet, Android Go, ChromeOS
API Thread Network
com.google.android.gms:play-services-threadnetwork:16.0.1
Smartphone, tablet
Visione artificiale per i dispositivi mobili
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:18.2.0
Smartphone, tablet, Wear OS

Plug-in Gradle

Google Play Services include anche diversi plug-in per Gradle, come mostrato in seguente. Tieni presente che i pulsanti visualizzati prima della tabella precedente non modificare le informazioni visualizzate in questa tabella.

Tabella 2. Elenco dei plug-in Gradle inclusi in Google Play servizi
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
Smartphone, tablet, ChromeOS
Controllo rigoroso della versione
com.google.android.gms:strict-version-matcher-plugin:1.2.4
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS