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?
Android uygulamaları oluşturma deneyiminizi nasıl değerlendirirsiniz?
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.
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
- Firebase konsolunu açın.
- 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.
- 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:
- Firebase Android yapılandırma dosyanızı edinmek için google-services.json'u indir'i tıklayın.
- google-services.json dosyasını projenizdeki
appdizinine kopyalayın.
- 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
- 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.
-
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:
- 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.
- Test cihazının yüklemesi için yeni kullanılabilir yapıları kontrol eder.
- Test cihazından en son sürümü indirmesini isteyen önceden oluşturulmuş bir uyarı görüntüler.
- Güncellemeye devam etmeden önce yeni derleme türünü kontrol eder:
- Yeni yapı bir App Bundle (AAB) ise, güncelleme işlemini tamamlamak için test cihazını Play Store'a yönlendirir.
- 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.
updateIfNewReleaseAvailableGörevine bir
onProgressUpdateiş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:
- Firebase konsolunun Uygulama Dağıtımı sayfasını açın. İstendiğinde Firebase projenizi seçin.
- Sürümler sayfasında, açılır menüden dağıtmak istediğiniz uygulamayı seçin.
- Başlayın'ı tıklayın
- Yüklemek için uygulamanızın APK dosyasını konsola sürükleyin.
- 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.
- Yapıyı testçilerin kullanımına sunmak için Dağıt'a tıklayın.
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.
- Android test cihazınızda, Firebase App Distribution'dan gönderilen e-postayı açın ve Başlayın'a dokunun.
- 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.
- İndir'e dokunun, ardından uygulamayı kurun ve çalıştırın!
- Uygulama başladığında, yeni derleme uyarılarını etkinleştirmenizi ister. Aç'a dokunun .
- 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
- Modül (uygulama düzeyi) Gradle dosyanızda (genellikle app/build.gradle) versionName'inizi "1.1" ve versionCode'unuzu 2 olarak güncelleyin.
- 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.
- 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ı
- Açıksa uygulamayı kapattığınızdan emin olun.
- Uygulamayı yeniden başlatın.
- Uygulama yeniden başlatıldığında Yeni Sürüm Kullanılabilir uyarısı alırsınız.
- En son sürümü almak için Güncelle'yi tıklayın.
- İstenirse, bilinmeyen kaynaklardan yüklemeleri etkinleştirme seçeneğini belirleyin.
- Bir sonraki ekranda Yükle'ye (veya Güncelle ) tıklayın.
- 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
Daha fazla bilgi edin
Sorunuz mu var?
Sorun Bildir