Introduzione
Nell'ambito dell'abilitazione delle API di Google o dei servizi Firebase nella tua applicazione Android, potresti dover aggiungere il plug-in google-services
al file build.gradle
:
dependencies {
classpath 'com.google.gms:google-services:4.4.1'
// ...
}
Il plug-in google-services
ha due funzioni principali:
- Elabora il file
google-services.json
e produci risorse Android che possono essere utilizzate nel codice della tua applicazione. Per saperne di più, consulta la sezione Aggiungere il file JSON. Aggiungi dipendenze per le librerie di base necessarie per i servizi che hai abilitato. Questo passaggio richiede l'applicazione del plug-in Google Services Gradle nel file
app/build.gradle
, in questo modo:
apply plugin: 'com.google.gms.google-services'
Puoi vedere il risultato di questo passaggio eseguendo
./gradlew :app:dependencies
.
Aggiungere il file JSON
In genere il file google-services.json
viene inserito nella directory app/
(nella directory principale del modulo dell'app Android Studio). A partire dalla versione 2.2.0
, il plug-in supporta file JSON specifici del tipo di build e della versione del prodotto. Tutte le seguenti strutture di directory sono valide:
// dogfood and release are build types. app/ google-services.json src/dogfood/google-services.json src/release/google-services.json ...
Nota: se fornisci un file google-services.json nella directory delle release, puoi gestire un progetto Firebase separato per gli APK di produzione.
Quando le versioni dei prodotti sono in uso, sono valide anche queste strutture di directory più complesse.
// free and paid are product flavors. app/ google-services.json src/dogfood/paid/google-services.json src/release/free/google-services.json ...
Elaborazione del file JSON
Il file google-services.json
ha la seguente struttura di base:
{ "project_info": {...}, "client": [...], }
L'oggetto project_info
contiene informazioni generali sul progetto, mentre ogni membro dell'array client
contiene informazioni sui client (app Android) che hai aggiunto al progetto.
Durante l'elaborazione del file JSON della tua app per Android, il plug-in utilizza solo l'oggetto client
che corrisponde al nome del pacchetto (per il tipo di build corrente) in base alla seguente logica:
- Per ogni membro dell'array
client
:- Controlla il valore di
client_info/android_client_info/package_name
- Se il nome del pacchetto corrisponde a questo valore, restituisci l'oggetto membro.
- Controlla il valore di
- Se nessuno dei membri di
client
corrisponde al nome del pacchetto, viene generata un'eccezione.
Nel resto del documento, utilizzeremo {YOUR_CLIENT}
per fare riferimento al membro dell'array client
determinato dalla procedura precedente.
Il risultato principale dell'elaborazione JSON è la produzione di due file XML a cui puoi fare riferimento come risorse Android nel tuo codice Java. Di seguito è riportato un esempio di ciascun file:
app/build/generated/res/google-services/{build_type}/values/values.xml
<?xml version="1.0" encoding="utf-8"?> <resources> <! -- Present in all applications --> <string name="google_app_id" translatable="false">1:1035469437089:android:73a4fb8297b2cd4f</string> <! -- Present in applications with the appropriate services configured --> <string name="gcm_defaultSenderId" translatable="false">1035469437089</string> <string name="default_web_client_id" translatable="false">337894902146-e4uksm38sne0bqrj6uvkbo4oiu4hvigl.apps.googleusercontent.com</string> <string name="ga_trackingId" translatable="false">UA-65557217-3</string> <string name="firebase_database_url" translatable="false">https://example-url.firebaseio.com</string> <string name="google_api_key" translatable="false">AIzbSyCILMsOuUKwN3qhtxrPq7FFemDJUAXTyZ8</string> <string name="google_crash_reporting_api_key" translatable="false">AIzbSyCILMsOuUKwN3qhtxrPq7FFemDJUAXTyZ8</string> <string name="project_id" translatable="false">mydemoapp</string> </resources>
app/build/generated/res/google-services/{flavor}/{build_type}/xml/global_tracker.xml
<?xml version="1.0" encoding="utf-8"?> <resources> <string name="ga_trackingId" translatable="false">UA-65557218-3</string> </resources>
Ciascun valore nei file XML è presente nel file google-services.json
nelle posizioni seguenti. Se il tuo progetto Android ha una configurazione
che ti impedisce di utilizzare il plug-in google-services
, puoi
ricreare in modo sicuro i file XML manualmente utilizzando questi valori:
google_app_id:
{YOUR_CLIENT}/client_info/mobilesdk_app_id
gcm_defaultSenderId:
project_info/project_number
default_web_client_id:
{YOUR_CLIENT}/oauth_client/client_id (client_type == 3)
ga_trackingId:
{YOUR_CLIENT}/services/analytics-service/analytics_property/tracking_id
firebase_database_url:
project_info/firebase_url
google_api_key:
{YOUR_CLIENT}/api_key/current_key
google_crash_reporting_api_key:
{YOUR_CLIENT}/api_key/current_key
project_id:
project_info/project_id
Risolvere i problemi
D: Durante la creazione viene visualizzato il seguente messaggio di errore: "Il file google-services.json non è presente nella cartella principale del modulo. Il plug-in di Google Services non può funzionare senza il plug-in".
R. La console di Firebase ti aiuterà a scaricare google-services.json
.
Inoltre, le guide rapide per la maggior parte delle API contengono istruzioni per generare questo file.
Dopo aver scaricato il file google-services.json
, copialo
nella cartella app/
del progetto Android Studio o nella
cartella app/src/{build_type}
se utilizzi più tipi di build.
D: Non riesco a trovare il simbolo "R.string.gcm_defaultSenderId", "R.xml.global_tracker" e così via.
R. Assicurati che il nome del pacchetto nel file build.gradle
corrisponda al nome del pacchetto inserito durante la creazione del file google-services.json
. Se non lo sai con certezza, ripeti la procedura di avvio e ottieni un nuovo file json.