Per sviluppare un'app utilizzando le API 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 la tua app quando utilizzi Google Play Services, devi usare uno dei seguenti:
- Un dispositivo Android compatibile con Android 5.0 (livello API 21) o versioni successive su cui è installata l'app Google Play Store.
- L'emulatore Android con un AVD che esegue la piattaforma API di Google basata su Android 5.0 (livello API 21) o versioni successive.
Dichiarare le dipendenze per Google Play Services
Per sviluppare funzionalità che dipendono dalle API di Google Play Services nella tua app, svolgi i passaggi che seguono:
Apri il file
build.gradle
nella directory del modulo dell'app.Per ogni SDK richiesto dalla tua app, includi la dipendenza per l'SDK in questione. Questa pagina include una sezione che elenca le dipendenze di Google Play Services comuni per le app per Android. Potresti anche aggiungere dipendenze Firebase al progetto.
Salva le modifiche e sincronizza il progetto.
Lo snippet seguente mostra un file build.gradle
di esempio che utilizza la libreria delle 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 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 all'ultima versione nelle dipendenze dell'app per sfruttare queste correzioni.
Controllare se Google Play Services è installato
Come descritto nella panoramica di Google Play Services, Google Play Services riceve aggiornamenti automatici su Android 5.0 (livello API 21) 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 o di attivare le funzionalità dell'app che richiedono il funzionamento di Google Play Services.
Per verificare la presenza di Google Play Services sul dispositivo, usa il metodo isGooglePlayServicesAvailable()
.
Per avviare una connessione a Google Play Services o per scoprire come capire se la versione dei servizi Google Play installata supporta un'API specifica, leggi la guida Accesso alle API di Google.
Dipendenze di Google Play Services
Nella tabella che segue sono elencate le dipendenze di Google Play Services che puoi includere nella tua app Android. Puoi filtrare l'elenco per tipo di dispositivo selezionando uno dei pulsanti e cercare un caso d'uso o un nome di dipendenza specifico inserendo il testo nella casella visualizzata dopo i pulsanti.
Caso d'uso e nome della dipendenza | Dispositivi supportati |
---|---|
Annunci per dispositivi mobili di Googlecom.google.android.gms:play-services-ads:22.6.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 Adscom.google.android.gms:play-services-ads-lite:22.6.0 |
Telefono, tablet |
Annunci personalizzati AdSense per la ricerca (AFS) della rete di ricerca (CSA)com.google.android.gms:play-services-afs-native:19.0.3 |
Telefono, tablet, ChromeOS |
SDK Google Analytics Services per Androidcom.google.android.gms:play-services-analytics:18.0.4 |
Obsoleta. Utilizza Google Analytics per Firebase. |
Indice di appcom.google.android.gms:play-services-appindex:16.1.0 |
Telefono, tablet, Android TV |
ID set di app per Androidcom.google.android.gms:play-services-appset:16.0.2 |
Telefono, tablet, Android TV, ChromeOS |
Accedi con Google per Androidcom.google.android.gms:play-services-auth:20.7.0 |
Telefono, tablet, Android TV, Auto, Android Go, ChromeOS |
API SMS Retrievercom.google.android.gms:play-services-auth-api-phone:18.0.1 |
Telefono, tablet, Android Go |
API Block Store (include l'archiviazione delle credenziali utente)com.google.android.gms:play-services-auth-blockstore:16.2.0 |
Telefono, tablet, Android Go, ChromeOS |
API Google Awarenesscom.google.android.gms:play-services-awareness:19.0.1 |
Telefono, tablet, auto, Android Go, ChromeOS |
Classi di utilitàcom.google.android.gms:play-services-base:18.2.0 |
Telefono, 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.0.0 |
Telefono, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Altre classi di utilitàcom.google.android.gms:play-services-basement:18.2.0 |
Telefono, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Google Castcom.google.android.gms:play-services-cast:21.4.0 |
Telefono, tablet, Android Go, ChromeOS |
CAF (Google Cast Application Framework)com.google.android.gms:play-services-cast-framework:21.4.0 |
Telefono, tablet, Android Go, ChromeOS |
Ricevitori Android TVcom.google.android.gms:play-services-cast-tv:21.0.1 |
Android TV |
Scanner di codice Googlecom.google.android.gms:play-services-code-scanner:16.1.0 |
Telefono, tablet, Android Go, ChromeOS |
Stack di rete Chromium (corona)com.google.android.gms:play-services-cronet:18.0.1 |
Telefono, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Interazioni tra dispositivo (DTDI)com.google.android.gms:play-services-dtdi:16.0.0-beta01 |
Telefono, tablet, Android Go |
Autenticazione FIDO (Fast IDentity Online)com.google.android.gms:play-services-fido:20.1.0 |
Telefono, 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 Androidcom.google.android.gms:play-services-fitness:21.1.0 |
Telefono, tablet, Android Go, ChromeOS, Wear OS |
Servizi per i giochi di Google Play v2 per Androidcom.google.android.gms:play-services-games-v2:19.0.0 |
Telefono, tablet, Android TV, Android Go, ChromeOS |
SDK nativo C nativo di Google Play Giochi Services v2 per Androidcom.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1 |
Telefono, tablet, Android TV, Android Go, ChromeOS |
Servizi per i giochi di Google Play v1 per Androidcom.google.android.gms:play-services-games:23.1.0 |
Telefono, tablet, Android TV, Android Go, ChromeOS |
API Mattercom.google.android.gms:play-services-home:16.0.0 |
Telefono, tablet |
Google Play Instantcom.google.android.gms:play-services-instantapps:18.0.1 |
Telefono, tablet, Android TV, Android Go, ChromeOS Supportato sui dispositivi con Android 5.0 (livello API 21) o versioni successive. |
Fused Location Provider per Android (include il riconoscimento delle attività e il geofencing)com.google.android.gms:play-services-location:21.0.1
| Telefono, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
SDK Google Maps per Androidcom.google.android.gms:play-services-maps:18.2.0 |
Telefono, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Scansione dei codici a barre di ML Kitcom.google.android.gms:play-services-mlkit-barcode-scanning:18.3.0 |
Telefono, tablet, Android Go, ChromeOS |
Rilevamento facciale del kit MLcom.google.android.gms:play-services-mlkit-face-detection:17.1.0 |
Telefono, tablet, Android Go, ChromeOS |
Etichettatura delle immagini di ML Kitcom.google.android.gms:play-services-mlkit-image-labeling:16.0.8 |
Telefono, tablet, Android Go, ChromeOS |
Etichettatura personalizzata di immagini di ML Kitcom.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta5 |
Telefono, tablet, Android Go, ChromeOS |
Identificazione del linguaggio del kit MLcom.google.android.gms:play-services-mlkit-language-id:17.0.0 |
Telefono, tablet, Android Go, ChromeOS |
Risposta rapida ML Kitcom.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1 |
Telefono, tablet, Android Go, ChromeOS |
Segmentazione dei soggetti di ML Kitcom.google.android.gms:play-services-mlkit-subject-segmentation:16.0.0-beta1 |
Telefono, tablet, Android Go, ChromeOS |
Riconoscimento del testo di ML Kitcom.google.android.gms:play-services-mlkit-text-recognition:19.0.0 |
Telefono, tablet, Android Go, ChromeOS |
Riconoscimento del testo di ML Kit per il cinesecom.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.0 |
Telefono, tablet, Android Go, ChromeOS |
Riconoscimento del testo di ML Kit per Devanagaricom.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.0 |
Telefono, tablet, Android Go, ChromeOS |
Riconoscimento del testo di ML Kit per il giapponesecom.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.0 |
Telefono, tablet, Android Go, ChromeOS |
Riconoscimento del testo di ML Kit per il coreanocom.google.android.gms:play-services-mlkit-text-recognition-korean:16.0.0 |
Telefono, tablet, Android Go, ChromeOS |
Rilevamento e connessione di dispositivi nelle vicinanzecom.google.android.gms:play-services-nearby:19.0.0 |
Telefono, tablet, Android TV, Auto, Android Go |
Mostra licenze open sourcecom.google.android.gms:play-services-oss-licenses:17.0.1 |
Telefono, 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.0.1 |
Telefono, tablet, Android Go, ChromeOS, Wear OS Supportato sui dispositivi con sistema operativo da Android 4.4 (livello API 19) ad Android 9 (livello API 28). |
Google Pay per i passcom.google.android.gms:play-services-pay:16.4.0 |
Telefono, tablet, Android Go, ChromeOS Supportato sui dispositivi con Android 5.0 (livello API 20) o versioni successive. |
reCAPTCHA Enterprise per la strumentazione delle appcom.google.android.gms:play-services-recaptcha:17.0.1 |
Telefono, tablet, Android TV, Android Go, ChromeOS |
API SafetyNet (include attestazione dei dispositivi, Navigazione sicura, reCAPTCHA e verifica delle app)com.google.android.gms:play-services-safetynet:18.0.1 |
Telefono, tablet, Android TV, Auto, Android Go, ChromeOS |
Google Tag Managercom.google.android.gms:play-services-tagmanager:18.0.4 |
Telefono, tablet, Android TV, Android Go, ChromeOS |
API Tasks su Androidcom.google.android.gms:play-services-tasks:18.0.2 |
Telefono, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Servizio di accelerazione per Androidcom.google.android.gms:play-services-tflite-acceleration-service:16.0.0-beta01 |
Telefono, tablet, Android Go, ChromeOS |
API GPU TensorFlow Lite GPU Delega per Google Play Servicescom.google.android.gms:play-services-tflite-gpu:16.2.0 |
Telefono, tablet, Android Go, ChromeOS |
API Java TensorFlow Lite per Google Play Servicescom.google.android.gms:play-services-tflite-java:16.1.0 |
Telefono, tablet, Android Go, ChromeOS |
API TensorFlow Lite Support per Google Play Servicescom.google.android.gms:play-services-tflite-support:16.1.0 |
Telefono, tablet, Android Go, ChromeOS |
API Thread Networkcom.google.android.gms:play-services-threadnetwork:16.0.0 |
Telefono, tablet |
Visione per dispositivi mobilicom.google.android.gms:play-services-vision:20.1.3 |
Telefono, tablet, Android Go, ChromeOS |
Google Pay per i pagamenti su Androidcom.google.android.gms:play-services-wallet:19.2.1 |
Telefono, tablet, automatico, Android Go, ChromeOS, Wear OS |
API Wearable Data Layercom.google.android.gms:play-services-wearable:18.1.0 |
Telefono, tablet, Wear OS |
Plug-in Gradle
Google Play Services include anche diversi plug-in Gradle, come mostrato nella tabella che segue. Tieni presente che i pulsanti visualizzati prima della tabella precedente non modificano le informazioni riportate in questa tabella.
Caso d'uso e nome del plug-in Gradle | Dispositivi supportati |
---|---|
Mostra licenze open sourcecom.google.android.gms:oss-licenses-plugin:0.10.6 |
Telefono, tablet, ChromeOS |
Controllo rigoroso della versionecom.google.android.gms:strict-version-matcher-plugin:1.2.4 |
Telefono, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |