Firebase App Distribution Android SDK'sı ile test kullanıcılarını yeni uygulama sürümleriniz hakkında uyarın - Codelab

1. Genel Bakış

c7a9160ef7b184c7.png22e0b52f771c060d.png

Firebase Uygulama Dağıtımı SDK'sını Android uygulama kod laboratuvarınıza entegre etme sayfasına hoş geldiniz. Bu codelab'de, yeni sürümler indirilmeye hazır olduğunda test kullanıcılarınıza uygulama içi uyarılar görüntülemek için Uygulama Dağıtımı Android SDK'sını uygulamanıza ekleyeceksiniz. Test kullanıcılarınızın güncellemeleri almak üzere oturum açmalarını sağlamak için hem temel yapılandırmayı hem de özel yapılandırmayı nasıl kullanacağınızı öğreneceksiniz. Ardından, Uygulama Dağıtımı'na yeni bir sürüm gönderecek ve doğrudan uygulamanın içinde yeni bir derleme uyarısını tetikleyeceksiniz.

Ne öğreneceksin

  • Yayın öncesi bir uygulamayı test kullanıcılarına dağıtmak için Uygulama Dağıtımı nasıl kullanılır?
  • App Distribution Android SDK'sını uygulamanıza nasıl entegre edebilirsiniz?
  • Yüklemeye hazır yeni bir yayın öncesi yapı olduğunda test kullanıcısını nasıl uyarabilirim?
  • SDK'yı test ihtiyaçlarınıza uyacak şekilde nasıl özelleştirebilirsiniz?

İhtiyacınız olan şey

  • En son Android Studio sürümü.
  • Basit kod.
  • Android 4.4+ ve Google Play hizmetleri 9.8 veya sonraki sürümlere sahip bir test cihazı ya da Google Play hizmetleri 9.8 veya sonraki sürümlere sahip bir Emülatör.
  • Bir cihaz kullanılıyorsa, bir bağlantı kablosu.

Bu öğreticiyi nasıl kullanacaksınız?

Yalnızca baştan sona okuyun Okuyun ve alıştırmaları tamamlayın

Android uygulamaları oluşturma deneyiminizi nasıl değerlendirirsiniz?

Acemi Orta seviye Yetkin

2. Örnek kodu alın

GitHub deposunu komut satırından kopyalayın.

$ git clone https://github.com/FirebaseExtended/codelab-appdistribution-android.git

Git yüklü değilse örnek projeyi GitHub sayfasından veya bu bağlantıya tıklayarak da indirebilirsiniz.

3. Başlangıç ​​uygulamasını içe aktarın

Android Studio'dan codelab-appdistribution-android/start dizinini seçin ( android_studio_folder.png ) örnek kod indirmesinden ( Dosya > > .../codelab-appdistribution-android/start).

Artık başlangıç ​​projenizi Android Studio'da açmalısınız.

4. Firebase konsolu projesi oluşturun

Yeni bir Firebase projesi ekleme

  1. Firebase konsolunu açın.
  2. Proje Ekle'yi seçin ve ardından projenize "Firebase Codelab" adını verin.

Bu proje için Google Analytics'i etkinleştirmenize gerek yok.

  1. Proje oluştur'u tıklayın.

Firebase'e uygulama ekleme

Uygulamanızı Firebase'e kaydedin . Paket adı olarak "com.google.firebase.appdistributioncodelab" kullanın.

Google-services.json dosyasını uygulamanıza ekleyin

Paket adını ekledikten ve Kaydol'u seçtikten sonra google-services.json'u uygulamanıza eklemek için şu adımları izleyin:

  1. Firebase Android yapılandırma dosyanızı edinmek için Google-services.json'u İndir'i tıklayın.
  2. google-services.json dosyasını projenizdeki app dizinine kopyalayın.
  3. Dosya indirildikten sonra konsolda gösterilen sonraki adımları atlayabilirsiniz (bu adımlar sizin için build-android-start projesinde zaten yapılmıştır).

