Google Hizmetleri Gradle Eklentisi

Giriş

Android cihazınızda Google API'lerini veya Firebase hizmetlerini etkinleştirmenin bir parçası olarak google-services eklentisini uygulamanıza eklemeniz gerekebilir. build.gradle dosyası:

dependencies {
    classpath 'com.google.gms:google-services:4.4.2'
    // ...
}

google-services eklentisinin iki ana işlevi vardır:

  1. google-services.json dosyasını işleyip Android üretin veya kaynaklarınız yoksa uygulamanızın girin. Daha fazla bilgi için JSON dosyasını ekleme başlıklı makaleyi inceleyin.

  2. Sahip olduğunuz hizmetler için gereken temel kitaplıklara bağımlılık ekleyin etkin. Bu adım, Google Hizmetleri Gradle uygulamasını uygulamanızı gerektirir app/build.gradle dosyanıza aşağıdaki gibi bir eklenti ekleyin:
    apply plugin: 'com.google.gms.google-services'

    Bu adımın sonucunu şu komutu çalıştırarak görebilirsiniz: ./gradlew :app:dependencies

JSON dosyasını ekleme

google-services.json dosyası genellikle dosyanın app/ dizini (Android Studio uygulama modülünün kökünde). Farklı 2.2.0 sürümünün eklentisi, derleme türünü ve ürün türünü destekliyor belirli JSON dosyaları oluşturabilirsiniz. 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 google-services.json dosyası sağladığınızda Üretim APK'larınız için ayrı bir Firebase projesi kullanmanızı öneririz.

Ürün aromaları kullanıldığında bu daha karmaşık dizin yapıları 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, projesinde gösterilirken, client dizisinin her bir üyesi istemciler (Android uygulamaları) hakkında daha fazla bilgi edindiniz.

Eklenti, Android uygulamanızın JSON dosyasını işlerken yalnızca Paket adınızla eşleşen client nesne (mevcut derleme için) türü) aşağıdaki mantığa göre oluşturulur:

  • 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, referans için {YOUR_CLIENT} yukarıdaki prosedürle belirlenen client dizisinin üyesidir.

JSON işlemenin asıl sonucu, iki XML dosyası oluşturmaktır. kodu, Java kodunuzda Android kaynakları olarak başvuruda bulunabilir. Aşağıda bir her dosya için:

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 içinde yer alır dosyası oluşturun. Android projenizde bazı yapılandırmalar varsa google-services eklentisini kullanmanızı engelliyorsa aşağıdaki değerleri kullanarak XML dosyalarını manuel olarak güvenli bir şekilde yeniden oluşturun:

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: Oluşturma işlemi sırasında şu hata mesajını alıyorum: "Dosya Modül kök klasöründe google-services.json eksik. Google Hizmetleri Eklenti olmadan çalışamaz" hata mesajını alıyorum.

Y: Firebase konsolu, google-services.json dosyasını indirin. Ayrıca, çoğu API'nin hızlı başlangıç kılavuzunda, bu dosyayı oluşturuyor. google-services.json dosyasını indirdikten sonra kopyalayın. Android Studio projenizin app/ klasörüne veya Birden fazla derleme türü kullanıyorsanız app/src/{build_type} klasörünü.

S: "R.string.gcm_defaultSenderId" simgesini bulamıyorum, "R.xml.global_tracker" vb.

Y: build.gradle dosyanızdaki paket adının google-services.json oluştururken girdiğiniz paket adı dosyası olarak kaydedebilirsiniz. Emin değilseniz başlangıç akışını yeniden gerçekleştirin ve yeni bir json dosyası yükleyin.