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, compila i seguenti passaggi:
Apri il file
build.gradlenella directory del modulo dell'app.Per ogni SDK richiesto dalla tua app, includi la dipendenza per quell'SDK. 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.
| Nome del caso d'uso e della dipendenza | Dispositivi supportati |
|---|---|
Google Mobile Adscom.google.android.gms:play-services-ads:23.5.0 |
Smartphone, tablet |
ID pubblicità di Android (AAID)com.google.android.gms:play-services-ads-identifier:18.1.0 |
Smartphone, tablet, Android TV, ChromeOS |
Versione leggera di Google Ads per il mobilecom.google.android.gms:play-services-ads-lite:23.5.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 Androidcom.google.android.gms:play-services-analytics:18.1.1 |
Ritiro. Utilizza invece Google Analytics per Firebase. |
Indice appcom.google.android.gms:play-services-appindex:16.2.0 |
Smartphone, tablet, Android TV |
AppSearchcom.google.android.gms:play-services-appsearch:16.0.1 |
Smartphone, tablet, Android TV |
ID set di app Androidcom.google.android.gms:play-services-appset:16.1.0 |
Smartphone, tablet, Android TV, ChromeOS |
Accedi con Google per Androidcom.google.android.gms:play-services-auth:21.2.0 |
Smartphone, tablet, Android TV, auto, Android Go, ChromeOS |
API SMS Retrievercom.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 Awarenesscom.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 Castcom.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 Googlecom.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) Authenticationcom.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 Androidcom.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 Androidcom.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 Androidcom.google.android.gms:play-services-games:23.2.0 |
Smartphone, tablet, Android TV, Android Go, ChromeOS |
API Mattercom.google.android.gms:play-services-home:16.0.0 |
Smartphone, tablet |
Google Play Instantcom.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 Androidcom.google.android.gms:play-services-location:21.3.0 |
Smartphone, tablet, Android TV, auto, Android Go, ChromeOS, Wear OS |
SDK Google Maps per Androidcom.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 Kitcom.google.android.gms:play-services-mlkit-barcode-scanning:18.3.1 |
Smartphone, tablet, Android Go, ChromeOS |
Scanner di documenti ML Kitcom.google.android.gms:play-services-mlkit-document-scanner:16.0.0-beta1 |
Smartphone, tablet, Android Go, ChromeOS |
Rilevamento dei volti di ML Kitcom.google.android.gms:play-services-mlkit-face-detection:17.1.0 |
Smartphone, tablet, Android Go, ChromeOS |
Etichettatura delle immagini di ML Kitcom.google.android.gms:play-services-mlkit-image-labeling:16.0.8 |
Smartphone, tablet, Android Go, ChromeOS |
Etichettatura delle immagini di ML Kit personalizzatacom.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta5 |
Smartphone, tablet, Android Go, ChromeOS |
Identificazione della lingua di ML Kitcom.google.android.gms:play-services-mlkit-language-id:17.0.0 |
Smartphone, tablet, Android Go, ChromeOS |
Risposta rapida di ML Kitcom.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1 |
Smartphone, tablet, Android Go, ChromeOS |
Segmentazione degli argomenti di ML Kitcom.google.android.gms:play-services-mlkit-subject-segmentation:16.0.0-beta1 |
Smartphone, tablet, Android Go, ChromeOS |
Riconoscimento del testo di ML Kitcom.google.android.gms:play-services-mlkit-text-recognition:19.0.1 |
Smartphone, tablet, Android Go, ChromeOS |
Riconoscimento del testo di ML Kit per il cinesecom.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 devanagaricom.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 giapponesecom.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 coreanocom.google.android.gms:play-services-mlkit-text-recognition-korean:16.0.1 |
Smartphone, tablet, Android Go, ChromeOS |
Rilevamento e connessione dei dispositivi nelle vicinanzecom.google.android.gms:play-services-nearby:19.3.0 |
Smartphone, tablet, Android TV, auto, Android Go |
Mostra le licenze open sourcecom.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 appcom.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 Managercom.google.android.gms:play-services-tagmanager:18.1.1 |
Smartphone, tablet, Android TV, Android Go, ChromeOS |
API Tasks su Androidcom.google.android.gms:play-services-tasks:18.2.0 |
Smartphone, tablet, Android TV, auto, Android Go, ChromeOS, Wear OS |
Acceleration Service per Androidcom.google.android.gms:play-services-tflite-acceleration-service:16.3.0-beta01 |
Smartphone, tablet, Android Go, ChromeOS |
API Delegate GPU di TensorFlow Lite per Google Play Servicescom.google.android.gms:play-services-tflite-gpu:16.3.0 |
Smartphone, tablet, Android Go, ChromeOS |
API Java di TensorFlow Lite per Google Play Servicescom.google.android.gms:play-services-tflite-java:16.3.0 |
Smartphone, tablet, Android Go, ChromeOS |
API di supporto di TensorFlow Lite per i servizi Google Playcom.google.android.gms:play-services-tflite-support:16.3.0 |
Smartphone, tablet, Android Go, ChromeOS |
API Thread Networkcom.google.android.gms:play-services-threadnetwork:16.2.1 |
Smartphone, tablet |
Visione mobilecom.google.android.gms:play-services-vision:20.1.3 |
Smartphone, tablet, Android Go, ChromeOS |
Google Pay per i pagamenti su Androidcom.google.android.gms:play-services-wallet:19.4.0 |
Smartphone, tablet, auto, Android Go, ChromeOS, Wear OS |
API Wearable Data Layercom.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.
| Caso d'uso e nome del plug-in Gradle | Dispositivi supportati |
|---|---|
Mostra le licenze open sourcecom.google.android.gms:oss-licenses-plugin:0.10.6 |
Smartphone, tablet, ChromeOS |
Controllo rigoroso delle versionicom.google.android.gms:strict-version-matcher-plugin:1.2.4 |
Smartphone, tablet, Android TV, auto, Android Go, ChromeOS, Wear OS |