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

1. Genel Bakış

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önetmeniz için merkezi bir merkez sağlar.

Ne öğreneceksin

• Firebase uygulamanızı Google Play'e nasıl bağlayabilirsiniz?
• Uygulamanızı bir uygulama paketi olarak nasıl paketleyebilir ve oluşturabilirsiniz?
• Bir sürüm nasıl oluşturulur ve canlı test kullanıcılarıyla nasıl paylaşılır?
• Test kullanıcısı olarak yeni sürümler nasıl indirilir ve test edilir?

İhtiyacınız olan şey

• 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 aşağıdaki duruma sahiptir:
  • Uygulama, Google Play kanallarından birine (Dahili test, Kapalı test, Açık test veya Üretim) dağıtılır.
  • Uygulamanın Google Play'deki incelemesi tamamlandı ve uygulama yayınlandı. Uygulama durumu sütununda şu durumlardan biri görüntüleniyorsa uygulamanız yayınlanır: Dahili test (Taslak dahili test değil), Kapalı test, Açık test veya Üretim.
• Firebase'den yeni derleme davetleri almak için test kullanıcısı olarak kullanabileceğiniz bir e-posta adresi

2. Firebase projesi oluşturun

1. Firebase'de oturum açın.
2. Firebase konsolunda Proje Ekle'yi tıklayın ve ardından projenize "AppBundlesCodelab" adını verin. Firebase projenizin Proje Kimliğini unutmayın. Proje Kimliğini düzenlemezseniz Firebase, projeniz için otomatik olarak benzersiz bir kimlik atar.
   
   
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.
   
   
2. Uygulamanızı kaydederken Google Play geliştirici hesabınıza yüklenen uygulamayla aynı paket adını kullandığınızdan emin olun.

   Not: Bir sonraki bölümde yapacağınız Firebase uygulamanızı Google Play geliştirici hesabınıza bağlamak için aynı paket adı gereklidir.

   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 için App Distribution'ın uygulamanıza ekleyebileceğiniz bir Firebase SDK'sı olmadığını unutmayın.
4. Konsola devam et'i tıklayın.

Google Play'e bağlantı

1. Firebase konsolunda Proje ayarlarınıza gidin.
   
   
2. Entegrasyonlar sekmesinde Google Play kartındaki Bağlantı'ya tıklayın.
3. Uygulama Dağıtımı entegrasyonunu etkinleştirmek için ekrandaki talimatları izleyin, ardından Google Play'e bağlanmak için yeni oluşturduğunuz Firebase uygulamanızı seçin.

Artık bu adımları tamamladığınıza göre Firebase uygulamanız, uygulamaların paket adları eşleştiği sürece Google Play geliştirici hesabınızdaki uygulamanıza bağlanacaktır.

3. Projenize Uygulama Dağıtımı ekleyin

App Distribution Gradle eklentisini ekleyin

Artık 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 bloğuna 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 veya Güvenlik Duvarı 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ğrulayın

Gradle eklentisini kullanmadan önce Firebase projenizin kimliğini doğrulamanız gerekir. Bu codelab için Firebase CLI'yi kullanarak Google hesabınızda oturum açacaksınız.

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

~/your-android-project$ firebase login

Referans belgeler daha fazla ayrıntı içerir.

4. Paket özelliklerinizi Android Studio'da yapılandırın

Bu adımda kendinizi daha sonra dağıtacağınız yapının test kullanıcısı olarak ekleyeceksiniz. Yapıyı dağıttığınızda test uzmanları Firebase'den kendilerini yeni yapıyı test etmeye davet eden e-posta bildirimleri alır.

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

• appID : Uygulamanızın Firebase Uygulama Kimliği. Bunu 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 için 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 = "[e-mail], [e-mail], [e-mail]"
                }
            }
        }

        // ...
    }

Bir seçenek olarak, build.gradle.kts dosyanızda ayarlanan değerleri -PappDistribution- property-name = property-value biçimindeki komut satırı argümanlarını ileterek de geçersiz kılabilirsiniz.

5. Bir sürüm oluşturun ve dağıtın

1. Uygulama paketleri dosyanızı oluşturmak için bundle Variant 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 ekleyin (3. adımda aldığınız jeton: Uygulamanıza Uygulama Dağıtımı Ekleme).

   export FIREBASE_TOKEN=your_firebase_token
   
   ./gradlew --stop // Only needed for environment variable changes
   
   ./gradlew bundleRelease appDistributionUploadRelease
   

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

6. Sürümünüzü indirin ve test edin

Bu bölümde, dağıttığınız sürümü indirmek için test kullanıcısı olarak kurulum yapacaksı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.
   
   
2. Google hesabınızla oturum açın ve dağıtılan sürümü test etme davetini kabul edin. Bir seçenek olarak, indirilen sürümlerin cihazınızın Downloads klasörüne eklenmesini engelleyen Firebase App Tester'ı da indirebilirsiniz. Ayrıca sürümler hakkında indirme ilerlemesi ve sürüm sürümü gibi ek bilgileri de görüntüler.
   
   
3. Play Store'dan yüklemek için sürümde İ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ıktan sonra sürümünüz, cihazınızın ana ekranında otomatik olarak bir kısayol olarak görünecektir.

7. Tebrikler!

Bir uygulama paketi yüklemek ve bir sürümü test kullanıcılarına dağıtmak için Firebase App Distribution'ı kullandınız.

Sonraki adımlar

• Sürümünüz için test kullanıcılarını nasıl yöneteceğiniz hakkında daha fazla bilgi edinmek için Uygulama Dağıtımı belgelerine gidin.
• Uygulamanızı dağıtmak için kullanabileceğiniz diğer araçlar hakkında bilgi edinmek için Android App Bundle'ınızı oluşturma ve test etme bölümüne bakın.