Uygulama Kimliğini Firebase uygulamanızla eşleşecek şekilde güncelleyin

  1. Soldaki menüde (Proje Sekmesi), "Android" Görünümünde olduğunuzdan emin olun ve "Gradle Komut Dosyaları" sekmesini bulun ve modülünüzü (uygulama düzeyi) Gradle dosyanızı açın (genellikle app/build.gradle.kts ).
  2. applicationId özelliğini, Firebase uygulamanızın uygulama kimliğiyle eşleşecek şekilde değiştirin. Bu "com.google.firebase.appdistributioncodelab" olmalıdır

Projenizi Gradle dosyalarıyla senkronize edin

Uygulamanızda tüm bağımlılıkların mevcut olduğundan emin olmak için Android Studio araç çubuğunda Dosya > Projeyi Gradle Dosyalarıyla Eşitle'yi seçerek projenizi Gradle dosyalarıyla senkronize edin.

5. App Distribution Android SDK ile uygulama içi yeni derleme uyarılarını ayarlayın

Bu adımda, Firebase App Distribution Android SDK'sını uygulamanıza ekleyecek ve uygulamanızın yeni sürümleri yüklenmeye hazır olduğunda test kullanıcılarınıza uygulama içi uyarılar göstereceksiniz. Bunu yapmak için "Firebase Codelab" projeniz için (Google Cloud Console'da) Firebase App Testers API'yi etkinleştirdiğinizden emin olun. Aynı hesapla oturum açmanız ve üstteki açılır menüden doğru projeyi seçmeniz gerekir.

Uygulama içi uyarıları yapılandırma

App Distribution Android SDK'sı, test kullanıcılarınız için uygulama içi derleme uyarıları ayarlamanın iki yolunu sunar:

  • Test kullanıcılarına gösterilecek önceden oluşturulmuş bir iletişim kutusuyla birlikte gelen temel bir uyarı yapılandırması.
  • Kullanıcı arayüzünüzü (UI) özelleştirmenize olanak tanıyan gelişmiş bir uyarı yapılandırması.

Temel uyarı yapılandırmasıyla başlayacağız. Henüz uyarıları etkinleştirmemiş test kullanıcılarına önceden oluşturulmuş bir uyarıları etkinleştirme iletişim kutusu görüntülemek ve ardından yeni bir yapının mevcut olup olmadığını kontrol etmek için updateIfNewReleaseAvailable kullanabilirsiniz. Test kullanıcıları, Uygulama Dağıtımı'nda uygulamaya erişimi olan bir hesapta oturum açarak uyarıları etkinleştirir. Yöntem çağrıldığında aşağıdaki sırayı etkinleştirir:

  1. Bir test cihazının uyarıları etkinleştirip etkinleştirmediğini kontrol eder. Değilse, yöntem, test kullanıcılarının Google hesaplarıyla Uygulama Dağıtımı'nda oturum açmasını isteyen önceden oluşturulmuş bir iletişim kutusu görüntüler.

Uyarıların etkinleştirilmesi, test cihazında uygulamanızın güncellemeleri boyunca devam eden tek seferlik bir işlemdir. Uygulama kaldırılana veya signOutTester yöntemi çağrılana kadar test cihazında uyarılar etkin kalır.

  1. Test cihazının yüklemesi için yeni mevcut yapıları kontrol eder.
  2. Test cihazını en son sürümü indirmeye yönlendiren önceden oluşturulmuş bir uyarı görüntüler.
  3. Güncellemeye devam etmeden önce yeni yapı türünü kontrol eder:
  4. Yeni yapı bir App Bundle (AAB) ise test kullanıcısını güncelleme işlemini tamamlaması için Play Store'a yönlendirir.
  5. Yeni yapı bir APK ise SDK, yeni yapıyı arka planda indirir ve indirme işlemi tamamlandığında test cihazından yeni yapıyı yüklemesini ister. SDK, NotificationManager. updateIfNewReleaseAvailable Görevine bir onProgressUpdate işleyicisi ekleyerek kendi ilerleme göstergenizi ekleyebilirsiniz.

