Uygulama Dağıtımı ile ilgili sorunları giderme SSS

iOS+ Android

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.

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 aşağıdaki hatayla karşılaşabilirsiniz:

"<app-id> uygulaması için iletişim e-postası bulunamadı. Oluşturmak için lütfen Firebase konsolundaki App Distribution sayfasını ziyaret edin."

Varsa Firebase konsolunda bir İletişim E-postası 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:

1. 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).

2. IPA boyutu dosya boyutu sınırı dahilindeyse ve yeniden oluşturulabiliyorsa aşağıdaki adımları uygulayın:

   1. Info.plist dosyanızı kontrol edin ve CFBundleDisplayName içinde <array> ayırıcı olup olmadığını onaylayın.

      Not: Uygulama Dağıtım, dizi olan CFBundleDisplayName değerlerini kabul etmez.

   2. <array> ayırıcılarını kaldırın ve uygulamanızı yeniden oluşturun. Yükleme başarılı olacaktır.

   3. Sorun yaşamaya devam ederseniz Firebase Destek Ekibi ile iletişime geçin.

3. IPA boyutu dosya boyutu sınırını aşıyorsa dosya boyutunu azaltmak için gerekli değişiklikleri yapın.

4. 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ı yoksa

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, arka planda bir bağlantı oluşturur. A e-postası yeni derlemelere eklendiğinde aslında erişimi B e-postası alıyor.

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:

1. 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.

2. Test kullanıcısını uygulamanızı test etmeye yeniden davet edin. Test kullanıcısına bir davet e-postası gönderilir.

3. Test kullanıcısının daveti aynı e-posta adresiyle kabul ettiğinden emin olun.

Test kullanıcısı e-posta bildirimi 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 App Distribution, ilk daveti kabul etmediği için bu test kullanıcısına otomatik olarak sürüm bildirimi göndermez.

1. Çözüm

1. Test kullanıcısından spam klasörünü ve e-posta hizmetinde ayarladıkları e-posta filtrelerini kontrol etmesini isteyin.

2. Test kullanıcısı e-posta listesinden çıktıysa aşağıdakileri yapmasını isteyin:

   1. Test kullanıcısının daha önce uygulamadan aldığı bir e-postayı bulun.
   2. Yeniden abone olmak için en alttaki E-posta ayarlarını yönet'i ve ardından E-postalara izin ver'i tıklayın.

2. Çözüm

Test kullanıcısı e-posta bildirimi almak istemiyorsa ve yalnızca uygulama davetlerini kabul etmek istiyorsa bekleyen uygulama davetlerini doğrudan Firebase App Distribution web klipsinde görüntüleyebilir: appdistribution.firebase.google.com.

Not: Bekleyen uygulama davetlerini görmek için test kullanıcısının web klibine giriş yapmak üzere kullandığı Google Hesabı'nın e-posta adresi, geliştiricinin davetinin alıcı e-posta adresiyle eşleşmelidir.

3. Çözüm

1. Firebase Konsolu'ndaki 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. Bu işlem, mevcut davetleri kaldırır.

2. 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, 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ındaki geliştirici sertifikasına güvenmediyseniz Güvenilir Olmayan Kuruluş Geliştiricisi hatası gösterilir. Ayarlar uygulaması > Profiller ve Cihaz Yönetimi ekranında uygulamanın geliştirici adını seçip ona güvenin.

Test uygulamasını çalıştırmaya çalışırken "Geliştirici Modu Gerekli" hatası

Geliştirici Modu Gerekli hatası, iOS 16 veya sonraki sürümlerde önce Geliştirici Modu'nu etkinleştirmeden anlık olarak temel hazırlığı yapılmış bir iOS uygulamasını başlatmaya çalıştığınızda gösterilir.

Geliştirici Modu'nu etkinleştirmek ve bu hatayı çözmek için aşağıdaki adımları uygulayın:

1. iPhone'unuzda Ayarlar uygulamasını açıp Gizlilik ve Güvenlik'e dokunun.
2. Güvenlik'e gidip Geliştirici Modu'na dokunun.
3. Geliştirici Modu kaydırma çubuğunu kullanın.
4. Yeniden başlat'a dokunun.
5. Cihaz yeniden başlatıldıktan sonra kilidini açın. Geliştirici modunu açmak istiyor musunuz? iletişim kutusu görünür.
6. 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.

