Pengantar
Sebagai bagian dari pengaktifan layanan Google API atau Firebase di aplikasi Android,
Anda mungkin harus menambahkan plugin google-services
ke file
build.gradle
:
dependencies {
classpath 'com.google.gms:google-services:4.4.2'
// ...
}
Plugin google-services
memiliki dua fungsi utama:
- Proses file
google-services.json
dan hasilkan resource Android yang dapat digunakan dalam kode aplikasi Anda. Lihat Menambahkan File JSON informasi selengkapnya. Tambahkan dependensi untuk library dasar yang diperlukan bagi layanan yang telah Anda aktifkan. Langkah ini mengharuskan Anda menerapkan plugin Gradle Layanan Google dalam file
app/build.gradle
, seperti berikut:
apply plugin: 'com.google.gms.google-services'
Anda dapat melihat hasil dari langkah ini dengan menjalankan
./gradlew :app:dependencies
.
Menambahkan File JSON
File google-services.json
umumnya ditempatkan di
direktori app/
(di root modul aplikasi Android Studio). Mulai
versi 2.2.0
, plugin mendukung file JSON khusus jenis build
dan ragam produk. Semua struktur direktori berikut valid:
// dogfood and release are build types. app/ google-services.json src/dogfood/google-services.json src/release/google-services.json ...
Catatan: Dengan menyediakan file google-services.json dalam direktori rilis, Anda dapat mengelola project Firebase yang terpisah untuk APK produksi.
Ketika ragam produk digunakan, struktur direktori yang lebih rumit ini juga valid.
// free and paid are product flavors. app/ google-services.json src/dogfood/paid/google-services.json src/release/free/google-services.json ...
Memproses File JSON
File google-services.json
memiliki struktur dasar berikut:
{ "project_info": {...}, "client": [...], }
Objek project_info
berisi informasi umum tentang project
Anda, sedangkan setiap anggota array client
berisi informasi
tentang klien (aplikasi Android) yang telah Anda tambahkan ke project.
Saat memproses file JSON untuk aplikasi Android Anda, plugin hanya menggunakan objek client
yang cocok dengan nama paket Anda (untuk jenis build saat ini) berdasarkan logika berikut:
- Untuk setiap anggota array
client
:- Periksa nilai
client_info/android_client_info/package_name
- Jika nama paket cocok dengan nilai ini, tampilkan objek anggota.
- Periksa nilai
- Jika tidak ada anggota
client
yang cocok dengan nama paket, pengecualian akan ditampilkan.
Dalam dokumen ini, kita akan menggunakan {YOUR_CLIENT}
untuk merujuk ke anggota array client
yang ditentukan oleh prosedur di atas.
Hasil utama pemrosesan JSON adalah menghasilkan dua file XML yang dapat Anda referensikan sebagai resource Android dalam kode Java. Berikut adalah contoh dari setiap 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>
Setiap nilai dalam file XML ada dalam file google-services.json
di lokasi di bawah ini. Jika project Android Anda memiliki beberapa konfigurasi
yang mencegah Anda menggunakan plugin google-services
, Anda dapat
membuat ulang file XML secara manual dengan aman menggunakan nilai-nilai ini:
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
Pemecahan masalah
T: Saat membangun, saya mendapatkan pesan error berikut: "File google-services.json is missing from module root folder. Plugin Layanan Google tidak dapat berfungsi tanpanya".
J: Firebase console akan membantu Anda mendownload google-services.json
.
Selain itu, Panduan memulai untuk sebagian besar API memiliki petunjuk cara
membuat file ini.
Setelah mendownload file google-services.json
, salin
ke dalam folder app/
project Android Studio, atau ke
folder app/src/{build_type}
jika Anda menggunakan beberapa jenis build.
T: Saya tidak dapat menemukan simbol "R.string.XMPP_defaultSenderId", "R.xml.global_tracker", dll.
J: Pastikan nama paket dalam file build.gradle
cocok dengan
nama paket yang Anda masukkan saat membuat file
google-services.json
. Jika Anda tidak yakin, jalankan lagi alur memulai dan dapatkan file json baru.