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 utilizzare uno dei seguenti:
- Un dispositivo Android compatibile con Android 7.0 (livello API 24) 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 7.0 (livello API 24) 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:
Apri il file
build.gradlenella directory del modulo dell'app.Per ogni SDK richiesto dalla tua app, includi la relativa dipendenza. Questa pagina include una sezione che elenca le dipendenze di Google Play Services comuni per le app per Android. Potresti anche voler aggiungere Firebase al tuo progetto.
Salva le modifiche e sincronizza il progetto.
Il seguente snippet mostra un file build.gradle di esempio che utilizza la libreria di località:
apply plugin: 'com.android.application'
...
dependencies {
implementation 'com.google.android.gms:play-services-location:21.4.0'
}
Periodicamente vengono rilasciate nuove versioni degli SDK 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 che è stata aggiornata, passa all'ultima versione nelle dipendenze dell'app per usufruire di queste correzioni.
Controlla 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, sui dispositivi senza Google Play Store non è installato Google Play Services. Se la tua app viene eseguita su dispositivi senza Google Play Services, devi sempre verificare se Google Play Services è installato prima di provare a utilizzare le API di Google o attivare funzionalità che lo richiedono.
Per verificare la presenza di Google Play Services sul dispositivo, utilizza il metodo 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, consulta la guida su come accedere 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 un nome di dipendenza specifico inserendo il testo nella casella che appare dopo i pulsanti.
| Caso d'uso e nome della dipendenza | Dispositivi supportati |
|---|---|
Google Mobile Adscom.google.android.gms:play-services-ads:25.5.0 |
Smartphone, tablet |
ID pubblicità di Android (AAID)com.google.android.gms:play-services-ads-identifier:18.3.0 |
Smartphone, tablet, Android TV, ChromeOS |
Versione leggera di Google Mobile Adscom.google.android.gms:play-services-ads-lite:25.0.0 |
Smartphone, tablet |
Annunci della rete di ricerca personalizzata (CSA) 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 |
Deprecato. Utilizza invece Google Analytics for Firebase. |
Indicizzazione delle 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 per 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:22.0.0 |
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS |
API SMS Retrievercom.google.android.gms:play-services-auth-api-phone:18.3.1 |
Smartphone, tablet, Android Go |
API Block Store (include l'archivio 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:20.0.0 |
Smartphone, tablet, Auto, Android Go, ChromeOS |
Classi di utilitàcom.google.android.gms:play-services-base:18.11.1 |
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Test dei falsi 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.12.0 |
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Luce scarsa avanzata della fotocameracom.google.android.gms:play-services-camera-low-light-boost:16.0.1-beta09 |
Smartphone, tablet |
Google Castcom.google.android.gms:play-services-cast:22.3.1 |
Smartphone, tablet, Android Go, ChromeOS |
Google Cast Application Framework (CAF)com.google.android.gms:play-services-cast-framework:22.3.1 |
Smartphone, tablet, Android Go, ChromeOS |
Google Code Scannercom.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 |
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Interazioni tra dispositivi (DTDI)com.google.android.gms:play-services-dtdi:16.0.0-beta02 |
Smartphone, tablet, Android Go |
SDK Key Verifiercom.google.android.gms:contactkeys:16.0.0 |
Smartphone, tablet |
Autenticazione Fast IDentity Online (FIDO)com.google.android.gms:play-services-fido:21.3.0 |
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS Supportato su dispositivi con Android 7.0 (livello API 24) o versioni successive. |
API Google Fit per Android e API Recording su dispositivi mobili (per i dati sul fitness degli utenti)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 |
Smartphone, 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 |
SDK Google Play Games Services v2 Native C per Androidcom.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1 |
Smartphone, tablet, Android TV, Android Go, ChromeOS |
Google Play Games Services v1 per Androidcom.google.android.gms:play-services-games:25.0.0 |
Deprecato. Utilizza invece 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 la pagina Google Play Instant. |
Servizi di localizzazione per Androidcom.google.android.gms:play-services-location:21.4.0 |
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
SDK Google Maps per Androidcom.google.android.gms:play-services-maps:20.1.0 |
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
SDK Google Maps 3D per Androidcom.google.android.gms:play-services-maps3d:16.0.1 |
Smartphone, tablet |
Miglioramento degli effetti multimedialicom.google.android.gms:play-services-media-effect-enhancement:16.0.0-beta09 |
Smartphone, tablet |
Effetto multimediale Audio professionalecom.google.android.gms:play-services-media-effect-studiosound:16.0.0-beta02 |
Smartphone, tablet |
Scansione di codici a barre di ML Kitcom.google.android.gms:play-services-mlkit-barcode-scanning:18.3.1 |
Smartphone, tablet, Android Go, ChromeOS |
Scanner di documenti di ML Kitcom.google.android.gms:play-services-mlkit-document-scanner:16.0.0 |
Smartphone, tablet, Android Go, ChromeOS |
Riconoscimento facciale 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 personalizzata di ML Kitcom.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 dei soggetti 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 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 di dispositivi nelle vicinanzecom.google.android.gms:play-services-nearby:19.5.1 |
Smartphone, tablet, Android TV, Auto, Android Go |
Mostra licenze open sourcecom.google.android.gms:play-services-oss-licenses:17.5.2 |
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:23.0.0 |
Smartphone, tablet, Android TV Supportato su dispositivi con Android 5.0 (livello API 21) o versioni successive. |
Controllo di 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) fino ad Android 9 (livello API 28). |
Google Wallet (precedentemente Google Pay for Passes)com.google.android.gms:play-services-pay:16.5.0 |
Smartphone, tablet, Android Go, ChromeOS Supportato su 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.1.0 |
Smartphone, tablet, Android TV, Android Go, ChromeOS |
API Remote Gesturescom.google.android.gms:play-services-remotegestures:16.0.0 |
Smartphone, 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 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.3.0 |
Smartphone, tablet, Android TV, Android Go, ChromeOS |
API Tasks su Androidcom.google.android.gms:play-services-tasks:18.4.1 |
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Acceleration Service per Androidcom.google.android.gms:play-services-tflite-acceleration-service:16.5.0-beta02 |
Smartphone, tablet, Android Go, ChromeOS |
API TensorFlow Lite GPU Delegate per Google Play Servicescom.google.android.gms:play-services-tflite-gpu:16.5.0 |
Smartphone, tablet, Android Go, ChromeOS |
API Java di TensorFlow Lite per Google Play Servicescom.google.android.gms:play-services-tflite-java:16.5.0 |
Smartphone, tablet, Android Go, ChromeOS |
API TensorFlow Lite Support per Google Play Servicescom.google.android.gms:play-services-tflite-support:16.5.0 |
Smartphone, tablet, Android Go, ChromeOS |
API Thread Networkcom.google.android.gms:play-services-threadnetwork:16.3.0 |
Smartphone, tablet |
API Trusted Timecom.google.android.gms:play-services-time:16.0.1 |
Smartphone, tablet, Auto, Android Go, Wear OS |
Mobile Visioncom.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 |
Smartphone, tablet, Auto, Android Go, ChromeOS, Wear OS |
API Wearable Data Layercom.google.android.gms:play-services-wearable:20.0.1 |
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 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 |
Smartphone, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |