Bu sayfada, App Distribution'ı kullanarak uygulama dağıtma ve test etme hakkında sık sorulan soruların yanıtları ve sorun giderme yardımı yer almaktadır.
Uygulamaları 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ından yararlanın.
İletişim e-postası eksik olduğundan uygulama dağıtılamıyor
Uygulama yüklerken şu hatayla karşılaşabilirsiniz:
"<app-id>
uygulaması için iletişim e-postası bulunamadı. Hesap oluşturmak için lütfen Firebase konsolunda App Distribution'ı ziyaret edin."
Varsa Firebase konsolunda bir İletişim E-posta Adresi ayarlayın. Sorun devam ederse Firebase Destek Ekibi ile iletişime geçin.
Uygulamanız hazırlanırken bir hata oluştu (400, 409 veya 500 hataları)
Temel hazırlık sırasında sürekli olarak 400, 409 veya 500 hatalarıyla karşılaşıyorsanız Firebase Destek Ekibi ile iletişime geçin. Firebase proje numaranızı ve uygulama tanımlayıcınızı kullanarak destek sağlayın.
IPA yüklenemiyor
Aşağıda, tarayıcı ağ yanıtı örneği verilmiştir:
{
"status": "IN_PROGRESS",
"message": "There was an error processing your
distribution. Ensure you are uploading a valid IPA or APK and try again."
}
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ı 2048 MiB'tır. Bu, 2 GB'ın biraz üzerinde bir değerdir.
IPA boyutu, dosya boyutu sınırı dahilindeyse ve yeniden oluşturulabiliyorsa şu adımları izleyin:
Info.plist
dosyanızı kontrol edin veCFBundleDisplayName
öğesinin<array>
sınırlayıcı içerip içermediğini kontrol edin.<array>
sınırlayıcıları kaldırın ve uygulamanızı yeniden oluşturun. Yükleme işlemi başarılı olacaktır.Sorun yaşamaya devam ederseniz Firebase Destek Ekibi ile iletişime geçin.
IPA boyutu, dosya boyutu sınırının üzerindeyse dosya boyutunu azaltmak için gerekli değişiklikleri yapın.
IPA dosya boyutunu azaltmak sorunu çözmezse Firebase Destek Ekibi ile iletişime geçerek Testflight'ın nasıl kullanılacağını sorun.
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ından yararlanın.
Test kullanıcısının Google Hesabı yok
Google Hesabı oluşturan kullanıcılara otomatik olarak bir Gmail adresi verilir.
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 kullanmak istiyorsa test sahibinden hesaba Gmail olmayan bir e-posta adresi bağlamasını ve oturum açmak için bu e-posta adresini kullanmasını isteyin.
Test kullanıcısı, alternatif bir e-posta adresi seçerken şu yönergelere uymalıdır:
- Gmail adresi kullanmayın.
- Halihazırda başka bir Google Hesabı'na bağlı olan e-posta adresini kullanmayın.
- Bu e-posta adresiyle oturum açarken Google Hesabı şifrenizi kullanmayı unutmayın.
Daha fazla bilgi için Google Hesabınızda başka bir e-posta adresiyle oturum açma başlıklı makaleyi inceleyin.
Test kullanıcısı doğru uygulamaları veya derlemeleri göremiyor
Test kullanıcısı, e-posta davetiyesini, davetin gönderildiği e-posta adresinden farklı bir adresle kabul ettiyse doğru uygulamaları veya derlemeleri göremeyebilir.
Geliştiricinin yeni derlemelere davetiye gönderdiği ve yeni derlemelere eklediği e-posta (E-posta A), test kullanıcısının daveti kabul etmek için kullandığı e-postadan (B E-postası) farklı olabilir. Bu işlem, perde arkasında bir bağlantı oluşturur. Yeni yapılara A E-postası eklendiğinde, aslında E-posta B olur.
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 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ılır.
Test kullanıcısını uygulamanızı test etmeye tekrar davet edin. Test kullanıcısı bir davet e-postası alır.
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ğıdaki durumlardan biri gerçekleştiğinde test kullanıcıları e-posta bildirimleri almayabilir:
E-posta bildirimleri spam klasörlerine gönderilir.
E-posta filtreleri ayarlandı.
Davet bir e-posta hesabına gönderilmiş, ancak test kullanıcısı farklı bir e-posta hesabıyla kabul etmiştir. Test kullanıcısı, davetiyenin başlangıçta 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 test kullanıcısı ilk daveti kabul etmediği için App Distribution bu test kullanıcısına otomatik olarak sürüm bildirimleri göndermez.
Çözüm 1
Test sahibinden spam klasörünü ve e-posta hizmetinde ayarladığı e-posta filtrelerini kontrol etmesini isteyin.
Test kullanıcısı, e-posta listesinden çıktıysa aşağıdakileri yapmasını isteyin:
- Test kullanıcısının daha önce uygulamadan aldığı bir e-postayı bulun.
- Yeniden abone olmak için alt kısımdaki E-posta ayarlarını yönet'i, ardından E-postalara izin ver'i tıklayın.
Çözüm 2
Test kullanıcısı, e-posta bildirimlerini almakla ilgilenmiyor ve yalnızca uygulama davetiyelerini kabul edebilmek istiyorsa bekleyen uygulama davetiyelerini doğrudan Firebase App Distribution web klibinde görüntüleyebilir: appdistribution.firebase.google.com.
Çözüm 3
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. Bu işlem mevcut davetiyeleri kaldırır.
Test kullanıcısını uygulamanızı test etmeye tekrar davet edin. Test kullanıcısı bir davet e-postası alır. Test kullanıcısının daveti, 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ında geliştirici sertifikasına güvenmediyseniz Güvenilmeyen Kurumsal Geliştirici hatası görünür. 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ı
iOS 16 veya sonraki sürümlerde, önce Geliştirici Modu'nu etkinleştirmeden, geçici temel hazırlığı yapılmış bir iOS uygulamasını başlatmaya çalıştığınızda Geliştirici Modu Gerekli hatası görünür.
Geliştirici Modu'nu etkinleştirmek ve bu hatayı gidermek için aşağıdaki adımları uygulayın:
- iPhone'unuzda Ayarlar uygulamasını açıp Gizlilik ve Güvenlik'e dokunun.
- Güvenlik bölümüne 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 açılsın mı? iletişim kutusu görünür.
- Aç'a dokunun. Artık uygulamanızı başlatabilir ve test etmeye başlayabilirsiniz.
"Cihaz kaydedildi, işlem tamamlandı. Uygulama test edilmeye hazır olduğunda e-postayla bilgilendirileceksiniz.
Ad Hoc dağıtımı yüklüyorsanız geliştirici henüz uygulamasını test cihazınızda çalışacak şekilde yapılandırmadığında bu mesaj gösterilir. Uygulamayı kullanımınıza sunmak 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 daha önce yüklediğiniz (veya bir davetiyeyi kabul ettiğiniz) test uygulamasına erişemiyorsa muhtemelen yanlış Google Hesabı'nda oturum açmışsınızdır. Erişiminiz olan uygulamalar, uygulamayı test etme davetini ilk kez kabul ettiğinizde kullandığınız Google Hesabı ile ilişkilendirilir. Daha önce daveti kabul etmek için 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ıyla karşılaşmanız, kullandığınız hesabın uygulama yükleme ve test etme izni olmadığı anlamına gelir. Erişim, hesabınızın Google Workspace'teki alanının yöneticisi tarafından belirlenir.
Uygulamaları yükleme ve test etme izniniz olması gerektiğini düşünüyorsanız Google Workspace hesap yöneticinizden hesap ayarlarınızı değiştirmesini isteyin. Yöneticiniz, Tek tek denetlenemeyen hizmetlere erişimi yönetme başlıklı makalede verilen 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'sını kullanarak uygulama içi yeni derleme uyarılarını etkinleştirme gibi sorunları gidermek için aşağıdaki ipuçlarını kullanın.
Test kullanıcısı uygulama içi uyarılar almıyor
Uygulamanızda App Distribution iOS SDK'sını kurduysanız ve test kullanıcıları uygulama içi uyarı almıyorsa uygulamanızın yeni sürümler getirdiğinden emin olun:
Uygulamanızda hata ayıklama modunu etkinleştirin. Nasıl yapılacağını öğrenmek için Google Analytics belgelerini inceleyin.
Uygulamanızı bir simülasyon aracında çalıştırın ve "[Firebase/App Distribution]" 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 uyarı iletişim kutusunun Görünüm görünmeden önce yüklendiği Görünüm Denetleyicisi yaşam döngüsünde bir sorun olabilir.
Hiçbir sürüm döndürülmezse test kullanıcınız henüz yeni sürümle ilişkilendirilmemiş olabilir. Firebase konsolunun 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üncellemeleri almıyorsa, uygulamanızı test etme davetini kabul ettiğinden ve test cihazını doğru bir şekilde kurduğundan emin olmak için aşağıdaki ipuçlarını uygulamasını isteyin:
Test cihazında Firebase App Distribution web klibinde 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 web klibinde bulunduğundan emin olun.
Test kullanıcısı, uygulamayı kapattıktan sonra tekrar oturum açma isteğinde bulundu
Varsayılan olarak test kullanıcılarınızın yeni derleme uyarılarını etkinleştirmek ve yeni derlemeler yüklemek için Google Hesaplarında yalnızca bir kez oturum açmaları yeterlidir. Test kullanıcılarınızdan 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:
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 bölümünde Firebase App Testers API'nin izin verilen API'ler listesine eklendiğinden 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 zaten oturum açmış olup olmadığını belirten bir işaret depolar. Daha fazla bilgi için GitHub deposuna göz atın.
Sık sorulan sorular
Uygulamama test kullanıcıları eklemeyle ilgili sınırlar var mı?
Firebase App Distribution'da aşağıdaki test kullanıcısı sınırları bulunur:
Firebase projelerine en fazla 500 test kullanıcısı ekleme
App Distribution grubuna en fazla 200 test kullanıcısı ekleme
Daha fazla test kullanıcısı eklemek için ücretsiz sınır artışı isteğinde bulunun.
Test kullanıcısı davetiyelerimin süresi dolar mı?
Test kullanıcılarının 30 gün içinde uygulamayı test etme davetini süresi dolmadan kabul etmeleri gerekir. Bir davetiyenin süresinin dolmasından 5 gün sonra, Firebase konsolunda bir sürümde test kullanıcısının yanında bir geçerlilik bitiş bildirimi görünür. Davetiye, test kullanıcısı satırındaki açılır menü aracılığıyla yeniden gönderilerek yenilenebilir.
iOS yüklemeleri için yeni sürüm ne zaman oluşturulur?
Başka cihazlar kaydettirme başlıklı makaleye göz atın.
Uygulama sürümleri ne kadar süreyle kullanıma sunulur?
Aşağıdaki koşullardan biri gerçekleşirse uygulama sürümleri App Distribution'dan kaldırılır:
- Uygulama sürümü 150 günden eskidir.
- 1.000 uygulama sürüm sınırını aşıyorsanız ve uygulama sürümü en son 1.000 uygulama sürümünden daha eskidir.
Daha fazla bilgi için App Distribution en fazla 1.000 sürümü destekler bölümünü inceleyin.
Uygulama, 150 günlük geçerlilik süresi 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ıktan sonra, 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.
Uygulamanın daha uzun süre kullanıma sunulmasını sağlamak için aşağıdaki önerilerden birini uygulayın:
- Uygulama sürümünün kullanım 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'a yeni bir derleme olarak yeniden yükleyin.
- Sürümü indirip 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 bu sürüm, yükleme tarihinden itibaren 150 gün boyunca Uygulama Dağıtımı kontrol panelinde görünür. Yüklendikten sonra sürümü test kullanıcılarına dağıtabilirsiniz. Bu kullanıcılar, App Distribution test kullanıcısı web uygulamasındaki sürümü test cihazlarına yüklerler.
Sürüm, geçerlilik bitiş tarihinden 30 gün sonra olduğunda, Firebase konsolunun Uygulama Dağıtımı sayfasında ve Uygulama Dağıtımı test kullanıcısı web uygulamasında sürümünüzde bir uygulama yayın süresi sona erme bildirimi görüntülenir.
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 bu sınırı aşan 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'sini kullanın.
Sorunuz varsa Firebase Destek Ekibi ile iletişime geçin.
Firebase profili nedir?
Firebase profili, App Distribution'ın şunları yapmasına olanak tanıyan bir yapılandırma profilidir:
Cihazın benzersiz cihaz kimliğini (UDID) toplayarak test cihazını kaydedin. Anlık dağıtımı test ediyorsanız Firebase, uygulama geliştiricisine test cihazının UDID'sini ve derlemenin cihazınızda test edilebilmesi için cihazı uygulamanın temel hazırlık profiline ekleme talimatlarını 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 onlara erişmenize olanak tanır. Test etmeye davet edildiğiniz yeni derlemeler otomatik olarak web klibine eklenir.
iOS cihazınıza yapılandırma profillerini yükleme konusunda yardım almak 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 klibiyle tüm test uygulamalarınıza erişebilirsiniz. Ad Hoc dağıtımını test ediyorsanız uygulamayı test etmeden önce profili yüklemeniz gerekir.
Enterprise dağıtımını test ediyorsanız profili manuel olarak yükleyebilirsiniz:
Henüz yapmadıysanız Google'da oturum açın ve daveti kabul edin.
Uygulamaları test et bölümünde, test etmek istediğiniz uygulamayı seçin.
Uygulama sayfasının sağ üst kısmındaki mobile_screen_share'e dokunun.
Firebase profilini yüklemek için gösterilen talimatları uygulayın.
Test kullanıcısı hesabımı nasıl silerim?
App Distribution test kullanıcısı hesabınızı ve bu hesapla ilişkili verileri silmek için şu adımları sırayla uygulayın:
https://appdistribution.firebase.google.com adresini ziyaret edin ve Google hesabınızla oturum açın.
Sağ üstten settings (Hesabı yönet) seçeneğini tıklayın.
Hesabı sil.
İsteğe bağlı: Google hesabı izinlerinizde Firebase App Distribution'a erişimi iptal edin. App Distribution hesabınızı silmeden önce erişimi iptal etmenin, test kullanıcısı hesabınızı veya verilerinizi silmediğini unutmayın.