Bu sayfada, Uygulama Dağıtımı ile uygulamaların dağıtılması ve test edilmesi hakkında sık sorulan soruların yanıtları ve sorun giderme yardımı sağlanmaktadır.
Uygulamaları dağıtma
Uygulamaları test uzmanlarınıza dağıtırken karşılaşabileceğiniz sorunları gidermek için aşağıdaki ipuçlarını kullanın.
Bir uygulamayı yüklerken şu hatayla karşılaşabilirsiniz:
" <app-id>
uygulaması için bir iletişim e-postası bulamadık. Bir tane ayarlamak için lütfen Firebase konsolundaki Uygulama Dağıtımı'nı ziyaret edin."
Varsa, Firebase konsolunda bir İletişim E-postası ayarlayın. Sorun devam ederse Firebase Desteği ile iletişime geçin.
Temel hazırlık sırasında sürekli olarak 400, 409 veya 500 hatalarıyla karşılaşırsanız Firebase Desteği ile iletişime geçin. Firebase proje numaranız ve uygulama tanımlayıcınızla Destek sağlayın.
APK'nın boyutunu doğrulayın. Tüm ikili dosyalar için maksimum dosya boyutu sınırı 2048 MiB'dir, bu da 2 GB'nin biraz üzerindedir.
APK boyutu dosya boyutu sınırı dahilindeyse ve tekrarlanabilirse Firebase Desteği ile iletişime geçin.
Aşağıdakileri kullanarak APK'nın imzalandığını doğrulayın:
apksigner verify --verbose ~/app-distro/app-distro-apps/[path_name]/app/ build/outputs/apk/debug/app-debug.apk
Android Uygulama Paketlerini (AAB'ler) Dağıtma
Uygulama Dağıtımına bir AAB yüklediğinizde Google Play, bir test uygulaması imzalama anahtarı sertifikası kullanarak oluşturulan APK'yı otomatik olarak iptal eder. İstendiğinde, üçüncü taraf hizmetlerini kullanmaya devam etmek istiyorsanız uygulamanızı API sağlayıcılarına kaydetmeniz gerekir. İmzalandıktan sonra uygulamanızın test sertifikası Firebase konsolunda görüntülenebilir.
Uygulama Dağıtımına yüklediğiniz AAB derlemeleri Google Play geliştirici hesabınızda görünmez (buna App Bundle Explorer ve dahili uygulama paylaşımı dahildir).
Bir Firebase Android Uygulamasının Google Play ile bağlantısı kaldırılırsa aşağıdakiler gerçekleşir:
Yeni uygulama paketlerini App Distribution'a yükleyemeyecek ve bunları Google Play ile App Distribution entegrasyonu yoluyla Google Play'e aktaramayacaksınız.
Mevcut derlemeler Firebase Uygulama Dağıtımı kontrol panelinde ve test kullanıcılarınıza sunulmaya devam edecektir.
Firebase ile Google Play arasında daha önce dışa aktarılan tüm verilere her iki üründen de erişilebilecek.
Bir Android App Bundle'ı (AAB) Uygulama Dağıtımı aracılığıyla dağıtmak ve yüklenen AAB'leri hem Firebase projenize hem de Google Play geliştirici hesabınıza otomatik olarak bağlamak için aşağıdaki gereksinimleri karşıladığınızdan emin olun:
Google Play geliştirici hesabınız şu erişim düzeylerinden birine sahiptir: Sahip veya Yönetici.
Firebase projeniz için şu rollerden birine sahipsiniz: Sahip veya Firebase Yöneticisi .
Uygulamanız Firebase'e ve Google Play geliştirici hesabınıza kayıtlı. Bu, hem Firebase Android uygulamasına hem de Google Play uygulamasına sahip olduğunuz anlamına gelir.
Google Play'deki uygulama ve Firebase Android uygulaması aynı paket adı kullanılarak kaydedilmiştir.
Google Play'deki uygulama , uygulama kontrol panelinde kurulur ve Google Play parçalarından birine (Dahili test, Kapalı test, Açık test veya Üretim) dağıtılır.
Uygulamanın Google Play'deki incelemesi tamamlandı ve uygulama yayınlandı. Uygulama durumu sütununda şu durumlardan biri görüntüleniyorsa uygulamanız yayınlanır: Dahili test (Taslak dahili test değil), Kapalı test, Açık test veya Üretim.
Daha önce yukarıda bağlantı için listelenen kriterleri karşılamayan ancak şimdi karşılayan bir uygulama yüklediyseniz Firebase Android Uygulamanızı Google Play'e bağlamayı yeniden deneyebilirsiniz.
Uygulamaları yükleme ve test etme
Test kullanıcılarınızın uygulamalarınızı yükleyip test ederken karşılaşabilecekleri sorunları gidermek için aşağıdaki ipuçlarını kullanın.
Bir kullanıcı Google hesabı oluşturduğunda otomatik olarak bir Gmail adresi alır.
Test kullanıcısının Google Workspace veya Gmail adresi yoksa veya oturum açmak için başka bir e-posta adresi kullanmayı tercih ediyorsa, test cihazından Gmail dışı bir e-posta adresini hesaba bağlamasını ve oturum açmak için bu e-posta adresini kullanmasını isteyin.
Alternatif bir e-posta seçerken test uzmanının şu yönergeleri izlemesi gerekir:
- Gmail adresi kullanmayın.
- Halihazırda başka bir Google hesabına bağlı olan bir e-posta adresini kullanmayın.
- Bu e-posta adresiyle oturum açarken Google Hesabı şifrenizi kullanmayı unutmayın.
Daha fazla bilgi için Başka bir e-posta adresiyle Google Hesabınızda oturum açma konusuna bakın.
Test kullanıcısı, e-posta davetiyesini davetin gönderildiği adresten farklı bir e-posta adresiyle kabul ederse doğru uygulamaları veya yapıları göremeyebilir.
Geliştiricinin yeni yapılara davetiye gönderdiği ve eklediği e-posta (E-posta A), test kullanıcısının daveti kabul etmek için kullandığı e-postadan (E-posta B) farklı olabilir. Bu, perde arkasında bir bağlantı oluşturur. Yeni yapılara E-posta A eklendiğinde, erişim sağlayan aslında E-posta B'dir.
Test kullanıcısı e-posta davetini farklı bir e-posta adresiyle kabul ettiyse sorunu çözmek için şu adımları izleyin:
Firebase konsolunun Uygulama Dağıtımı sayfasındaki Test Kullanıcıları ve Gruplar sekmesinin Tüm test kullanıcılarını görüntüle bölümünden test kullanıcısını silin. Mevcut davetiyeler kaldırıldı.
Uygulamanızı test etmesi için test kullanıcısını yeniden davet edin. Testi yapan kişinin bir davet e-postası alması gerekir.
Test kullanıcısının daveti aynı e-posta adresiyle kabul ettiğinden emin olun.
Aşağıdakilerden biri meydana gelirse test kullanıcıları e-posta bildirimi alamayabilir:
E-posta bildirimleri spam klasörlerine gönderilir.
E-posta filtreleri ayarlandı.
Davet bir e-posta hesabına gönderildi ancak test kullanıcısı farklı bir e-posta hesabıyla daveti kabul etti. Test kullanıcısı, davetiyenin ilk gönderildiği e-posta hesabının yeni sürüm e-postalarını alır.
Testi yapan kişi daha önce davet edilmişti ancak ilk daveti kabul etmemişti. Test kullanıcısı sonraki sürümlere eklenirse, test kullanıcısı ilk daveti kabul etmediği için Uygulama Dağıtımı otomatik olarak bu test kullanıcısına sürüm bildirimleri göndermez.
Çözüm 1
Testi yapan kişiden spam klasörünü ve e-posta hizmetlerinde ayarladıkları e-posta filtrelerini kontrol etmesini isteyin.
Test uzmanı e-posta aboneliğinden çıktıysa test cihazından aşağıdakileri yapmasını isteyin:
- Test kullanıcısının daha önce uygulamadan aldığı bir e-postayı bulun.
- Alt kısımdaki E-posta ayarlarını yönet'e ve ardından E-postaların yeniden abone olmasına izin ver'e tıklayın.
Çözüm 2
Test cihazı e-posta bildirimleri istemiyor ancak uygulama davetlerini kabul edebilmek istiyorsa, bekleyen uygulama davetlerini doğrudan Uygulama Test Cihazı uygulamasında görüntüleyebilir ( indirme talimatları ).
Çözüm 3
Firebase konsolundaki Uygulama Dağıtımı sayfasındaki Test Kullanıcıları ve Gruplar sekmesinin Tüm test kullanıcılarını görüntüle bölümünden test kullanıcısını silin. Bu işlem mevcut davetiyeleri kaldırır.
Uygulamanızı test etmesi için test kullanıcısını yeniden davet edin. Testi yapan kişinin bir davet e-postası alması gerekir. Test kullanıcısının daveti, davetin gönderildiği e-posta adresiyle kabul ettiğinden emin olun.
Test kullanıcısı bir sürümü indirip yüklerse ancak uygulama ayrıntıları kullanıcı arayüzü uygulamanın yüklü olduğunu göstermiyorsa bu bilinen bir sorundur. Bazı durumlarda Firebase uygulamasındaki paket kimliği, APK'nın paket kimliğiyle eşleşmez.
APK'nın paket kimliğinin, dağıtımı yüklemek için kullandığınız Firebase uygulamasının paket kimliğiyle eşleştiğini doğrulayın.
Çalışan uygulamanıza veya tarayıcınıza henüz Google Play dışında uygulama yükleme izni verilmediyse Android uyarısı görünür. İzin vermek için:
Android sürüm 8 veya üzeri : Ayarlar uygulamasında Bu kaynaktan izin ver'e dokunun.
Android sürümü 7 veya önceki sürümler : Ayarlar uygulamasında Güvenlik'e dokunun ve Bilinmeyen kaynaklar'ı seçin. İstem göründüğünde Tamam > Güven öğesine dokunun.
Test APK'sı test kullanıcısının cihazına yüklenemezse:
- Yeni sürümdeki sertifikaların, test cihazının cihazında yüklü olan sürümdekilerle eşleştiğini doğrulayın. Android sistemi uygulamanın yalnızca sertifikaların eşleşmesi durumunda güncellenmesine izin verir. Daha fazla bilgi edinmek için bkz . İmzalamayla ilgili hususlar .
- Test cihazının işletim sistemi sürümünün uygulama tarafından desteklendiğinden emin olun (
minSdkVersion
öğesini kontrol edin).
Uygulama Test Aracı uygulaması oturum açmanızı engelliyor ve oturum açma ekranına geri yönlendiriyorsa kısıtlama ayarlarını içeren bir Google Workspace (eski adıyla GSuite) kullanıyor olabilirsiniz.
Kısıtlama ayarlarınızı kaldırmak için:
Google Workspace'inizin Uygulamalar sekmesinde Firebase Uygulama Dağıtımı'nın Erişim: Engellendi olarak ayarlanmadığından emin olun.
Hizmetler sekmesinde Bulut Platformunun kısıtlamasız olduğundan emin olun.
Ayarlar kaldırıldıktan sonra tekrar oturum açmayı deneyin.
Bu hata, yüklenmekte olan uygulamanın cihazda önceden yüklü olan bir uygulamayla çakışması durumunda ortaya çıkabilir. Örneğin, aynı uygulamanın aynı özel izne veya ContentProvider adına sahip farklı bir çeşidi olabilir.
Test uzmanından, sorunu yaşadıktan hemen sonra bir hata raporu almasını isteyebilir ve bunun nedeni hakkında daha fazla bilgi için raporu inceleyebilirsiniz. Yeni uygulamanın kurulabilmesi için test cihazının çakışan uygulamaları silmesi gerekir.
403 hatasıyla karşılaştığınızda bu, kullandığınız hesabın uygulamaları yükleme ve test etme izninin olmadığı anlamına gelir. Erişim, Google Workspace'te hesabınızın alan adının yöneticisi tarafından belirlenir.
Uygulamaları yükleme ve test etme izninizin olması gerektiğini düşünüyorsanız Google Workspace hesap yöneticinizden hesap ayarlarınızı değiştirmesini isteyin. Yöneticiniz , Bireysel olarak kontrol edilmeyen hizmetlere erişimi yönetme bölümündeki talimatları uygulamalıdır.
Birden fazla hesabınız varsa uygulamaları yükleme ve test etme kısıtlaması olmayan farklı bir hesapla oturum açmayı deneyin.
İlk kez test kullanıcısıysanız Test kullanıcısı olarak kuruluma bakın.
Mevcut bir Uygulama Dağıtımı test kullanıcısıysanız ve test etmek için yeni bir Android cihazı aldıysanız, yeni test cihazı akışının tamamını tekrar gözden geçirmek yerine şu adımları izleyin:
Android cihazınızda appdistribution.firebase.google.com adresine gidin.
Mevcut test kullanıcısı hesabınızla oturum açın ve Android App Tester uygulamasını yüklemek için ekranın altındaki Uygulama Test Cihazını İndir düğmesini tıklayın.
App Distribution Android SDK ile test cihazı özelliklerini etkinleştirme
Uygulama içi yeni derleme uyarılarının etkinleştirilmesi veya Uygulama Dağıtımı Android SDK'sını kullanarak uygulama içi geri bildirim gönderilmesiyle ilgili sorunları gidermek için aşağıdaki ipuçlarını kullanın.
Uygulama içi geri bildirimi desteklemek için uygulamanızda Uygulama Dağıtımı Android SDK'sını zaten ayarladıysanız ve test kullanıcılarınız geri bildirim gönderemiyorsa şu adımları izleyin:
Uygulamanızda Uygulama Dağıtımı Android SDK'sı için ayrıntılı günlük kaydını etkinleştirin:
adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
"FirebaseAppDistribution" filtresini kullanarak uygulama günlüklerinizdeki hata mesajlarını kontrol edin.
Test cihazının yüklü sürüme erişimi olduğunu doğrulayın:
Günlükler "test kullanıcısının bu kaynağa erişiminin olmadığını" gösteriyorsa test kullanıcınız uygulamaya davet edilmemiş veya sürüme erişimi olmayabilir.
Firebase konsolunun Uygulama Dağıtımı kontrol panelinde, test kullanıcısının cihazında çalışan tam sürümü bulun ve test kullanıcısının sürüm kartındaki Test Kullanıcıları sekmesinde listelendiğinden ve Kabul Edildi durumunda olduğundan emin olun.
Hâlâ geri bildirim alamıyorsanız şu adımları izleyin:
Test cihazında, Uygulama Test Aracı'nı veya test cihazı web uygulamasını kullanarak Firebase Uygulama Dağıtımı'nda oturum açın. Uygulamayı test etmek için daveti kabul ettiğinizde ilk kullandığınız Google hesabını seçtiğinizden emin olun.
Test kullanıcısının sürüme erişebildiğinden emin olmak için Uygulama Test Aracı'nı veya test web uygulamasını kullanarak uygulamayı tekrar yükleyin.
Aynı Google hesabıyla oturum açtığınızdan emin olarak geri bildirim göndermeyi deneyin.
Firebase Uygulama Test Cihazları API'sini etkinleştirdiğinizden emin olun. Daha fazla bilgi için bkz. Uygulama Dağıtımı Test Aracı API'sini Etkinleştirme .
Anahtar kısıtlamaları altında, Firebase Uygulama Test Cihazları API'sinin izin verilen API'ler listesine dahil edildiğinden emin olun.
Geri bildirim gönderirken "Geri bildirim gönderilirdi ancak geliştirme modu nedeniyle gönderilmedi" mesajını görürseniz şu komutu çalıştırarak cihazda geliştirici modunu devre dışı bırakın:
adb shell setprop debug.firebase.appdistro.devmode false
Doğru proje ve uygulama için geri bildirim gönderdiğinizden emin olmak için
google-services.json
dosyanızı kontrol edin.Uygulamanızda Uygulama Dağıtımı Android SDK'sı için ayrıntılı günlük kaydını etkinleştirin:
adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
"FirebaseAppDistribution" filtresini kullanarak uygulama günlüklerinizdeki hata mesajlarını kontrol edin.
Uygulamanızda Uygulama Dağıtımı Android SDK'sını zaten kurduysanız ve test kullanıcılarınız uygulama içi uyarı almıyorsa şu adımları izleyin:
Firebase Uygulama Dağıtımı API'sinin döndürdüğü Göreve bir
OnFailureListener
ekleyerek hata mesajlarını kontrol edin.Java
firebaseAppDistribution.updateIfNewReleaseAvailable().addOnFailureListener ( e -> { if (e instanceof FirebaseAppDistributionException) { // Log exception here }});
Kotlin
firebaseAppDistribution.updateIfNewReleaseAvailable().addOnFailureListener { e -> if (e is FirebaseAppDistributionException) { // Log exception here } }
Test kullanıcısının yeni sürüme erişimi olup olmadığını kontrol edin:
Uygulamanızda hata ayıklama modunu etkinleştirin. Nasıl yapılacağını öğrenmek için Google Analytics belgelerine bakın.
Uygulamanızı bir simülatörde çalıştırın ve "FirebaseAppDistribution" dizesini arayın.
Günlükler herhangi bir sürümün bulunamadığını veya test kullanıcısının erişiminin olmadığını gösteriyorsa test uzmanınız henüz yeni sürümle ilişkilendirilmemiş olabilir.
Firebase konsolunun Uygulama Dağıtımı kontrol panelinde, test kullanıcınızın derleme dağıtımınıza dahil edildiğinden ve Kabul Edildi durumunda olduğundan emin olun.
Test kullanıcınız hâlâ uyarı almıyorsa uygulamanızı test etme davetini kabul ettiğinden ve test cihazını doğru şekilde kurduğundan emin olmak için aşağıdaki ipuçlarını uygulamasını sağlayın:
Test cihazında, Uygulama Test Aracı veya test cihazının web uygulaması aracılığıyla Firebase Uygulama Dağıtımı'nda oturum açın. Uygulamayı test etmek için daveti kabul ettiğinizde ilk kullandığınız Google hesabını seçmeyi unutmayın.
Yeni uygulama sürümünün Uygulama Test Aracı'nda veya test cihazı web uygulamasında mevcut olduğundan emin olmak için kontrol edin.
Varsayılan olarak, test kullanıcılarınızın test özelliklerini etkinleştirmek için Google hesaplarında yalnızca bir kez oturum açmaları gerekir. Uygulamanızı kapatıp yeniden açtıktan sonra test kullanıcılarınızdan tekrar oturum açmaları istenirse Uygulama Dağıtımı yapılandırmanızın doğru şekilde ayarlandığından emin olmak için şu ipuçlarını izleyin:
Firebase Uygulama Test Cihazları API'sini etkinleştirdiğinizden emin olmak için kontrol edin. Daha fazla bilgi için bkz. Uygulama Dağıtımı Test Aracı API'sini Etkinleştirme .
Anahtar kısıtlamaları altında, Firebase Uygulama Test Cihazları API'sinin izin verilen API'ler listesine dahil edildiğinden emin olun.
Oturumu kapattığınızda genellikle SharedPreferences'ı temizliyorsanız, test kullanıcınızın durumunu temizliyor olabilirsiniz. Uygulama Dağıtımı, test kullanıcınızın uygulamada zaten oturum açıp açmadığını gösteren bir işaret saklar. Daha fazla bilgi için GitHub deposuna bakın.
Sıkça Sorulan Sorular
Firebase App Distribution aşağıdaki test kullanıcısı sınırlarına sahiptir:
Firebase projesine maksimum 500 test kullanıcısı ekleyin
Bir Uygulama Dağıtımı grubuna en fazla 200 test kullanıcısı ekleyin
Daha fazla test kullanıcısı eklemek için ücretsiz limit artışı talep edin.
Test kullanıcılarının, süresi dolmadan uygulamayı test etme davetini kabul etmek için 30 günü vardır. Davetiyenin süresinin dolmasına 5 gün kaldığında, Firebase konsolunda test kullanıcısının yanında sürümde bir süre sonu bildirimi görünür. Bir davet, test kullanıcısı satırındaki açılır menü aracılığıyla yeniden gönderilerek yenilenebilir.
Aşağıdaki koşullardan biri meydana gelirse uygulama sürümleri Uygulama Dağıtımından kaldırılır:
- Uygulamanın sürümü 150 günden daha eski.
- 1.000 uygulama sürümü sınırını aştınız ve uygulama sürümü, en yeni 1.000 uygulama sürümünden daha eski.
Daha fazla bilgi için bkz. Uygulama Dağıtımı maksimum 1.000 sürümü destekler .
Uygulama 150 günlük son kullanma sınırına veya 1.000 sürüm sınırına ulaştıktan veya bu sınırı aştıktan sonra sürüm, Uygulama Dağıtımı kontrol panelinden ve Firebase App Tester uygulamasından kaldırılır. Test cihazınız sürümü yüklediyse uygulamanın yerel sürümü çalışmaya devam eder.
Uygulama sürümünün daha uzun süre kullanılabilir kalmasını sağlamak için aşağıdaki önerilerden birini kullanın:
- Uygulama sürümünün süresi dolmadan veya sürüm sınırını aşmadan önce, APK'yı veya AAB'yi indirin ve sürümü Uygulama Dağıtımı kontrol panelinden silin. Ardından APK veya AAB'yi yeni bir yapı olarak App Distribution'a yeniden yükleyin.
- Sürümü indirin ve uzun vadeli arşivleme için Cloud Storage'a yükleyin.
Uygulama sürümlerinin süresi 150 gün sonra doluyor
Uygulamanızın bir sürümünü Firebase'e yüklediğinizde sürüm, yükleme tarihinden itibaren 150 gün boyunca Uygulama Dağıtımı kontrol panelinde görünür. Sürümü yükledikten sonra, sürümü Firebase App Tester uygulamasından test cihazlarına yükleyen test kullanıcılarına dağıtabilirsiniz.
Sürümün sona erme tarihinden itibaren 30 gün geçtiğinde, Firebase App Tester uygulamasındaki sürümünüz üzerinde bir uygulama sürümünün sona erme bildirimi görünür.
Uygulama Dağıtımı maksimum 1.000 sürümü destekler
Uygulama Dağıtımı, uygulama başına maksimum 1.000 sürüme izin verir. Uygulamanız 1.000 uygulama sürümü sınırına ulaştığında App Distribution, sınırın üzerindeki en eski sürümleri otomatik olarak siler.
Uygulama sürümlerinizi manuel olarak yönetmek istiyorsanız uygulama sürümlerini toplu olarak listelemek ve silmek için Uygulama Dağıtımı REST API'sini kullanın.
Sorularınız varsa Firebase Desteği ile iletişime geçin.
Test kullanıcısıysanız, tüm test derlemelerinize tek bir yerden erişmenizi sağlayan bir uygulama olan Firebase App Tester'ı indirmenizi öneririz.
Firebase App Distribution, Firebase Test Lab altyapısını kullanır ve kota limitleri ve fiyatlandırması aynıdır. Test kotaları, günde gerçekleştirilen test sayısına göre ölçülür. Test kotaları ve faturalandırma hakkında daha fazla bilgi edinmek için bkz. Test Lab için kullanım düzeyleri, kotalar ve fiyatlandırma .
Kotayı aşarsanız kota aşıldı hataları alırsınız. Kotaların sıfırlanması yaklaşık 24 saat sürer; bu nedenle kota boşalana kadar yeniden denemekten kaçınmalısınız. Ancak Otomatik test altyapısıyla ilgili hatalar alırsanız hemen yeniden denemeniz durumunda çağrıların başarılı olma olasılığı daha yüksektir.
Otomatik Test Cihazı özelliğiyle testler yürütmek için Firebase projesinde Düzenleyici erişimine sahip olmanız gerekir.
Uygulama Dağıtımı test kullanıcısı hesabınızı ve ilişkili verilerini silmek için aşağıdaki adımları sırasıyla izleyin:
https://appdistribution.firebase.google.com adresini ziyaret edin ve Google hesabınızla oturum açın.
Sağ üstte
tıklayın ( Hesabı yönet )Hesabı sil .
İsteğe bağlı: Google hesabınızın izinlerinde Firebase App Distribution'ın erişimini iptal edin. Önce Uygulama Dağıtımı hesabınızı silmeden erişimi iptal etmenin test kullanıcısı hesabınızı veya verilerinizi silmediğini unutmayın.