Uygulama paketi sürümlerini test kullanıcılarına dağıtma - Codelab

1. Genel Bakış

resim10.png

Bu codelab'de, Firebase App Distribution'ı ve Gradle eklentisini kullanarak Android App Bundle sürümlerini test kullanıcılarına nasıl dağıtacağınızı öğreneceksiniz. App Distribution, uygulamanızın yayın öncesi sürümlerini ve her sürüme davet ettiğiniz test kullanıcılarını yönetebileceğiniz merkezi bir merkez sağlar.

Neler öğreneceksiniz?

  • Firebase uygulamanızı Google Play'e bağlama
  • Uygulamanızı uygulama paketi olarak paketleme ve derleme
  • Sürüm oluşturma ve canlı test kullanıcılarıyla paylaşma
  • Test kullanıcısı olarak yeni sürümleri indirme ve test etme

Gerekenler

  • En son Android Studio sürümü
  • Android Studio'dan oluşturduğunuz imzalı bir paket dosyası
  • Sahibi veya Yöneticisi olduğunuz bir Google Play geliştirici hesabı
  • Google Play'deki uygulamanız Google Play uygulama kontrol panelinde ayarlanmıştır ve şu duruma sahiptir:
    • Uygulama, Google Play kanallarından birine (dahili test, kapalı test, açık test veya üretim) dağıtılmış olmalıdır.
    • Uygulamanın Google Play'deki incelemesi tamamlanmış ve uygulama yayınlanmış olmalıdır. Uygulama durumu sütununda şu durumlardan biri gösteriliyorsa uygulamanız yayınlanmış demektir: Dahili test (Taslak dahili test değil), Kapalı test, Açık test veya Üretim.
  • Firebase'den yeni derleme davetiyeleri almak için test kullanıcısı olarak kullanabileceğiniz bir e-posta adresi

2. Firebase projesi oluşturma

  1. Firebase'de oturum açın.
  2. Firebase konsolunda Proje Ekle'yi tıklayın, ardından projenizi "AppBundlesCodelab" olarak adlandırın. Firebase projenizin proje kimliğini unutmayın. Proje kimliğini düzenlemezseniz Firebase, projeniz için otomatik olarak benzersiz bir kimlik atar.

    resim8.png
  3. (İsteğe bağlı) İstendiğinde Google Analytics'i etkinleştirin.
  4. Kalan adımları tamamlayın ve ardından Proje oluştur'u tıklayın.

Uygulama paketinizi projeye ekleyin

  1. Firebase konsolunda Uygulama ekle'yi tıklayın.

    resim5.png
  2. Uygulamanızı kaydederken Google Play geliştirici hesabınıza yüklenen uygulamayla aynı paket adını kullandığınızdan emin olun. ziyaret edin. Son olarak, Uygulamayı kaydet'i tıklayın.
  3. Uygulamanızın Firebase yapılandırma dosyasını (google-services.json) uygulamanıza eklemek için kalan adımları tamamlayın. Android'de App Distribution'ın uygulamanıza eklenebilecek bir Firebase SDK'sı olmadığını unutmayın.
  4. Konsola devam et'i tıklayın.
  1. Firebase konsolunda Proje ayarları'na gidin.

    resim2.png
  2. Entegrasyonlar sekmesinde Google Play kartından Bağla'yı tıklayın.
  3. App Distribution entegrasyonunu etkinleştirmek için ekrandaki talimatları uygulayın, ardından yeni oluşturduğunuz Firebase uygulamanızı Google Play'e bağlamayı seçin.

Bu adımları tamamladığınıza göre Firebase uygulamanız, uygulamanızın Google Play geliştirici hesabınızdaki paket adları eşleşiyor.

3. Projenize App Distribution ekleme

App Distribution Gradle eklentisini ekleyin

Şimdi, App Distribution'ı ve Gradle eklentisini uygulamanıza eklemek için Android Studio'yu kullanacaksınız.

  1. Proje düzeyindeki Gradle dosyanızda (android/build.gradle.kts), App Distribution Gradle eklentisini plugins bloğuna ekleyin.
    plugins {
     //...

     // Add the App Distribution Gradle plugin
     id("com.google.firebase.appdistribution") version "4.0.0" apply false
}
  2. Proje düzeyindeki Settings Gradle dosyanızda (android/settings.gradle.kts), Google'ın Maven deposunu pluginManagement blokuna ekleyin.
     pluginManagement {
     // Check that you have Google's Maven repository (if not, add it).
     repositories {
         google()
         mavenCentral()
     }
 }
  3. Uygulama düzeyindeki Gradle dosyanızda (android/app/build.gradle.kts), App Distribution eklentisini plugins bloğuna ekleyin.
    plugins {
     //...

     // Add the App Distribution plugin
     id("com.google.firebase.appdistribution")
}
  4. Kurumsal bir proxy'nin veya güvenlik duvarının arkasındaysanız App Distribution'ın dağıtımlarınızı Firebase'e yüklemesini sağlayan aşağıdaki Java sistem özelliğini ekleyin:
    -Djavax.net.ssl.trustStore=/path/to/truststore -Djavax.net.ssl.trustStorePassword=password