Uygulamanızın herhangi bir noktasında updateIfNewReleaseAvailable() çağırabilirsiniz. Örneğin, MainActivity'nin onResume() yöntemi sırasında updateIfNewReleaseAvailable() çağırabilirsiniz:

MainActivity.kt dosyasını açın ve onResume() yöntemini şu şekilde oluşturun:

MainActivity.kt

override fun onResume() {
    super.onResume()
    checkForUpdate()
}

Şimdi checkForUpdate() yöntemini uygulayalım.

MainActivity.kt

   private fun checkForUpdate() {
        firebaseAppDistribution.updateIfNewReleaseAvailable()
            .addOnProgressListener { updateProgress ->
                // (Optional) Implement custom progress updates in addition to
                // automatic NotificationManager updates.
            }
            .addOnFailureListener { e ->
                if (e is FirebaseAppDistributionException) {
                    // Handle exception.
                }
            }
    }

6. Test kullanıcılarını oluşturun ve uygulamanızı indirmeye davet edin

Bu adımda uygulamanızı derler ve uygulamanızı Firebase konsolunu kullanarak test kullanıcılarına dağıtarak test edersiniz.

Uygulamanızı oluşturun

Uygulamanızın yayın öncesi sürümünü test kullanıcılarına dağıtmaya hazır olduğunuzda normal sürecinizi kullanarak APK'nızı oluşturun. APK'yı hata ayıklama anahtarınızla veya uygulama imzalama anahtarınızla imzalamanız gerekir.

Uygulamanızı test kullanıcılarına dağıtın

Uygulamanızı test kullanıcılarına dağıtmak için APK dosyasını Firebase konsolunu kullanarak yükleyin:

  1. Firebase konsolunun Uygulama Dağıtımı sayfasını açın. İstendiğinde Firebase projenizi seçin.
  2. Sürümler sayfasında, açılır menüden dağıtmak istediğiniz uygulamayı seçin.

623460c3c8a82ce6.png

  1. Başlayın'ı tıklayın

bf503b25066ff4a4.png

  1. Uygulamanızın APK dosyasını yüklemek için konsola sürükleyin.
  2. Yükleme tamamlandığında, derlemeyi almasını istediğiniz test kullanıcısı gruplarını ve bireysel test kullanıcılarını belirtin. (Daveti almak için e-posta adresinizi ekleyin.) Ardından derleme için sürüm notları ekleyin. Test kullanıcısı grupları oluşturma hakkında daha fazla bilgi edinmek için bkz. Test kullanıcılarını ekleme ve kaldırma .

3343048f0930e84b.png

  1. Derlemeyi test kullanıcılarının kullanımına sunmak için Dağıt'a tıklayın.

2be58fe195928bf9.png

Artık Firebase konsolunda uygulamanızın sürümüne eklediğiniz test kullanıcılarını görebilirsiniz.

9935a41810344c61.png

E-posta adresinizi eklediğiniz için Firebase App Distribution'dan sizi uygulamayı test etmeye davet eden bir e-posta alacaksınız. Artık ilk testçi sizsiniz! Test cihazınızda test kullanıcısı olarak kurulum yapmak için Daveti kabul etme bölümündeki talimatları izleyin.

Daveti kabul etmek

Sürümü indirip test etmek için öncelikle daveti kabul etmeniz gerekir.

  1. Android test cihazınızda Firebase App Distribution'dan gönderilen e-postayı açın ve Başlayın'a dokunun.
  2. Görüntülenen Firebase Uygulama Dağıtımı test cihazı web uygulamasında Google hesabınızla oturum açın ve Daveti kabul et'e dokunun. Artık test etmeye davet edildiğiniz sürümü görebilirsiniz.

c18cb684f8e82ad6.png

Sürümü test cihazından indirin

AppDistribution codelab uygulamasına gittiğinizde sürümün indirilmeye hazır olduğunu görebilirsiniz.

5414d9a536f25ece.png

  1. İndir'e dokunun, ardından uygulamayı yükleyin ve çalıştırın!
  2. Uygulama başladığında sizden yeni derleme uyarılarını etkinleştirmenizi ister. Aç'a dokunun .

b059e09acaa4779f.png

  1. Test kullanıcısı hesabınızla oturum açın..

