Per sviluppare un'app utilizzando le API di Google Play Services, segui le istruzioni in questa pagina per configurare il tuo progetto con gli SDK pertinenti, disponibili nel repository Google Maven.
Per testare la tua app quando utilizzi i servizi Google Play, devi utilizzare uno dei seguenti metodi:
- Un dispositivo Android compatibile con sistema operativo Android 7.0 (livello API 24) o superiore e con l'app Google Play Store installata.
- L'emulatore Android con un AVD che esegue la piattaforma API di Google basata su Android 7.0 (livello API 24) o superiore.
Dichiarare le dipendenze per i servizi Google Play
Per sviluppare funzionalità che dipendono dalle API di Google Play Services nella tua app, segui questi passaggi:
Apri il file
build.gradleall'interno della directory del modulo della tua app.Per ogni SDK richiesto dalla tua app, includi la dipendenza relativa a tale SDK. Questa pagina include una sezione che elenca le dipendenze comuni dei servizi Google Play per le app Android. Potresti anche voler aggiungere Firebase al tuo progetto.
Salva le modifiche e sincronizza il tuo progetto.
Il seguente frammento mostra un esempio di file build.gradle che utilizza la libreria location:
apply plugin: 'com.android.application'
...
dependencies {
implementation 'com.google.android.gms:play-services-location:21.4.0'
}
Periodicamente vengono rilasciate 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 alla versione più recente nelle dipendenze della tua app per usufruire di queste correzioni.
Verifica se Google Play Services è installato.
Come descritto nella Panoramica di Google Play Services, Google Play Services viene aggiornato automaticamente su Android 7.0 (livello API 24) e versioni successive tramite l'app Google Play Store. Tuttavia, i dispositivi senza Google Play Store non hanno Google Play Services installato. Se la tua app viene eseguita su dispositivi sprovvisti di Google Play Services, dovresti sempre verificare se Google Play Services è installato prima di tentare di utilizzare le API di Google o di abilitare funzionalità che li richiedono.
Per verificare la presenza di Google Play Services sul dispositivo, utilizzare il metodo isGooglePlayServicesAvailable().
Per avviare una connessione a Google Play Services o per scoprire come rilevare se la versione di Google Play Services installata supporta una specifica API, consulta la guida Accesso alle API di Google.
Dipendenze di Google Play Services
La tabella seguente elenca le dipendenze di 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 specifico o il nome di una dipendenza inserendo del testo nella casella che appare dopo i pulsanti.
| Nome del caso d'uso e della dipendenza | Dispositivi supportati |
|---|---|
Google Mobile Adscom.google.android.gms:play-services-ads:25.4.0 |
Telefono, tablet |
ID pubblicità di Android (AAID)com.google.android.gms:play-services-ads-identifier:18.3.0 |
Telefono, tablet, Android TV, ChromeOS |
Versione leggera di Google Mobile Adscom.google.android.gms:play-services-ads-lite:25.0.0 |
Smartphone, tablet |
AdSense per la ricerca (AFS) annunci della rete di ricerca personalizzata (CSA)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 |
Deprecato. Utilizza Google Analytics per Firebase invece. |
Indice delle appcom.google.android.gms:play-services-appindex:16.2.0 |
Telefono, 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 |
Telefono, tablet, Android TV, ChromeOS |
Accedi con Google per Androidcom.google.android.gms:play-services-auth:22.0.0 |
Telefono, Tablet, Android TV, Auto, Android Go, ChromeOS |
API SMS Retrievercom.google.android.gms:play-services-auth-api-phone:18.3.1 |
Telefono, tablet, Android Go |
API Block Store (include l'archivio credenziali utente)com.google.android.gms:play-services-auth-blockstore:16.4.0 |
Telefono, tablet, Android Go, ChromeOS |
API di Google Awarenesscom.google.android.gms:play-services-awareness:20.0.0 |
Telefono, Tablet, Auto, Android Go, ChromeOS |
classi di utilitàcom.google.android.gms:play-services-base:18.10.1 |
Telefono, Tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Testare i modelli fittizi per le classi di utilitàcom.google.android.gms:play-services-base-testing:16.2.0 |
Smartphone, tablet, Android TV, auto, Android Go, ChromeOS, Wear OS |
Altre classi di utilitàcom.google.android.gms:play-services-basement:18.11.0 |
Telefono, Tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Miglioramento in condizioni di scarsa illuminazione della fotocameracom.google.android.gms:play-services-camera-low-light-boost:16.0.1-beta09 |
Telefono, tablet |
Google Castcom.google.android.gms:play-services-cast:22.3.1 |
Telefono, tablet, Android Go, ChromeOS |
Google Cast Application Framework (CAF)com.google.android.gms:play-services-cast-framework:22.3.1 |
Telefono, tablet, Android Go, ChromeOS |
Scanner di codici Googlecom.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.1 |
Telefono, Tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Interazioni dispositivo-dispositivo (DTDI)com.google.android.gms:play-services-dtdi:16.0.0-beta02 |
Telefono, tablet, Android Go |
Key Verifier SDKcom.google.android.gms:contactkeys:16.0.0 |
Telefono, tablet |
Autenticazione Fast IDentity Online (FIDO)com.google.android.gms:play-services-fido:21.3.0 |
Telefono, Tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS Compatibile con dispositivi che eseguono Android 7.0 (livello API 24) o versioni successive. |
API Google Fit per Android EAPI di registrazione su dispositivi mobili (per i dati sul fitness dell'utente)com.google.android.gms:play-services-fitness:21.3.0 |
Smartphone, tablet, Android Go, ChromeOS, Wear OS |
Fraud Protectcom.google.android.gms:play-services-fraudprotect:16.0.1 |
Telefono, tablet, Android Go |
Google Play Games Services v2 per Androidcom.google.android.gms:play-services-games-v2:22.1.0 |
Smartphone, tablet, Android TV, Android Go, ChromeOS |
Google Play Games Services v2 SDK nativo C per Androidcom.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1 |
Telefono, tablet, Android TV, Android Go, ChromeOS |
Google Play Game Services v1 per Androidcom.google.android.gms:play-services-games:25.0.0 |
Deprecato. Utilizza Google Play Games Services v2. |
API Mattercom.google.android.gms:play-services-home:16.0.0 |
Smartphone, tablet |
Google Play Instantcom.google.android.gms:play-services-instantapps:18.2.0 |
Deprecato. Per ulteriori informazioni, consulta Google Play Instant. |
Servizi di localizzazione per Androidcom.google.android.gms:play-services-location:21.4.0 |
Telefono, Tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
SDK di Google Maps per Androidcom.google.android.gms:play-services-maps:20.0.0 |
Telefono, Tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
SDK 3D di Google Maps per Androidcom.google.android.gms:play-services-maps3d:0.2.2 |
Telefono, tablet |
Miglioramento degli effetti multimedialicom.google.android.gms:play-services-media-effect-enhancement:16.0.0-beta08 |
Telefono, tablet |
Scansione del codice a barre di ML Kitcom.google.android.gms:play-services-mlkit-barcode-scanning:18.3.1 |
Telefono, tablet, Android Go, ChromeOS |
Scanner per documenti ML Kitcom.google.android.gms:play-services-mlkit-document-scanner:16.0.0 |
Telefono, tablet, Android Go, ChromeOS |
Rilevamento del volto tramite ML Kitcom.google.android.gms:play-services-mlkit-face-detection:17.1.0 |
Telefono, tablet, Android Go, ChromeOS |
Etichettatura delle immagini con ML Kitcom.google.android.gms:play-services-mlkit-image-labeling:16.0.8 |
Telefono, tablet, Android Go, ChromeOS |
Etichettatura personalizzata delle immagini con ML Kitcom.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta5 |
Telefono, tablet, Android Go, ChromeOS |
Identificazione della lingua di ML Kitcom.google.android.gms:play-services-mlkit-language-id:17.0.0 |
Telefono, tablet, Android Go, ChromeOS |
Risposta intelligente del kit MLcom.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1 |
Telefono, tablet, Android Go, ChromeOS |
Segmentazione dei soggetti del kit MLcom.google.android.gms:play-services-mlkit-subject-segmentation:16.0.0-beta1 |
Telefono, tablet, Android Go, ChromeOS |
Riconoscimento del testo ML Kitcom.google.android.gms:play-services-mlkit-text-recognition:19.0.1 |
Telefono, tablet, Android Go, ChromeOS |
Riconoscimento del testo ML Kit per il cinesecom.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.1 |
Telefono, tablet, Android Go, ChromeOS |
Riconoscimento del testo Devanagari con ML Kitcom.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.1 |
Telefono, tablet, Android Go, ChromeOS |
Riconoscimento del testo ML Kit per il giapponesecom.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.1 |
Telefono, tablet, Android Go, ChromeOS |
Riconoscimento del testo ML Kit per il coreanocom.google.android.gms:play-services-mlkit-text-recognition-korean:16.0.1 |
Telefono, tablet, Android Go, ChromeOS |
Rilevamento e connessione di dispositivi nelle vicinanzecom.google.android.gms:play-services-nearby:19.5.0 |
Telefono, Tablet, Android TV, Auto, Android Go |
Mostra le licenze open sourcecom.google.android.gms:play-services-oss-licenses:17.5.2 |
Telefono, Tablet, Android TV, Auto, Android Go, ChromeOS Compatibile con dispositivi che eseguono Android 5.0 (livello API 21) o versioni successive. |
Biblioteche ad accesso programmatico (PAL)com.google.android.gms:play-services-pal:23.0.0 |
Telefono, tablet, Android TV Compatibile con dispositivi che eseguono 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 |
Telefono, Tablet, Android Go, ChromeOS, Wear OS Compatibile con dispositivi che eseguono Android dalla versione 4.4 (livello API 19) alla 9 (livello API 28). |
Google Wallet (precedentemente Google Pay per i Pass)com.google.android.gms:play-services-pay:16.5.0 |
Telefono, tablet, Android Go, ChromeOS Compatibile con dispositivi che eseguono 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 dei gesti remoticom.google.android.gms:play-services-remotegestures:16.0.0 |
Telefono, tablet |
Navigazione sicura v5com.google.android.gms:play-services-safebrowsing:16.0.0 |
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS |
API SafetyNet (incluse navigazione sicura e verifica delle app)com.google.android.gms:play-services-safetynet:18.1.0 |
Telefono, Tablet, Android TV, Auto, Android Go, ChromeOS |
Google Tag Managercom.google.android.gms:play-services-tagmanager:18.3.0 |
Smartphone, tablet, Android TV, Android Go, ChromeOS |
API Tasks su Androidcom.google.android.gms:play-services-tasks:18.4.1 |
Telefono, Tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Servizio di accelerazione per Androidcom.google.android.gms:play-services-tflite-acceleration-service:16.5.0-beta02 |
Telefono, tablet, Android Go, ChromeOS |
API TensorFlow Lite GPU Delegate per i servizi Google Playcom.google.android.gms:play-services-tflite-gpu:16.5.0 |
Telefono, tablet, Android Go, ChromeOS |
API Java TensorFlow Lite per i servizi Google Playcom.google.android.gms:play-services-tflite-java:16.5.0 |
Telefono, tablet, Android Go, ChromeOS |
API di supporto per TensorFlow Lite per i servizi Google Playcom.google.android.gms:play-services-tflite-support:16.5.0 |
Telefono, tablet, Android Go, ChromeOS |
API di rete Threadcom.google.android.gms:play-services-threadnetwork:16.3.0 |
Telefono, tablet |
API Trusted Timecom.google.android.gms:play-services-time:16.0.1 |
Telefono, Tablet, Auto, Android Go, Wear OS |
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:20.0.0 |
Telefono, Tablet, Auto, Android Go, ChromeOS, Wear OS |
API Wearable Data Layercom.google.android.gms:play-services-wearable:20.0.1 |
Telefono, tablet, Wear OS |
Plugin Gradle
I servizi Google Play includono anche diversi plugin Gradle, come mostrato nella tabella seguente. Si noti che i pulsanti che compaiono prima della tabella precedente non modificano le informazioni visualizzate in questa tabella.
| Caso d'uso e nome del plugin Gradle | Dispositivi supportati |
|---|---|
Mostra licenze open sourcecom.google.android.gms:oss-licenses-plugin:0.13.0 |
Smartphone, 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 |