Firebase projenizin kimliğini doğrulama

Gradle eklentisini kullanmadan önce Firebase projenizin kimliğini doğrulamanız gerekir. Bu codelab'de, Google Hesabınızda Firebase KSA kullanarak oturum açacaksınız.

Android projenizin kök dizininde aşağıdaki komutu çalıştırın:

~/your-android-project$ firebase login

Referans belgelerinde daha ayrıntılı bilgi bulabilirsiniz.

4. Android Studio'da paket özelliklerinizi yapılandırma

Bu adımda, daha sonra dağıtacağınız derleme için kendinizi test kullanıcısı olarak ekleyeceksiniz. Derlemeyi dağıttığınızda test kullanıcıları Firebase'den, kullanıcıları yeni derlemeyi test etmeye davet eden e-posta bildirimleri alır.

app/build.gradle.kts sayfanıza bir firebaseAppDistribution bölümü ekleyin ve aşağıdaki parametreleri dahil edin:

  • appID: Uygulamanızın Firebase Uygulama Kimliği. Bu bilgiyi Proje ayarlarınızın Genel sekmesinde bulabilirsiniz.
  • artifactType: Uygulamanızın dosya türü (AAB).
  • testers: Test kullanıcılarınızın e-posta adresleri Bu codelab'e kendi e-posta adresinizi ekleyin. Böylece derlemenizi dağıtıldıktan sonra test edebilirsiniz.

Örneğin:

    android {

       // ...

       buildTypes {
            getByName("release") {
                firebaseAppDistribution {
                  appId = "yourAppId"
                  artifactType = "AAB"
                  testers = "ali@example.com, bri@example.com, cal@example.com"
                }
            }
        }

        // ...
    }

Ayrıca, komut satırı bağımsız değişkenlerini -PappDistribution-property-name=property-value biçiminde ileterek build.gradle.kts içinde ayarlanan değerleri geçersiz kılabilirsiniz.

5. Sürüm oluşturma ve dağıtma

  1. Uygulama paketleri dosyanızı oluşturmak için bundleVariant Gradle görevini çalıştırın:
    $ ./gradlew :base:bundleRelease
  2. Paketi uygulamanızın derleme dizininde bulun (varsayılan konum: app/build/outputs/bundle/release).
  3. Sürümü dağıtmak için projenizin Gradle sarmalayıcısıyla bundleRelease ve appDistributionUploadRelease hedeflerini oluşturun. Firebase jetonunu (3. adımda: Uygulamanıza App Distribution'ı ekleyin) ekleyin.
    export FIREBASE_TOKEN=your_firebase_token

./gradlew --stop // Only needed for environment variable changes

./gradlew bundleRelease appDistributionUploadRelease

Test kullanıcıları artık derlemeyi indirmek ve test etmek için e-posta davetiyeleri alacak. Geliştirici olarak, derlemeyi artık Uygulama Dağıtımı kontrol panelinin Sürümler sekmesinden izleyebilirsiniz.

6. Sürümünüzü indirme ve test etme

Bu bölümde, dağıttığınız sürümü indirmek için bir test kullanıcısı olarak ayarlanırsınız. Test kullanıcısı olarak, test cihazınızın kimliğini doğrulamanız ve Google Play Store uygulamasında dahili uygulama paylaşımını etkinleştirmeniz gerekir.

  1. Test cihazınızda, test kullanıcısı e-posta hesabınızda oturum açın ve Firebase'den gelen davetiyeyi açın.

    resim6.png
  2. Google hesabınızla oturum açın ve dağıtılmış sürümü test etme davetini kabul edin. Dilerseniz, indirilen sürümlerin cihazınızın Downloads klasörüne eklenmesini engelleyen Firebase App Tester'ı da indirebilirsiniz. Ayrıca, sürümlerle ilgili indirme ilerleme durumu ve sürüm sürümü gibi ek bilgiler de gösterilir.

    resim9.png
  3. Sürümü Play Store'dan yüklemek için İndir'e dokunun.
  4. İstendiğinde, dahili uygulama paylaşımını etkinleştirmek için kalan adımları tamamlayın (talimatlar test cihazınızda görüntülenir ve yalnızca bir kez tamamlanması gerekir).

İndirme işlemi tamamlandığında sürümünüz cihazınızın ana ekranında otomatik bir şekilde kısayol olarak görünür.

7. Tebrikler!

Firebase App Distribution'ı kullanarak uygulama paketi yükleyip test kullanıcılarına sürüm dağıttınız.

Sonraki adımlar