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

1. Genel Bakış

Bu kod laboratuvarında, Android App Bundle sürümlerinin Firebase App Distribution ve Gradle eklentisini kullanarak test kullanıcılarına nasıl dağıtılacağını öğreneceksiniz. Uygulama Dağıtımı, 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 paketleme ve oluşturma
• Bir yayın nasıl oluşturulur ve canlı test kullanıcıları ile nasıl paylaşılır?
• Yeni sürümler nasıl indirilir ve test cihazı olarak test edilir

Neye ihtiyacın olacak

• 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 ayarlandı ve şu durumda :
  • 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ınlanmıştır: Dahili test (Taslak dahili testi 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. Bir Firebase projesi oluşturun

1. Firebase'de oturum açın.
2. Firebase konsolunda Proje Ekle 'yi tıklayın, ardından projenizi "AppBundlesCodelab" olarak adlandırın. Firebase projeniz için 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, ardından Proje oluştur'a 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 uygulama ile 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 ekleyecek 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. App Distribution entegrasyonunu etkinleştirmek için ekrandaki talimatları izleyin, ardından Google Play'e bağlamak için yeni oluşturduğunuz Firebase uygulamanızı seçin.

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

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

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 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ı kullanıyorsanız, App Distribution'ın dağıtımlarınızı Firebase'e yüklemesini sağlayan şu 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

Başvuru belgeleri daha fazla ayrıntı içerir.

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

Bu adımda, daha sonra dağıtacağınız yapı için kendinizi bir test kullanıcısı olarak ekleyeceksiniz. Yapıyı dağıttıktan sonra, test kullanıcıları Firebase'den onları 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, -PappDistribution- property-name = property-value biçiminde komut satırı bağımsız değişkenleri ileterek build.gradle.kts dosyanızda ayarlanan değerleri 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 oluşturma dizininde bulun (varsayılan konum app/build/outputs/bundle/release şeklindedir).
3. Sürümü dağıtmak için, projenizin Gradle sarmalayıcısıyla bundleRelease ve appDistributionUploadRelease hedeflerini oluşturun. Firebase belirtecini ekleyin (3. adımda aldığınız: Uygulama Dağıtımını uygulamanıza ekleyin).

   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ı indirmek ve test etmek için e-posta davetleri alacak. Geliştirici olarak, artık Uygulama Dağıtım panosunun Sürümler sekmesinde yapıyı 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 bir test kullanıcısı olarak ayarlanacaksınız. Bir 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 daveti 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 önleyen Firebase App Tester'ı da indirebilirsiniz. Ayrıca sürümler hakkında indirme ilerlemesi ve sürüm sürümü gibi ek bilgiler 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 tamamlandığında, sürümünüz otomatik olarak cihazınızın ana ekranında bir kısayol olarak görünecektir.

7. Tebrikler!

Bir uygulama paketi yüklemek ve test kullanıcılarına bir sürüm 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 için Android App Bundle'ınızı oluşturma ve test etme bölümüne bakın.