Not: Geliştirici aynı derleme numarasını ve sürümünü içeren bir derleme dağıtmışsa yalnızca yeni kayıtlı cihazların kullanıcıları e-posta bildirimi alır.

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ı ile ilişkilidir. Daveti kabul etmek için daha önce kullandığınız Google Hesabı ile oturum açarak tekrar deneyin.

Aşağıdakileri göz önünde bulundurun:

• Davetiyeyi kabul etmek için kullandığınız Google Hesabı, davetin orijinal olarak gönderildiği Google Hesabı ile aynı olmayabilir.
• Google Hesabı, yalnızca Gmail veya G Suite alan adlarına sahip adreslerle değil, herhangi bir e-posta adresiyle ilişkilendirilebilir. Başka bir e-posta adresiyle nasıl oturum açacağınızı öğrenin.

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ı makaledeki talimatları izlemelidir.

Birden çok 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 yapı uyarılarını etkinleştirmeyle ilgili sorunları gidermek için aşağıdaki ipuçlarını kullanın.

Test kullanıcısı uygulama içi uyarı almıyor

Uygulamanızda App Distribution iOS SDK'sını zaten ayarladıysanız ve test kullanıcılarınız uygulama içi uyarı almıyorsa uygulamanızın yeni sürümleri getirip getirmediğini kontrol edin:

1. Uygulamanızda hata ayıklama modunu etkinleştirin. Bunu nasıl yapacağınızı öğrenmek için Google Analytics belgelerine göz atın.

2. Uygulamanızı bir simülatörde çalıştırın ve "[Firebase/AppDistribution]" dizesini arayın.

3. 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.

     Not: App Distribution iOS SDK'sı varsayılan olarak uyarı iletişim kutusu göstermez. İletişim kutusunun uygulamanızda nasıl ve nerede gösterileceğini belirtmeniz gerekir. Daha fazla bilgi için Temel uyarı yapılandırması başlıklı makaleyi inceleyin.

   • Hiçbir sürüm döndürülmediyse 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üncelleme 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ı isteyin:

     1. 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.

     2. Yeni uygulama sürümünün web klipsinde bulunduğ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çması 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:

• 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 dahil edildiğinden emin olun.

• Genellikle oturumu kapatırken UserDefaults'i 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:

• Firebase projelerine en fazla 500 test kullanıcısı ekleyebilirsiniz.

• 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, uygulamayı test etme davetini kabul etmek için 30 günü vardır. 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?

Ek cihazları kaydetme başlıklı makaleyi inceleyin.

Uygulama sürümleri ne kadar süreyle kullanılabilir?

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şarsanız ve uygulama sürümü en son 1.000 uygulama sürümünden eskiyse

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, 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, 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'sini kullanın.

Sorunuz varsa Firebase Destek Ekibi ile iletişime geçin.

Firebase profili nedir?

Firebase profili, App Distribution'e aşağıdakileri yapma olanağı tanıyan bir yapılandırma profilidir:

• Cihazın benzersiz cihaz kimliğini (UDID) toplayarak test cihazını kaydedin. Ad hoc dağıtımı test ediyorsanız Firebase, derlemenin cihazınızda test edilebilmesi için uygulama geliştiriciye test cihazının UDID'sini ve cihazın uygulamanın temel hazırlama profiline nasıl ekleneceğ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 klipsi, 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 web klibine otomatik olarak 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:

1. Henüz yapmadıysanız Google'da oturum açıp daveti kabul edin.

2. Uygulamaları test et bölümünde, test etmek istediğiniz uygulamayı seçin.

3. Uygulamanın sayfasının sağ üst kısmında simgesine dokunun.

4. 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:

1. https://appdistribution.firebase.google.com adresini ziyaret edip Google Hesabınızla oturum açın.

2. Sağ üstte simgesini (Hesabı yönet) tıklayın.

   Hesabı sil'i tıklayın.

3. İ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 etmenizin, test kullanıcısı hesabınızı veya verilerinizi silmediğini unutmayın.