22e0b52f771c060d.png

Uygulamaya geri dönersiniz. Uygulamayı bir sonraki çalıştırışınızda oturum açmanıza veya uyarıları kabul etmenize gerek yoktur

c9f33df16a2680d.png

Test kullanıcılarınıza bir güncelleme dağıtın

  1. Modül (uygulama düzeyi) Gradle dosyanızda (genellikle app/build.gradle) versionName'inizi "1.1" ve versionCode'u 2 olarak güncelleyin.
  2. APK'nızı normal sürecinizi kullanarak oluşturun. APK'yı hata ayıklama anahtarınızla veya uygulama imzalama anahtarınızla imzalamanız gerekir.
  3. Bu yeni APK'yı Firebase konsolunuza yükleyin, e-postanızı tekrar test kullanıcısı olarak ekleyin ve Dağıt'ı tıklayın.

2dfa702edfdce6b8.png

Derleme uyarılarını test edin

  1. Uygulama açıksa kapattığınızdan emin olun.
  2. Uygulamayı yeniden başlatın.
  3. Uygulama yeniden başlatıldığında Yeni Sürüm Mevcut uyarısı alırsınız.

987e3d0ba4e56f84.png

  1. En son sürümü almak için Güncelle'yi tıklayın.
  2. İstenirse bilinmeyen kaynaklardan yüklemeyi etkinleştirme seçeneğini seçin.
  3. Bir sonraki ekranda Yükle'ye (veya Güncelle'ye ) tıklayın.

a7c7cd15d60bc764.png

  1. Tebrikler! Uygulamanızı yerleşik uyarılarla güncelleyebildiniz.

7. Test kullanıcısı oturum açma işlemini özelleştirin

SignInTester/signOutTester ve isTesterSignedIn yöntemleri, test kullanıcınızın oturum açma deneyimini özelleştirmede size daha fazla esneklik sağlar, böylece uygulamanızın görünümüne ve tarzına daha iyi uyum sağlar.

Aşağıdaki örnek, test kullanıcısının Firebase Uygulama Dağıtımı test kullanıcısı hesabında zaten oturum açıp açmadığını kontrol eder; böylece oturum açma kullanıcı arayüzünüzü yalnızca henüz oturum açmamış test kullanıcıları için görüntülemeyi seçebilirsiniz. Test kullanıcısı oturum açtıktan sonra şunları yapabilirsiniz: Test cihazının yeni bir yapıya erişimi olup olmadığını kontrol etmek için checkForUpdate'i çağırın.

checkForUpdate() çağrısını yorumlayarak onResume'ta güncellemelerin otomatik olarak kontrol edilmesini devre dışı bırakalım.

MainActivity.kt

override fun onResume() {
        super.onResume()
        //checkForupdate()
    }

Bunun yerine, updatebutton'un OnClickListener'ına checkForUpdate() zaten eklenmiştir.

Şimdi, kullanıcının oturumu kapalıysa oturumunu kapatacak veya zaten oturum açmışsa kullanıcının oturumunu kapatacak SignIn() yöntemimizi uygulayalım.

MainActivity.kt

    private fun signIn() {
        if (isTesterSignedIn()) {
            firebaseAppDistribution.signOutTester()
            configureUpdateButton()
            configureSigninButton()
        } else {
            firebaseAppDistribution.signInTester()
        }
    }

Son olarak isTesterSignedIn metodunu uygulayalım.

MainActivity.kt

    private fun isTesterSignedIn() : Boolean {
        return firebaseAppDistribution.isTesterSignedIn
    }

Uygulamanızı oluşturun ve test edin

8. Tebrikler!

Firebase App Distribution Android SDK'sını kullanarak "uygulama içi uyarı görüntüleme" özelliğini bir uygulamaya eklediniz.

Neleri ele aldık?

  • Firebase Uygulama Dağıtımı
  • Firebase Uygulama Dağıtımı Yeni Uyarılar Android SDK'sı

Sonraki adımlar

Daha fazla bilgi edin

Bir Sorunuz mu var?

Sorunları Bildir