Giriş
Android uygulamanızda Google API'lerini veya Firebase hizmetlerini etkinleştirdiğinizde, build.gradle
dosyanıza google-services
eklentisini eklemeniz gerekebilir:
dependencies {
classpath 'com.google.gms:google-services:4.4.1'
// ...
}
google-services
eklentisinin iki temel işlevi vardır:
google-services.json
dosyasını işleyin ve uygulamanızın kodunda kullanılabilecek Android kaynakları üretin. Daha fazla bilgi için JSON Dosyasını Ekleme konusuna bakın.Etkinleştirdiğiniz hizmetler için gereken temel kitaplıklara bağımlılık ekleyin. Bu adım,
app/build.gradle
dosyanızda Google Services Gradle eklentisini uygulamanızı gerektirir. Şunun gibi:
apply plugin: 'com.google.gms.google-services'
./gradlew :app:dependencies
komutunu çalıştırarak bu adımın sonucunu görebilirsiniz.
JSON dosyasını ekleme
google-services.json
dosyası genellikle app/
dizinine (Android Studio uygulama modülünün kök dizininde) yerleştirilir. 2.2.0
sürümünden itibaren eklenti, derleme türüne ve ürün çeşidine özel JSON dosyalarını desteklemektedir. Aşağıdaki dizin yapılarının tümü geçerlidir:
// dogfood and release are build types. app/ google-services.json src/dogfood/google-services.json src/release/google-services.json ...
Not: Sürüm dizininde bir google-services.json dosyası sağlamak, üretim APK'larınız için ayrı bir Firebase projesi yönetmenizi sağlar.
Ürün çeşitleri kullanıldığında, bu daha karmaşık dizin yapıları da geçerli olur.
// free and paid are product flavors. app/ google-services.json src/dogfood/paid/google-services.json src/release/free/google-services.json ...
JSON dosyasını işleme
google-services.json
dosyası aşağıdaki temel yapıya sahiptir:
{ "project_info": {...}, "client": [...], }
project_info
nesnesi, projenizle ilgili genel bilgileri içerirken client
dizisinin her bir üyesi, projeye eklediğiniz istemciler (Android uygulamaları) hakkında bilgiler içerir.
Eklenti, Android uygulamanız için JSON dosyasını işlerken yalnızca aşağıdaki mantığa göre paket adınızla eşleşen (mevcut derleme türü için) client
nesnesini kullanır:
client
dizisinin her bir üyesi için:client_info/android_client_info/package_name
değerini kontrol edin- Paket adı bu değerle eşleşirse üye nesnesini döndürün.
client
üyelerinden hiçbiri paket adıyla eşleşmezse istisna yapılır.
Bu belgenin geri kalanında, yukarıdaki prosedürle belirlenen client
dizisinin üyesine referans vermek için {YOUR_CLIENT}
kullanacağız.
JSON işleminin ana sonucu, Java kodunuzda Android kaynakları olarak referans verebileceğiniz iki XML dosyası oluşturmaktır. Aşağıda her dosyaya ait bir örnek verilmiştir:
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>
XML dosyalarındaki her değer google-services.json
dosyasında aşağıdaki konumlarda bulunur. Android projenizde google-services
eklentisini kullanmanızı engelleyen bir yapılandırma varsa aşağıdaki değerleri kullanarak XML dosyalarını manuel olarak güvenli bir şekilde yeniden oluşturabilirsiniz:
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
Sorun giderme
S: Derleme yaparken şu hata mesajını alıyorum: "google-services.json dosyası modül kök klasöründe yer almıyor. Google Hizmetleri Eklentisi, bu eklenti olmadan çalışamaz".
Y: Firebase konsolu, google-services.json
uygulamasını indirmenize yardımcı olur.
Ek olarak, çoğu API'ye yönelik Hızlı Başlangıç kılavuzlarında bu dosyanın oluşturulmasına ilişkin talimatlar bulunur.
google-services.json
dosyasını indirdikten sonra dosyayı Android Studio projenizin app/
klasörüne veya birden fazla derleme türü kullanıyorsanız app/src/{build_type}
klasörüne kopyalayın.
S: "R.string.gcm_defaultSenderId", "R.xml.global_tracker" simgesini bulamıyorum.
Y: build.gradle
dosyanızdaki paket adının, google-services.json
dosyasını oluştururken girdiğiniz paket adıyla eşleştiğinden emin olun. Emin değilseniz başlangıç akışını tekrar çalıştırın ve
yeni bir json dosyası alın.