Configurare Google Play Services

Per sviluppare un'app utilizzando le API Google Play Services, segui le istruzioni in questa pagina per configurare il tuo progetto con gli SDK pertinenti, disponibili nel repository di Google Maven.

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

• Un dispositivo Android compatibile con Android 5.0 (livello API 21) o versioni successive e su cui è installata l'app Google Play Store.
• L'emulatore Android con una AVD che esegue la piattaforma delle API di Google sulla base di Android 5.0 (livello API 21) o versioni successive.

Dichiara le dipendenze per Google Play Services

Per sviluppare funzionalità che dipendono dalle API Google Play Services nella tua app, completa questi 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 le dipendenze da Google Play Services comuni per le app per Android. Potresti anche voler aggiungere le dipendenze Firebase al tuo progetto.

3. Salva le modifiche e sincronizza il progetto.

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

apply plugin: 'com.android.application'

...

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

Periodicamente vengono rilasciate nuove versioni degli SDK 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 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 attivare nell'app funzionalità che richiedono Google Play Services per il funzionamento.

Per verificare la presenza di Google Play Services sul dispositivo, utilizza 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 un'API specifica, leggi la guida Accesso alle API di Google.

Dipendenze di Google Play Services

La seguente tabella 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 cercare un caso d'uso o un nome di dipendenza specifico inserendo il testo nella casella visualizzata dopo i pulsanti.

Smartphone e tablet Android TV Auto Android Go ChromeOS Wear OS

Plug-in Gradle

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

Tabella 2. Elenco dei plug-in Gradle inclusi in Google Play Services

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