Uygulama Dağıtımı ile ilgili sorunları giderme SSS
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Bu sayfada, App Distribution ile uygulama dağıtma ve test etme hakkında sorun giderme yardımı ve sık sorulan soruların yanıtları yer almaktadır.
Uygulama dağıtma
Uygulamaları test kullanıcılarınıza dağıtırken karşılaşabileceğiniz sorunları gidermek için aşağıdaki ipuçlarını kullanın.
İletişim e-postası eksik olduğu için uygulama dağıtılamıyor
Uygulama yüklerken şu hatayla karşılaşabilirsiniz:
"<app-id> uygulaması için iletişim e-postası bulunamadı. Ödeme profili oluşturmak için lütfen Firebase konsolunda App Distribution sayfasını ziyaret edin."
Varsa Firebase konsolunda bir iletişim e-posta adresi ayarlayın. Sorun devam ederse Firebase Destek Ekibi ile iletişime geçin.
Uygulamanız temel hazırlanırken bir hata oluştu (400, 409 veya 500 hataları)
Temel hazırlık sırasında tekrar tekrar 400, 409 veya 500 hatalarıyla karşılaşırsanız Firebase Destek Ekibi ile iletişime geçin. Destek ekibine Firebase proje numaranızı ve uygulama tanımlayıcınızı gönderin.
IPA yüklenemiyor
Aşağıda, tarayıcı ağ yanıtına dair bir örnek verilmiştir:
{"status":"IN_PROGRESS","message":"There was an error processing yourdistribution.EnsureyouareuploadingavalidIPAorAPKandtryagain."}
Bu sorunu çözmek için aşağıdaki adımları izleyin:
IPA'nın boyutunu doğrulayın. Tüm ikili programlar için maksimum dosya boyutu sınırı 2.048 MiB'dir (2 GB'tan biraz fazla).
IPA boyutu, dosya boyutu sınırları içindeyse ve yeniden oluşturulabiliyorsa aşağıdaki adımları uygulayın:
Info.plist dosyanızı kontrol edin ve CFBundleDisplayName dosyasının <array> ayırıcıları içerip içermediğini onaylayın.
<array> sınırlayıcılarını kaldırıp uygulamanızı yeniden derleyin. Yükleme işlemi başarıyla tamamlanacaktır.
IPA boyutu, dosya boyutu sınırını aşıyorsa dosya boyutunu küçültmek için gerekli değişiklikleri yapın.
IPA dosya boyutunu küçültmek sorunu çözmezse Firebase Destek Ekibi ile iletişime geçin ve Testflight'ı kullanma hakkında bilgi alın.
Uygulama yükleme ve test etme
Test kullanıcılarınızın uygulamalarınızı yükleyip test ederken karşılaşabileceği sorunları gidermek için aşağıdaki ipuçlarını kullanın.
Test kullanıcısının Google Hesabı yok
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 ya da oturum açmak için başka bir e-posta adresi kullanmayı tercih ediyorsa test kullanıcısından Gmail dışında bir e-posta adresini hesabına bağlamasını ve oturum açmak için bu e-posta adresini kullanmasını isteyin.
Test kullanıcısı, alternatif e-posta adresi seçerken aşağıdaki kurallara uymalıdır:
Gmail adresi kullanmayın.
Önceden başka bir Google Hesabı'na bağlanmış bir e-posta adresini kullanmayın.
Bu e-posta adresini kullanarak oturum açarken Google Hesabı şifrenizi kullanmanız gerektiğini unutmayın.
Test kullanıcısı doğru uygulamaları veya derlemeleri göremiyor
Test kullanıcısı, e-posta davetini davetin gönderildiği e-posta adresinden farklı bir e-posta adresiyle kabul ettiyse doğru uygulamaları veya derlemeleri göremeyebilir.
Geliştiricinin davet gönderdiği ve yeni derlemelere eklediği e-posta adresi (A e-posta adresi), test kullanıcısının daveti kabul etmek için kullandığı e-posta adresinden (B e-posta adresi) farklı olabilir. Bu işlem, arka planda bir bağlantı oluşturur. Yeni derlemelere E-posta A eklendiğinde erişim izni aslında E-posta B'ye veriliyor.
Test kullanıcısı e-posta davetini farklı bir e-posta adresiyle kabul ettiyse sorunu çözmek için aşağıdaki adımları uygulayın:
Firebase konsolunun App Distribution sayfasındaki Test Kullanıcıları ve Gruplar sekmesinin Tüm test kullanıcılarını göster bölümünden test kullanıcısını silin.
Mevcut davetiyeler kaldırılır.
Test kullanıcısını uygulamanızı test etmeye yeniden davet edin. Test kullanıcısına bir davet e-postası gönderilir.
Test kullanıcısının daveti aynı e-posta adresiyle kabul ettiğinden emin olun.
Test kullanıcısı e-posta bildirimleri almıyor
Aşağıdakilerden biri gerçekleşirse test kullanıcıları e-posta bildirimi almayabilir:
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 gönderildiği e-posta hesabı için yeni sürüm e-postaları alır.
Test kullanıcısı daha önce davet edilmiş ancak ilk daveti kabul etmemiştir.
Test kullanıcısı sonraki sürümlere eklenirse ilk daveti kabul etmediği için App Distribution, bu test kullanıcısına otomatik olarak sürüm bildirimleri göndermez.
1. çözüm
Test kullanıcısından, spam klasörünü ve e-posta hizmetinde ayarladığı e-posta filtrelerini kontrol etmesini isteyin.
Test kullanıcısı e-posta listesinden çıktıysa test kullanıcısından aşağıdakileri yapmasını isteyin:
Test kullanıcısının daha önce uygulamadan aldığı bir e-postayı bulun.
Alt kısımdan E-posta ayarlarını yönet'i ve yeniden abone olmak için E-postalara izin ver'i tıklayın.
2. çözüm
Test kullanıcısı e-posta bildirimleri almak istemiyor ve yalnızca uygulama davetlerini kabul etmek istiyorsa bekleyen uygulama davetlerini doğrudan Firebase App Distribution web klibinde görüntüleyebilir: appdistribution.firebase.google.com.
3. çözüm
Firebase konsolundaki App Distribution sayfasında Test Kullanıcıları ve Gruplar sekmesinin Tüm test kullanıcılarını göster bölümünden test kullanıcısını silin.
Bu işlem, mevcut davetiyeleri kaldırır.
Test kullanıcısını uygulamanızı test etmeye yeniden davet edin. Test kullanıcısına bir davet e-postası gönderilir. Test kullanıcısının, davetiyeyi gönderildiği e-posta adresiyle kabul ettiğinden emin olun.
Test uygulamasını çalıştırmaya çalışırken "Güvenilmeyen Kurumsal Geliştirici" hatası
Uygulamayı açmadan önce test cihazındaki geliştirici sertifikasına güvenmediyseniz Güvenilmeyen Kurumsal Geliştirici hatası gösterilir. Ayarlar uygulaması > Profiller ve Cihaz Yönetimi ekranında uygulamanın geliştirici adını seçin ve güvenin.
Test uygulamasını çalıştırmaya çalışırken "Geliştirici Modu Gerekli" hatası
Geliştirici Modu Gerekli hatası, geçici olarak temel hazırlığı yapılmış bir iOS uygulamasını iOS 16 veya sonraki sürümlerde Geliştirici Modu'nu etkinleştirmeden başlatmaya çalıştığınızda görünür.
Geliştirici Modu'nu etkinleştirmek ve bu hatayı düzeltmek için aşağıdaki adımları uygulayın:
iPhone'unuzda Ayarlar uygulamasını açıp Gizlilik ve Güvenlik'e dokunun.
Aşağı kaydırarak Güvenlik'e gidin ve Geliştirici Modu'na dokunun.
Geliştirici Modu kaydırma çubuğuna dokunun.
Yeniden başlat'a dokunun.
Cihaz yeniden başlatıldıktan sonra cihazın kilidini açın. "Geliştirici modu etkinleştirilsin mi?" iletişim kutusu görünür.
Aç'a dokunun. Artık uygulamanızı başlatabilir ve test etmeye başlayabilirsiniz.
"Cihaz kaydedildiğine göre her şey tamam. Uygulama test edilmeye hazır olduğunda e-postayla bilgilendirileceksiniz"
Ad Hoc dağıtımı yüklüyorsanız geliştirici, uygulamasını test cihazınızda çalışacak şekilde henüz yapılandırmadığında bu mesaj görünür.
Uygulamayı kullanabilmeniz için geliştiricinin Ek cihaz kaydetme bölümündeki talimatları tamamlaması gerekir.
Google Hesabı'nın test uygulamasına erişimi yok
Google Hesabınızın daha önce yüklediğiniz (veya davetini kabul ettiğiniz) bir test uygulamasına erişimi yoksa yanlış Google Hesabı'nda oturum açmış olabilirsiniz. Erişiminiz olan uygulamalar, uygulamayı test etme davetini ilk kabul ettiğinizde kullandığınız Google Hesabı ile ilişkilendirilir. Daveti kabul etmek için daha önce kullandığınız Google Hesabı ile oturum açarak tekrar deneyin.
403 hatası: "Erişim için yöneticinizle iletişime geçin"
403 hatası, kullandığınız hesabın uygulama yükleme ve test etme izni olmadığı anlamına gelir. Erişim, Google Workspace'te hesabınızın alanının yöneticisi tarafından belirlenir.
Uygulama yükleme ve test etme izniniz olması gerektiğini düşünüyorsanız Google Workspace hesabı yöneticinizden hesap ayarlarınızı değiştirmesini isteyin. Yöneticiniz, Tek tek denetlenemeyen hizmetlere erişimi yönetme başlıklı makaledeki talimatları uygulamalıdır.
Birden fazla hesabınız varsa uygulama yükleme ve test etme konusunda kısıtlanmamış farklı bir hesapla giriş yapmayı deneyin.
App Distribution iOS SDK'sı ile uygulama içi uyarıları etkinleştirme
App Distribution iOS SDK'yı kullanarak uygulama içi yeni derleme uyarılarını etkinleştirmeyle ilgili sorunları gidermek için aşağıdaki ipuçlarından yararlanın.
Test kullanıcısı uygulama içi uyarıları almıyor
App Distribution iOS SDK'sını uygulamanızda zaten ayarladıysanız ve test kullanıcılarınız uygulama içi uyarılar almıyorsa uygulamanızın yeni sürümleri aldığından emin olun:
Uygulamanızda hata ayıklama modunu etkinleştirin. Bunun nasıl yapılacağını öğrenmek için Google Analytics belgelerini inceleyin.
Uygulamanızı bir simülatörde çalıştırın ve "[Firebase/AppDistribution]" dizesini arayın.
Test kullanıcısının yeni sürüme erişimi olup olmadığını kontrol edin:
Geçerli bir sürüm nesnesi döndürülürse büyük olasılıkla View Controller yaşam döngüsünde, uyarı iletişim kutusunun görünüm gösterilmeden önce yüklendiği bir sorun vardır.
Sürüm döndürülmezse test kullanıcınız henüz yeni sürümle ilişkilendirilmemiş olabilir. Firebase Console'un App Distribution 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â güncelleme almıyorsa uygulamanızı test etme davetini kabul ettiğinden ve test cihazını doğru şekilde ayarladığından emin olmak için aşağıdaki ipuçlarını kullanmasını isteyin:
Test cihazında Firebase App Distribution web klibinde oturum açın. Uygulamayı test etme davetini kabul ederken ilk kullandığınız Google Hesabı'nı seçmeyi unutmayın.
Yeni uygulama sürümünün web klibinde mevcut olduğundan emin olun.
Test kullanıcısından, uygulamayı kapattıktan sonra tekrar oturum açması isteniyor
Varsayılan olarak, test kullanıcılarınızın yeni derleme uyarılarını etkinleştirmek ve yeni derlemeleri yüklemek için Google Hesaplarında yalnızca bir kez oturum açmaları gerekir. Test kullanıcılarınız uygulamanızı kapatıp yeniden açtıktan sonra tekrar oturum açmaları isteniyorsa App Distribution yapılandırmanızın doğru şekilde ayarlandığından emin olmak için aşağıdaki ipuçlarını uygulayın:
Anahtar kısıtlamaları bölümünde, Firebase App Testers API'nin izin verilen API'ler listesinde yer aldığından emin olun.
Oturum kapatıldığında genellikle UserDefaults'u temizliyorsanız test kullanıcınızın durumunu temizliyor olabilirsiniz. App Distribution, test kullanıcınızın uygulamada oturum açıp açmadığını belirten bir işaret depolar. Daha fazla bilgi için GitHub deposuna bakın.
Sık sorulan sorular
Uygulamama test kullanıcısı eklemeyle ilgili sınırlamalar var mı?
Firebase App Distribution için aşağıdaki test kullanıcısı sınırları geçerlidir:
Bir Firebase projesine en fazla 500 test kullanıcısı ekleme
App Distribution grubuna en fazla 200 test kullanıcısı ekleyebilirsiniz.
Daha fazla test kullanıcısı eklemek için ücretsiz sınır artışı isteğinde bulunun.
Test kullanıcısı davetlerimin süresi dolar mı?
Test kullanıcılarının, uygulamayı test etme davetini kabul etmek için 30 günü vardır. Bu sürenin sonunda davetin süresi dolar.
Davetiyenin süresinin dolmasına 5 gün kaldığında, Firebase konsolunda bir sürümdeki test kullanıcısının yanında süre sonu bildirimi görünür. Davetiyeyi, test kullanıcısı satırındaki açılır menüyü kullanarak yeniden gönderip yenileyebilirsiniz.
iOS yüklemeleri için ne zaman yeni bir sürüm oluşturulur?
Uygulama, 150 günlük geçerlilik sınırına veya 1.000 uygulama sürümü sınırına ulaştığında ya da bu sınırı aştığında sürüm, App Distribution kontrol panelinden ve App Distribution test kullanıcısı web uygulamasından kaldırılır. Test kullanıcı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 durumda kalması için aşağıdaki önerilerden birini uygulayın:
Uygulama sürümünün süresi dolmadan veya sürüm sınırını aşmadan önce IPA'yı indirin ve sürümü App Distribution kontrol panelinden silin. Ardından, IPA'yı App Distribution platformuna yeni bir derleme olarak yeniden yükleyin.
Sürümü indirip uzun süreli arşivleme için Cloud Storage platformuna 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 App Distribution kontrol panelinde görünür. Sürümü yükledikten sonra test kullanıcılarına dağıtabilirsiniz. Test kullanıcıları, sürümü test cihazlarındaki App Distribution test kullanıcısı web uygulamasından yükler.
Sürümün geçerlilik bitiş tarihine 30 gün kaldığında Firebase Console'un App Distribution sayfasındaki sürümünüzde ve App Distribution test kullanıcısı web uygulamasında uygulama sürümünün geçerlilik bitiş tarihiyle ilgili bir bildirim gösterilir.
App Distribution en fazla 1.000 sürümü destekler.
App Distribution, uygulama başına en fazla 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 App Distribution REST API'yi kullanın.
Firebase profili, App Distribution uygulamasının şunları yapmasına olanak tanıyan bir yapılandırma profilidir:
Cihazın benzersiz cihaz kimliğini (UDID) toplayarak test cihazını kaydedin. Ad Hoc dağıtımını test ediyorsanız Firebase, uygulama geliştiriciye test cihazının UDID'sini ve derlemenin cihazınızda test edilebilmesi için cihazı uygulamanın temel hazırlık profiline nasıl dahil edeceğine dair talimatları içeren bir e-posta gönderir.
Cihazınızın ana ekranına bir Firebase App Distribution web klibi yükleyin. Web klibi, tüm test uygulamalarınızı tek bir yerden yüklemenize ve bunlara erişmenize olanak tanır. Test etmeye davet edildiğiniz yeni derlemeler otomatik olarak web klibine eklenir.
iOS cihazınıza yapılandırma profilleri yükleme konusunda yardım için Apple'ın belgelerine bakın.
Cihazıma yüklediğim test uygulamalarına nasıl erişebilirim?
Test kullanıcısıysanız Firebase profilini yüklediğinizde test cihazınızın ana ekranına otomatik olarak eklenen Firebase App Distribution web klibi ile tüm test uygulamalarınıza erişebilirsiniz. Geçici bir dağıtımı test ediyorsanız uygulamayı test edebilmek için önce profili yüklemeniz gerekir.
Kurumsal dağıtımı test ediyorsanız profili manuel olarak yükleyebilirsiniz:
Henüz yapmadıysanız Google'da oturum açın ve daveti kabul edin.
Test uygulamaları bölümünde test etmek istediğiniz uygulamayı seçin.
Uygulama sayfasının sağ üst kısmında mobile_screen_share simgesine dokunun.
Firebase profilini yüklemek için gösterilen talimatları uygulayın.
Test kullanıcısı hesabımı nasıl silebilirim?
App Distribution test kullanıcısı hesabınızı ve ilişkili verilerini silmek için aşağıdaki adımları sırayla uygulayın:
Sağ üstte settings (Hesabı yönet) simgesini tıklayın.
Hesabı sil.
İsteğe bağlı: Google Hesabı izinlerinizdeFirebase App Distribution erişimini iptal edin. Önce App Distribution hesabınızı silmeden erişimi iptal etmenin, test kullanıcısı hesabınızı veya verilerinizi silmeyeceğini unutmayın.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 2026-10-16 UTC."],[],[]]