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

1. Genel Bakış

resim10.png

Bu kod laboratuvarında, Android App Bundle sürümlerini Firebase App Distribution ve Gradle eklentisini kullanarak 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 bir 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 paketler ve derlersiniz?
  • Bir sürüm nasıl oluşturulur ve canlı test kullanıcıları ile nasıl paylaşılır?
  • Test kullanıcısı olarak yeni sürümler nasıl indirilir ve test edilir

Neye ihtiyacın olacak

  • Android Studio v4.0+
  • 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 kuruludur ve aşağıdaki duruma sahiptir:
    • Uygulama, Google Play kanallarından birine dağıtılır (Dahili test, Kapalı test, Açık test veya Üretim).
    • 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. Bir Firebase projesi oluşturun

  1. Firebase'de oturum açın.
  2. Firebase konsolunda, Proje Ekle öğesini tıklayın, ardından projenize "AppBundlesCodelab" adını verin. Firebase projeniz için 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. 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.
  1. Firebase konsolunda Proje ayarlarınıza gidin.

    image2.png
  2. Entegrasyonlar sekmesinde, Google Play kartındaki Bağlantı'yı 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.

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

Şimdi, App Distribution ve Gradle eklentisini uygulamanıza buildscript bağımlılıkları olarak eklemek için Android Studio'yu kullanacaksınız.

  1. Proje düzeyindeki Gradle dosyanıza ( android/build.gradle ), App Distribution Gradle eklentisini ve Google'ın Maven deposunu ekleyin.
    buildscript {
        repositories {
            // Check that you have Google's Maven repository (if not, add it).
            google()
            mavenCentral()
        }
        dependencies {
            // Add the App Distribution Gradle plugin
            classpath `com.google.firebase:firebase-appdistribution-gradle:2.1.2`
        }
    }
    
  2. Uygulama düzeyindeki Gradle dosyanıza ( android/app/build.gradle ), Uygulama Dağıtımı eklentisini ekleyin:
    apply plugin: `com.android.application`
    
    // ...
    
    // Apply the App Distribution Gradle plugin
    apply plugin: `com.google.firebase.appdistribution`
    
    // ...
    
  3. Kurumsal bir proxy veya Güvenlik Duvarı'nın arkasındaysanız, Uygulama Dağıtımını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 kod laboratuvarı için, eklentinin oturum açma işlemini kullanarak Google hesabınızda oturum açacaksınız.

  1. Android projenizin kökünde şu komutu çalıştırın:
    ~/your-android-project$ ./gradlew appDistributionLogin
    
  2. Komut bir kimlik doğrulama bağlantısı yazdırdığında, onu bir tarayıcıda açın. İstendiğinde, Google hesabınızda oturum açın ve Firebase projenize erişim izni verin. Gradle komutu, App Distribution eklentisinin Firebase ile kimlik doğrulaması yapmak için kullandığı bir yenileme belirteci yazdırır.
  3. FIREBASE_TOKEN ortam değişkenini önceki adımdaki belirteç olarak ayarlayın:
    ~/your-android-project$ export FIREBASE_TOKEN=your_firebase_token
    

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

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 onları yeni yapıyı test etmeye davet eden e-posta bildirimleri alır.

app/build.gradle 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-postanızı ekleyin, böylece derlemenizi dağıtıldıktan sonra test edebilirsiniz.

Örneğin:

android {

   // ...

   buildTypes {
       release {
           firebaseAppDistribution {
               appId="yourAppId"
               artifactType="AAB"
               testers="your@exampleemail.com, cerseimartell.772371@email.com"
           }
       }
   }

// ...
}

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

5. Bir yayın oluşturun ve dağıtın

  1. Uygulama paketleri dosyanızı oluşturmak için bundle Variant 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 şeklindedir).
  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).
    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 davetiyeleri alacak. Geliştirici olarak, artık App Distribution panosunun Yayınlar sekmesinde derlemeyi 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. 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ı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, indirme ilerlemesi ve sürüm sürümü gibi sürümler hakkında ek bilgiler görüntüler.

    resim9.png
  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ığında, sürümünüz otomatik olarak cihazınızın ana ekranında bir kısayol olarak görünecektir.

7. Tebrikler!

Az önce 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