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.
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 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
- Firebase konsolunu açın.
- Proje Ekle öğesini seçin ve ardından projenize "Firebase Codelab" adını verin.
Bu proje için Google Analytics'i etkinleştirmeniz gerekmez.
- 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:
- Firebase Android yapılandırma dosyanızı almak için google-services.json'u İndir'i tıklayın.
- google-services.json dosyasını projenizdeki
app
dizinine 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).
Firebase uygulamanızla eşleşmesi için Uygulama Kimliğini güncelleyin
- 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
). -
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:
- 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.
- 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 yapı türünü kontrol eder:
- Yeni yapı bir App Bundle (AAB) ise, güncelleme işlemini tamamlamak için test kullanıcısını Play Store'a yönlendirir.
- 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 bironProgressUpdate
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:
- 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
- Uygulamanızın APK dosyasını yüklemek için konsola sürükleyin.
- 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.
- 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.
- 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 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.
- İndir'e dokunun, ardından uygulamayı yükleyin 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 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
- Modül (uygulama düzeyi) Gradle dosyanızda (genellikle app/build.gradle) versionName'inizi "1.1" ve versionCode'unuzu 2 olarak güncelleyin.
- 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.
- 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.
- Sonraki ekranda Yükle (veya Güncelle ) öğesini tıklayın.
- 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
Daha fazla bilgi edin
Sorunuz mu var?
Sorunları Bildir