Bu sayfa, sorun giderme yardımı sağlar ve Uygulama Dağıtımı ile uygulamaların dağıtılması ve test edilmesi hakkında sık sorulan soruların yanıtlarını sağlar.
Uygulamaları dağıtma
Uygulamaları test cihazlarınıza dağıtırken karşılaşabileceğiniz sorunları gidermek için aşağıdaki ipuçlarını kullanın.
Bir uygulama 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 konsolunda Uygulama Dağıtımı'nı ziyaret edin."
Varsa, Firebase konsolunda bir İletişim E-postası ayarlayın. Sorun devam ederse Firebase Destek ile iletişime geçin.
Sağlama sırasında sürekli olarak 400, 409 veya 500 hatalarıyla karşılaşırsanız Firebase Destek 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ı, 2 GB'ın biraz üzerinde olan 2048 MiB'dir.
APK boyutu, dosya boyutu sınırı içindeyse ve yeniden üretilebilirse Firebase Destek ile iletişime geçin.
APK'nın aşağıdakileri kullanarak 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
App Distribution'a bir AAB yüklediğinizde Google Play, bir test uygulaması imzalama anahtarı sertifikası kullanarak oluşturulan APK'dan otomatik olarak istifa eder. İstendiğinde, üçüncü taraf hizmetlerini kullanmaya devam etmek istiyorsanız uygulamanızı API sağlayıcılarına kaydettirmeniz gerekir. İmzalandıktan sonra, uygulamanızın test sertifikası Firebase konsolunda görüntülenebilir.
App Distribution'a 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ükleyemez ve App Distribution'ın Google Play entegrasyonu aracılığıyla Google Play'e aktaramazsınız.
Mevcut derlemeler, Firebase Uygulama Dağıtımı kontrol panelinde ve test kullanıcılarınız tarafından kullanılabilir olmaya devam edecek.
Daha önce Firebase ile Google Play arasında dışa aktarılan tüm veriler her iki üründe de erişilebilir durumda kalacaktır.
App Distribution aracılığıyla bir Android App Bundle (AAB) 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ıdır. Bu, hem Firebase Android uygulamanıza hem de Google Play uygulamanıza sahip olduğunuz anlamına gelir.
Google Play'deki uygulama ve Firebase Android uygulaması, aynı paket adı kullanılarak kaydedilir.
Google Play'deki uygulama , uygulama kontrol panelinde kurulur ve Google Play kanalları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ınlanmıştır: Dahili test (Taslak dahili testi değil), Kapalı test, Açık test veya Üretim.
Daha önce yukarıda listelenen bağlantı ölçütlerini karşılamayan bir uygulama yüklediyseniz, ancak şimdi karşılıyorsa, 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ı bir Google hesabı oluşturduğunda, otomatik olarak bir Gmail adresi alır.
Bir 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 hesaba Gmail olmayan bir e-posta adresi bağlamasını ve oturum açmak için bu e-postayı kullanmasını isteyin.
Alternatif bir e-posta seçerken, test kullanıcısı şu yönergeleri izlemelidir:
- 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 bkz. Başka bir e-posta adresiyle Google Hesabınızda oturum açın .
Testi yapan kişi e-posta davetini, davetin gönderildiği adresten farklı bir e-posta adresiyle kabul ederse, doğru uygulamaları veya derlemeleri göremeyebilir.
Geliştiricinin davetiye gönderdiği ve yeni yapılara eklediği e-posta (E-posta A), test cihazı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, aslında erişim elde eden 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 cihazını silin. Mevcut davetler kaldırılır.
Uygulamanızı test etmesi için test kullanıcısını yeniden davet edin. Test kullanıcısı bir davet e-postası almalıdır.
Test kullanıcısının daveti aynı e-posta adresiyle kabul ettiğinden emin olun.
Aşağıdakilerden biri gerçekleşirse test kullanıcıları e-posta bildirimleri 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 kabul etti. Test kullanıcısı, davetiyenin orijinal olarak gönderildiği e-posta hesabı için yeni sürüm e-postaları alır.
Testi yapan kişi daha önce davet edilmiş ancak ilk daveti kabul etmemiştir. Test kullanıcısı sonraki yayınlara eklenirse, test kullanıcısı ilk daveti kabul etmediği için Uygulama Dağıtımı bu test kullanıcısına otomatik olarak sürüm bildirimleri göndermez.
Çözüm 1
Testi yapan kişiden spam klasörlerini ve e-posta hizmetlerinde ayarladıkları e-posta filtrelerini kontrol etmesini isteyin.
Test kullanıcısının e-posta aboneliğinden çıkması durumunda, test uzmanından aşağıdakileri yapmasını isteyin:
- Test kullanıcısının daha önce uygulamadan aldığı bir e-posta bulun.
- En alttaki E-posta ayarlarını yönet'e tıklayın ve E-postaların yeniden abone olmasına izin ver'e tıklayın.
Çözüm 2
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 cihazını silin. Bu eylem, mevcut davetleri kaldırır.
Uygulamanızı test etmesi için test kullanıcısını yeniden davet edin. Test kullanıcısı bir davet e-postası almalıdır. 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ı arabirimi 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 Google Play dışında uygulama yükleme izni henüz 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 öncesi : Ayarlar uygulamasında Güvenlik'e dokunun ve Bilinmeyen kaynaklar öğesini seçin. İstem göründüğünde, Tamam > Güven'e dokunun.
Bir test APK'sı test cihazı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 eşleşirse güncellenmesine izin verir. Daha fazla bilgi 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
kontrol edin).
App Tester uygulaması oturum açmanızı engelliyor ve sizi tekrar oturum açma ekranına yönlendiriyorsa kısıtlama ayarları içeren bir Google Workspace (eski adıyla G Suite) 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ıtlanmadığından emin olun.
Ayarlar kaldırıldıktan sonra tekrar oturum açmayı deneyin.
Bu hata, yüklenen uygulama cihazda zaten yüklü olan bir uygulamayla çakıştığında meydana gelebilir. Örneğin, aynı uygulamanın aynı özel izne veya ContentProvider adına sahip farklı bir çeşidi olabilir.
Testi yapan kişiden, sorunu yaşadıktan hemen sonra bir hata raporu toplamasını isteyebilir ve sorunun nedeni hakkında daha fazla bilgi için raporu inceleyebilirsiniz. Yeni uygulamanın yüklenebilmesi için önce test cihazının tüm çakışan uygulamaları silmesi gerekir.
Bir 403 hatasıyla karşılaştığınızda bu, kullandığınız hesabın uygulama yükleme ve test etme iznine sahip olmadığı anlamına gelir. Erişim, hesabınızın Google Workspace'teki alan adının yöneticisi tarafından belirlenir.
Uygulama 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ı izlemelidir.
Birden fazla hesabınız varsa, uygulamaları yüklemek ve test etmekle sınırlı olmayan farklı bir hesapla oturum açmayı deneyin.
İlk kez test kullanıcısıysanız Test kullanıcısı olarak ayarlama bölümüne bakın.
Mevcut bir Uygulama Dağıtımı test kullanıcısıysanız ve test etmek için yeni bir Android cihaz alırsanız, yeni test kullanıcısı 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 kısmındaki Download App Tester 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 App Distribution Android SDK kullanılarak uygulama içi geri bildirim gönderilmesiyle ilgili sorunları gidermek için aşağıdaki ipuçlarını kullanın.
Uygulamanızda Uygulama Dağıtımı Android SDK'sını zaten uygulama içi geri bildirimi destekleyecek şekilde ayarladıysanız ve test kullanıcılarınız geri bildirim gönderemiyorsa şu adımları izleyin:
Uygulamanızda App Distribution Android SDK için ayrıntılı günlük kaydını etkinleştirin:
adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
"FirebaseAppDistribution" için filtre uygulayarak uygulama günlüklerinizdeki hata mesajlarını kontrol edin.
Test cihazının yüklü sürüme erişimi olduğunu onaylayın:
Günlükler "test kullanıcısının bu kaynağa erişimi 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 almıyorsanız şu adımları izleyin:
Test cihazında, App Tester veya test cihazı web uygulamasını kullanarak Firebase App Distribution'da oturum açın. Uygulamayı test etme davetini kabul ettiğinizde ilk kullandığınız Google hesabını seçtiğinizden emin olun.
Test cihazının sürüme erişimi olduğundan emin olmak için App Tester veya test web uygulamasını kullanarak uygulamayı tekrar yükleyin.
Yine aynı Google hesabıyla oturum açtığınızdan emin olarak geri bildirim göndermeyi deneyin.
Firebase App Testers API'yi etkinleştirdiğinizden emin olun. Daha fazla bilgi için App Distribution Tester API'yi etkinleştirme bölümüne bakın.
Anahtar kısıtlamaları altında, Firebase App Testers API'nin izin verilen API'ler listesine dahil edildiğinden emin olun.
Geri bildirim gönderirken "Geri bildirim gönderecektim, ancak geliştirme modu nedeniyle göndermedim" 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 App Distribution Android SDK için ayrıntılı günlük kaydını etkinleştirin:
adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
"FirebaseAppDistribution" için filtre uygulayarak uygulama günlüklerinizdeki hata mesajlarını kontrol edin.
Uygulamanızda App Distribution Android SDK'yı zaten kurduysanız ve test kullanıcılarınız uygulama içi uyarılar almıyorsa şu adımları izleyin:
Firebase App Distribution API tarafından döndürülen 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 cihazı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 bulunmadığını veya test cihazının erişime sahip olmadığını gösteriyorsa, test cihazınız henüz yeni sürümle ilişkilendirilmemiş olabilir.
Firebase konsolunun Uygulama Dağıtımı kontrol panelinde, test cihazınızın derleme dağıtımınıza dahil edildiğinden ve Kabul Edildi durumunda olduğundan emin olun.
Test cihazı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ı takip etmesini sağlayın:
Test cihazında, App Tester veya test cihazı web uygulaması aracılığıyla Firebase App Distribution'da oturum açın. Uygulamayı test etme davetini kabul ettiğinizde ilk kullandığınız Google hesabını seçmeyi unutmayın.
Yeni uygulama sürümünün App Tester veya tester 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 App Testers API'yi etkinleştirdiğinizden emin olun. Daha fazla bilgi için App Distribution Tester API'yi etkinleştirme bölümüne bakın.
Anahtar kısıtlamaları altında, Firebase App Testers API'nin izin verilen API'ler listesine dahil edildiğinden emin olun.
SharedPreferences'ı genellikle çıkışta temizlerseniz, test cihazınızın durumunu temizliyor olabilirsiniz. Uygulama Dağıtımı, test cihazınızın uygulamada zaten oturum açıp açmadığını gösteren bir işaret depolar. 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:
Bir Firebase projesine maksimum 500 test kullanıcısı ekleyin
Bir Uygulama Dağıtımı grubuna maksimum 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, uygulamayı süresi dolmadan önce test etme davetini kabul etmeleri için 30 günleri vardır. Davetiyenin süresinin dolmasına 5 gün kaldığında, Firebase konsolunda bir sürümde test kullanıcısının yanında 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 gerçekleşirse uygulama sürümleri Uygulama Dağıtımından kaldırılır:
- Uygulama sürümü 150 günden eski.
- 1.000 uygulama yayın sınırı sınırını aştınız ve uygulama sürümü, en son 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 sona erme 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, App Distribution 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ü daha uzun süre kullanılabilir durumda tutmak 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 veya AAB'yi indirin ve sürümü Uygulama Dağıtım panosundan silin. Ardından APK veya AAB'yi App Distribution'a yeni bir yapı olarak yeniden yükleyin.
- Sürümü indirin ve uzun süreli arşivleme için Cloud Storage'a yükleyin.
Uygulama sürümlerinin süresi 150 gün sonra dolar
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 kendi test cihazlarına yükleyen test kullanıcılarına dağıtabilirsiniz.
Sürümün sona erme tarihinden itibaren 30 gün geçmesi durumunda, Firebase App Tester uygulamasında sürümünüzde bir uygulama yayın süresinin 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 yayın sınırına ulaştığında, Uygulama Dağıtımı 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 Destek ile iletişime geçin.
Bir test kullanıcısıysanız, tüm test yapılarınıza tek bir yerden erişmenizi sağlayan bir uygulama olan Firebase App Tester'ı indirmenizi öneririz.
App Distribution test kullanıcısı hesabınızı ve ilişkili verilerini silmek için sırasıyla şu adımları 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 hesap izinlerinizde , Firebase Uygulama Dağıtımından erişimi iptal edin. Önce App Distribution hesabınızı silmeden erişimin iptal edilmesinin, test kullanıcısı hesabınızı veya verilerinizi silmediğini unutmayın.