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.2'
// ...
}
google-services
eklentisinin iki ana işlevi vardır:
google-services.json
dosyasını işleyin ve uygulamanızın kodunda kullanılabilecek Android kaynakları oluşturun. Daha fazla bilgi için JSON dosyasını ekleme başlıklı makaleyi inceleyin.Etkinleştirdiğiniz hizmetler için gereken temel kitaplıklara bağımlılık ekleyin. Bu adım, Google Services Gradle eklentisini
app/build.gradle
dosyanıza aşağıdaki şekilde uygulamanızı gerektirir:
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üne) yerleştirilir. 2.2.0
sürümünden itibaren eklenti, derleme türü ve ürün aromasına özel JSON dosyalarını destekler. 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ğladığınızda, üretim APK'larınız için ayrı bir Firebase projesi saklayabilirsiniz.
Ürün çeşitleri kullanılırken daha karmaşık dizin yapıları da geçerlidir.
// 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ı temel yapıya sahiptir:
{ "project_info": {...}, "client": [...], }
project_info
nesnesi, projenizle ilgili genel bilgileri içerir. client
dizisinin her bir üyesi ise projeye eklediğiniz istemciler (Android uygulamaları) hakkında bilgi içerir.
Eklenti, Android uygulamanızın JSON dosyasını işlerken aşağıdaki mantığa göre yalnızca paket adınızla eşleşen client
nesnesini (mevcut derleme türü için) kullanır:
client
dizisinin her ü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şmiyorsa bir istisna oluşur.
Bu belgenin geri kalanında, yukarıdaki prosedürle belirlenen client
dizisinin üyesini belirtmek için {YOUR_CLIENT}
terimini kullanacağız.
JSON işlemenin ana sonucu, Java kodunuzda Android kaynakları olarak referans verebileceğiniz iki XML dosyası oluşturmaktır. Aşağıda her dosyaya ilişkin 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, aşağıdaki konumlarda google-services.json
dosyasında 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: İçerik oluştururken şu hata mesajını alıyorum: "Modül kök klasöründe google-services.json dosyası eksik. Google Hizmetleri Eklentisi olmadan çalışamaz".
Y: Firebase konsolu, google-services.json
uygulamasını indirmenize yardımcı olur.
Ayrıca, çoğu API'nin hızlı başlangıç kılavuzunda bu dosyanın nasıl oluşturulacağıyla ilgili 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" vb.sembollerini 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ı yeniden çalıştırın ve yeni bir json dosyası alın.