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

1. Genel Bakış

Firebase Uygulama Dağıtımı SDK'sını Android uygulama kod laboratuvarınıza entegre etme bölümüne hoş geldiniz. Bu kod laboratuvarında, yeni derlemeler indirilebilir olduğunda test kullanıcılarınıza uygulama içi uyarılar göstermek 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 yapı uyarısı 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?
• Uygulama Dağıtımı Android SDK'sını uygulamanıza nasıl entegre edebilirsiniz?
• Yüklemeye hazır yeni bir yayın öncesi yapı olduğunda bir testçi nasıl uyarılır?
• SDK'yı test gereksinimlerinize uyacak şekilde nasıl özelleştirebilirsiniz?

Neye ihtiyacın olacak

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

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

Sadece baştan sona oku Okuyun ve egzersizleri 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 klonlayın.

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

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

"codelab-appdistribution-android" deposu iki klasör içerir:

• start —Bu kod laboratuvarında oluşturacağınız başlangıç ​​kodu.
• final —Bitmiş örnek uygulama için tamamlanan kod.

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

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

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

4. Bir Firebase konsol projesi oluşturun

Yeni bir Firebase projesi ekle

1. Firebase konsolunu açın.
2. Proje Ekle'yi seçin ve ardından projenizi "Firebase Codelab" olarak adlandırın.

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

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

Firebase'e bir uygulama ekleyin

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

Uygulamanıza google-services.json dosyasını 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 indir'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).

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

1. Soldaki menüde (Proje Sekmesi), "Android"de olduğunuzdan emin olun "Gradle Scripts" sekmesini görüntüleyin ve bulun ve modül (uygulama düzeyinde) Gradle dosyanızı (genellikle app/build.gradle.kts ) açın.
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

Tüm bağımlılıkların uygulamanız tarafından kullanılabilir olduğundan emin olmak için Android Studio araç çubuğundan Dosya > Projeyi Gradle Dosyalarıyla Senkronize Et'i 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ı ekleyeceksiniz ve uygulamanızın yeni sürümleri yüklenebilir 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 gerekiyor.

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

App Distribution Android SDK, test cihazlarınız için uygulama içi derleme uyarıları oluşturmanı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ı 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ş olan test kullanıcılarına önceden oluşturulmuş bir uyarıları etkinleştir iletişim kutusunu görüntülemek için updateIfNewReleaseAvailable kullanabilir ve ardından yeni bir yapının mevcut 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. Yöntem çağrıldığında aşağıdaki sırayı gerçekleştirir:

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

Uyarıları etkinleştirmek, test cihazında uygulamanızın güncellemelerinde devam eden tek seferlik bir işlemdir. Uyarılar, uygulama kaldırılana veya signOutTester yöntemi çağrılana kadar test cihazında etkin durumda 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 derleme türünü kontrol eder:
5. Yeni yapı bir App Bundle (AAB) ise, güncelleme işlemini tamamlamak için test cihazını Play Store'a yönlendirir.
6. Yeni yapı bir APK ise, SDK arka planda yeni yapıyı indirir ve indirme 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.

updateIfNewReleaseAvailable() uygulamasını uygulamanızın herhangi bir noktasında arayabilirsiniz. Örneğin, MainActivity'nin onResume() yöntemi sırasında updateIfNewReleaseAvailable() ç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ı indirmeleri için davet edin

Bu adımda, uygulamanızı derler 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 bir 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ız 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. Yüklemek için uygulamanızın APK dosyasını konsola sürükleyin.
5. Yükleme tamamlandığında, yapıyı almak istediğiniz test kullanıcısı 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ını ekleme ve kaldırma bölümüne bakın.

6. Yapıyı testçilerin kullanımına sunmak için Dağıt'a tıklayın.

NOT: Yapınızı dağıttıktan sonra, Firebase konsolunun Uygulama Dağıtım panosunda 150 gün boyunca kullanılabilir hale gelir. Derlemenin süresinin dolmasına 30 gün kala, hem konsolda hem de test cihazınızın test cihazındaki derlemeler listesinde bir son kullanma bildirimi görünür.

Uygulamayı test etmeye davet edilmeyen test kullanıcıları, başlamak için e-posta davetiyeleri alır. Etkin test kullanıcıları, yeni bir derlemenin test edilmeye hazır olduğuna dair e-posta bildirimleri alır. Test uygulamasının nasıl yükleneceği ile ilgili talimatlar için Test cihazı olarak kurulum yapma bölümüne bakın. Daveti kabul edip etmedikleri ve uygulamayı indirip indirmedikleri fark etmeksizin her bir test kullanıcısının durumunu Firebase konsolunda izleyebilirsiniz.

Firebase konsolunda, uygulamanızın sürümü kapsamında 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çi sizsiniz! Test cihazınızda test kullanıcısı olarak ayarlanmak için daveti kabul etme bölümündeki talimatları uygulayın.

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 Uygulama Dağıtımı test cihazı web uygulamasında Google hesabınızla oturum açın ve Davetiyeyi 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ı kurun 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 geri döndü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. APK'nızı normal işleminizi kullanarak oluşturun. APK'yı hata ayıklama anahtarınız 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. Bir sonraki ekranda Yükle'ye (veya Güncelle ) tıklayın.

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

7. Test kullanıcısı oturumunu özelleştirin

SignInTester/signOutTester ve isTesterSignedIn yöntemleri, test cihazınızın oturum açma deneyimini özelleştirme konusunda size daha fazla esneklik sağlar, böylece uygulamanızın görünümüne ve izlenimine daha iyi uyum sağlayabilir.

Aşağıdaki örnek, test kullanıcısının Firebase App Distribution test 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 arayın.

CheckForUpdate() çağrısını yorumlayarak güncellemeleri otomatik olarak onResume'de 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 zaten oturum açmışsa kullanıcının 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 uygulamada "uygulama içi uyarı ekranı" özelliğini oluşturdunuz.

Neleri ele aldık

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

Sonraki adımlar

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

Daha fazla bilgi edin

• Firebase.google.com.tr

Sorunuz mu var?

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

Sorun Bildir

• Github Sorunları