Bu sayfada, App Distribution ile uygulama dağıtma ve test etme hakkında sık sorulan soruların yanıtları ve sorun giderme yardımı sağlanmaktadı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 aşağıdaki hatayla karşılaşabilirsiniz:
"<app-id>
uygulaması için iletişim e-postası bulamadık. Oluşturmak için lütfen Firebase konsolundaki App Distribution sayfasını 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 hata oluştu (400, 409 veya 500 hataları)
Hazırlama sırasında 400, 409 veya 500 hatalarıyla tekrar tekrar 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ı iletin.
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 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 dosyalar için maksimum dosya boyutu sınırı 2048 MiB'tir (2 GB'ın biraz üzerinde).
IPA boyutu, dosya boyutu sınırı dahilindeyse ve yeniden oluşturulabiliyorsa şu adımları izleyin:
Info.plist
dosyanızı kontrol edin veCFBundleDisplayName
içinde<array>
ayırıcı olup olmadığını onaylayın.<array>
ayırıcılarını kaldırın ve uygulamanızı yeniden oluşturun. Yükleme başarılı olur.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 küçültmek sorunu çözmezse Firebase Destek Ekibi ile iletişime geçip TestFlight'ı kullanma hakkında bilgi alın.
Uygulamaları 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
Kullanıcılar 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 ya da oturum açmak için başka bir e-posta adresi kullanmak istiyorsa test kullanıcısından Gmail dışında bir e-posta adresini hesaba bağlamasını ve oturum açmak için bu e-postayı kullanmasını isteyin.
Test kullanıcısı, alternatif e-posta seçerken aşağıdaki yönergelere uymalıdır:
- Gmail adresi kullanmayın.
- Başka bir Google Hesabı'na bağlı bir e-posta adresi kullanmayın.
- Bu e-posta adresiyle oturum açarken Google Hesabı şifrenizi kullanmanız gerektiğini 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 davetini davetin gönderildiği e-posta adresinden farklı bir e-posta adresiyle kabul ederse doğru uygulamaları veya derlemeleri göremeyebilir.
Geliştiricinin davetiye gönderdiği ve yeni derlemelere eklediği e-posta (E-posta A), test kullanıcısının davetiyeyi kabul etmek için kullandığı e-postadan (E-posta B) farklı olabilir. Bu işlem, perde arkasında bir bağlantı oluşturur. A e-postası yeni derlemelere her eklendiğinde aslında erişim elde eden B e-postasıdır.
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 Konsolu'nun App Distribution sayfasında, 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 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
Test kullanıcıları aşağıdaki durumlarda e-posta bildirimi alamayabilir:
E-posta bildirimleri spam klasörlerine gönderilir.
E-posta filtreleri ayarlanır.
Davetiye bir e-posta adresine gönderildi ancak test kullanıcısı farklı bir e-posta adresiyle kabul etti. Test kullanıcısı, davetin ilk 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 kullanıcısından spam klasörünü ve e-posta hizmetinde ayarladıkları 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 uygulamadan daha önce aldığı bir e-postayı bulun.
- Yeniden abone olmak için alt kısımdan E-posta ayarlarını yönet'i, ardından E-postalara izin ver'i tıklayın.
2. Çözüm
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.
3. Çözüm
Firebase konsolunun App Distribution 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 davetleri 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, davetin gönderildiği e-posta adresiyle daveti kabul ettiğinden emin olun.
Test uygulamasını çalıştırmaya çalışırken "Untrusted Enterprise Developer" 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 bir sürümde, ö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ı çözmek için aşağıdaki adımları uygulayın:
- iPhone'unuzda Ayarlar uygulamasını açıp Gizlilik ve Güvenlik'e dokunun.
- Güvenlik'e gidip 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 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şlatıp 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 henüz uygulamasını test cihazınızda çalışacak şekilde yapılandırmadığında bu mesaj gösterilir. Geliştiricinin, uygulamayı size sunabilmesi için 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 davetini kabul ettiğiniz) bir test uygulamasına erişemiyorsa yanlış Google Hesabı'nda oturum açmış olabilirsiniz. Erişiminiz olan uygulamalar, uygulamayı test etme davetini ilk kez kabul ettiğinizde kullandığınız Google hesabıyla 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ı, kullandığınız hesabın uygulama yükleme ve test etme izninin olmadığı anlamına gelir. Erişim, hesabınızın Google Workspace'teki alanının yöneticisi tarafından belirlenir.
Uygulama 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 özelliği 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ı zaten kurduysanız ve test kullanıcılarınız 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. Bunu nasıl yapacağınızı öğ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şip erişemediğini kontrol edin:
Geçerli bir yayın nesnesi döndürülürse görünüm görünmeden önce uyarı iletişim kutusunun yüklendiği View Controller 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 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ü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 klipinde 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 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 Uygulama Dağıtım Testi API'sini etkinleştirme başlıklı makaleyi inceleyin.
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 önceden oturum açıp açmadığı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ı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ı 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. Davetin geçerlilik süresi 5 gün içinde sona erecekse Firebase konsolunda, sürümdeki test kullanıcısının yanında bir geçerlilik süresi sonu bildirimi gösterilir. Davetiyeler, test kullanıcısı satırındaki açılır menüden yeniden gönderilerek uzatılabilir.
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'ten kaldırılır:
- Uygulama sürümü 150 günden eskidir.
- 1.000 uygulama sürümü sınırını aşmışsınızdır ve uygulama sürümü en son 1.000 uygulama sürümünden eskidir.
Daha fazla bilgi için App Distribution en fazla 1.000 sürümü destekler başlıklı makaleyi inceleyin.
Uygulama 150 günlük geçerlilik süresine veya 1.000 uygulama sürümü sınırına ulaştığında ya da bu sınırları 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 kalması 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 IPA'yı indirin ve sürümü App Distribution kontrol panelinden silin. Ardından IPA'yı yeni bir derleme olarak App Distribution'e yeniden yükleyin.
- Sürümünü indirip uzun süreli arşivleme için Cloud Storage'e 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 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 Distributiontest kullanıcısı web uygulamasından yükler.
Sürümün geçerlilik bitiş tarihinden 30 gün geçtiğinde, sürümünüzde Firebase konsolunun App Distribution sayfasında ve App Distribution test kullanıcısı web uygulamasında bir uygulama sürümü geçerlilik bitiş bildirimi 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, 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'yi kullanın.
Sorunuz varsa Firebase Destek Ekibi ile iletişime geçin.
Firebase profili nedir?
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. Anlık dağıtımı test ediyorsanız Firebase, uygulama geliştiricisine test cihazının UDID'sini içeren bir e-posta gönderir. Bu e-postada, derlemenin cihazınızda test edilebilmesi için cihazın, uygulamanın temel hazırlık profiline eklenmesiyle ilgili talimatlar yer alır.
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 bu uygulamalara 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üklemeyle ilgili 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 klipsiyle tüm test uygulamalarınıza erişebilirsiniz. Ad Hoc dağıtımı 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.
Uygulamanın 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 silerim?
App Distribution test kullanıcısı hesabınızı ve bu hesapla ilişkili verileri silmek için aşağıdaki adımları sırayla uygulayın:
https://appdistribution.firebase.google.com adresini ziyaret edin ve Google Hesabınızla oturum açın.
Sağ üstte, settings (Hesabı yönet) seçeneğini tıklayın.
Hesabı sil.
İsteğe bağlı: Google Hesabı izinlerinizde Firebase App Distribution için erişimi iptal edin. App Distribution hesabınızı silmeden erişimi iptal etmenin, test kullanıcısı hesabınızı veya verilerinizi silmediğini unutmayın.