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

1. Genel Bakış

Android uygulama kod laboratuvarınızda Firebase Uygulama Dağıtım SDK'sını Entegre Etme'ye hoş geldiniz. Bu kod laboratuvarında, yeni derlemeler indirilmeye hazır olduğunda testçilerinize 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çmasını sağlamak için hem temel yapılandırmayı hem de özel yapılandırmayı nasıl kullanacağınızı öğreneceksiniz. Ardından, App Distribution'a yeni bir sürüm gönderecek ve doğrudan uygulamada yeni bir derleme uyarısı tetikleyeceksiniz.

ne öğreneceksin

• Bir yayın öncesi 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ına nasıl uyarı verilir?
• SDK'yı test gereksinimlerinize uyacak şekilde nasıl özelleştirebilirsiniz?

Neye ihtiyacın olacak

• Android Studio sürüm 3.4+.
• Basit kod.
• Android 2.3+ ve Google Play hizmetleri 9.8 veya üzeri olan bir test cihazı veya Google Play hizmetleri 9.8 veya üzeri olan bir Emulator.
• Bir cihaz kullanıyorsanız, bir bağlantı kablosu.

2. Örnek kodu alın

GitHub deposunu komut satırından klonlayı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 ( ) örnek kod indirmesinden ( Dosya > Aç > .../codelab-appdistribution-android/start).

Artık Android Studio'da başlangıç ​​projesini açmış olmalısınız.

4. Bir Firebase konsol projesi oluşturun

Yeni bir Firebase projesi ekleyin

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

Bu proje için Google Analytics'i etkinleştirmeniz gerekmez.

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

Firebase'e uygulama ekleyin

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ı almak 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 (bunlar sizin için build-android-start projesinde zaten yapılmıştır).

Firebase uygulamanızla eşleşmesi için Uygulama Kimliğini güncelleyin

1. Sol 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 ).
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 kullanılabilir olduğundan emin olmak için, Android Studio araç çubuğundan Dosya > Projeyi Gradle Dosyalarıyla Eşitle'yi seçerek projenizi Gradle dosyalarıyla eşitleyin.

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

Bu adımda, uygulamanıza Firebase App Distribution Android SDK'sını ekleyecek ve uygulamanızın yeni sürümleri yüklenebildiğinde testçilerinize 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 üst kısımdaki açılır menüden doğru projeyi seçmeniz gerekiyor.

Uygulama içi uyarıları yapılandırın

App Distribution Android SDK, testçileriniz için uygulama içi derleme uyarıları ayarlamanın iki yolunu sunar:

• Test kullanıcılarına görüntülenmesi için önceden oluşturulmuş bir iletişim kutusuyla birlikte gelen temel bir uyarı yapılandırması.
• Kullanıcı arabiriminizi (UI) özelleştirmenizi sağlayan 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 etkinleştirme uyarıları iletişim kutusu görüntülemek için updateIfNewReleaseAvailable kullanabilir ve ardından yeni bir yapı olup olmadığını kontrol edebilirsiniz. Test kullanıcıları, App Distribution'da uygulamaya erişimi olan bir hesapta oturum açarak uyarıları etkinleştirir. Çağrıldığında, yöntem aşağıdaki sırayı uygular:

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

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

2. Test cihazının yüklemesi için yeni kullanılabilir yapıları kontrol eder.
3. Test cihazından en son sürümü indirmesini isteyen önceden oluşturulmuş bir uyarı görüntüler.
4. Güncellemeye devam etmeden önce yeni yapı türünü kontrol eder:
5. Yeni yapı bir App Bundle (AAB) ise, güncelleme işlemini tamamlamak için test kullanıcısını Play Store'a yönlendirir.
6. Yeni yapı bir APK ise, SDK arka planda yeni yapıyı indirir ve indirme tamamlandığında test kullanıcısı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, updateIfNewReleaseAvailable() onResume() öğesini çağırabilirsiniz:

MainActivity.kt dosyasını açın ve şu şekilde onResume() yöntemini 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ı oluşturun ve uygulamanızı indirmeye davet edin

Bu adımda, uygulamanızı derlersiniz ve yapıyı Firebase konsolunu kullanarak test kullanıcılarına dağıtarak uygulamanızı 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 işleminizi 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.

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

4. Uygulamanızın APK dosyasını yüklemek için konsola sürükleyin.
5. Yükleme tamamlandığında, derlemeyi almak istediğiniz test kullanıcı gruplarını ve bireysel test kullanıcılarını belirtin. (Daveti almak için e-postanızı ekleyin.) Ardından, yapı için sürüm notları ekleyin. Test kullanıcısı grupları oluşturma hakkında daha fazla bilgi edinmek için Test kullanıcıları ekleme ve kaldırma bölümüne bakın.

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

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

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 kullanıcısısınız! Test cihazınızda test kullanıcısı olarak kurulum yapmak için Daveti kabul edin bölümündeki talimatları izleyin.

Daveti kabul etmek

Sürümü indirmek ve test etmek için önce 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 App Distribution 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.

Sürümü test cihazından indirin

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

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

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

Uygulamaya döndürülürsünüz. Uygulamayı bir sonraki çalıştırışınızda oturum açmanız veya uyarıları kabul etmeniz gerekmez

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'unuzu 2 olarak güncelleyin.
2. Normal işleminizi kullanarak APK'nızı 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.

Test oluşturma uyarıları

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

4. En son sürümü almak için Güncelle'yi tıklayın.
5. İstenirse, bilinmeyen kaynaklardan yüklemeleri etkinleştirme seçeneğini belirleyin.
6. Sonraki ekranda Yükle (veya Güncelle ) öğesini tıklayın.

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

7. Test kullanıcısının oturum açmasını özelleştirin

SignInTester/signOutTester ve isTesterSignedIn yöntemleri, test cihazınızın oturum açma deneyimini özelleştirerek size daha fazla esneklik sağlar, böylece uygulamanızın görünümü ve hissi ile daha iyi eşleşebilir.

Aşağıdaki örnek, test kullanıcısının Firebase App Distribution 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, test cihazının yeni bir yapıya erişimi olup olmadığını kontrol etmek için checkForUpdate'i arayın.

CheckForUpdate () çağrısını yorumlayarak onResume'da güncellemeleri otomatik olarak kontrol etmeyi devre dışı bırakalım.

MainActivity.kt

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

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

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

MainActivity.kt

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

Son olarak isTesterSignedIn yöntemini 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'yı kullanarak bir uygulamaya "uygulama içi uyarı görüntüleme" özelliğini yerleştirdiniz.

Neyi kapsadık

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

Sonraki adımlar

• Fastlane eklentisini kullanma
• CLI araçlarını kullanma
• Gradle'ı kullanma

Daha fazla bilgi edin

• Firebase.google.com

Sorunuz mu var?

• Stackoverflow 'firebase-app-dağıtım '
• Firebase topluluğu gevşek kanalı #app-distribution

Sorunları Bildir

• Github Sorunları