Ad Hoc Distribution — nedir, iOS test sınırlamaları

Ad Hoc Distribution nedir?

Ad Hoc Distribution, tüm Apple Developer Program üyelerinin ($99/yıl) kullanabildiği bir iOS uygulaması dağıtım yöntemidir. Uygulamaların App Store denetiminden geçmeden doğrudan cihazlara yüklenmesine olanak tanır. Ana amaç, yayın öncesi testtir: geliştiriciler, test uzmanları ve müşteriler, resmi yayından önce uygulamayı kendi cihazlarına yükleyebilir.

Ad Hoc Distribution, izin verilen cihaz UDID'lerinin listesini içeren bir Provisioning Profile kullanır. Uygulamayı imzalarken, Xcode veya Fastlane, yalnızca bu listedeki cihazlara yüklenebilecek bir IPA dosyası oluşturur. Her UDID, Apple Developer Portal üzerinden eklenir ve toplam sayı, geliştirici hesabı başına 100 cihazı aşamaz.

Apple'a (2025) göre Ad Hoc Distribution, uygulamanın henüz App Store denetiminden geçmediği ancak bir müşteriye gösterilmesi veya gerçek cihazlarda test edilmesi gerektiği durumlarda yayın öncesi test için talep görmeye devam ediyor. Ancak Apple, büyük ölçekli beta testi için TestFlight kullanılmasını önerir ve Ad Hoc'u küçük gruplar ve özel durumlar için bırakır.

Ad Hoc dağıtımı nasıl çalışır?

Ad Hoc dağıtımı, OTA (Over-The-Air) kurulumu veya iTunes/Finder aracılığıyla çalışır. Geliştirici, seçilen UDID'lerle bir Ad Hoc Provisioning Profile oluşturur, uygulamayı bu profille imzalar ve IPA dosyasını dışa aktarır. Kullanıcı, uygulamayı Safari üzerinden bir bağlantıyla veya macOS'ta Finder aracılığıyla yükler.

Teknik olarak, Ad Hoc dağıtımı birkaç aşamadan oluşur. İlk olarak, yönetici test cihazlarının UDID'lerini toplar — her UDID, bir iOS cihazı için benzersiz 40 karakterli bir tanımlayıcıdır. Ardından UDID'ler Apple Developer Portal'a eklenir, bir Provisioning Profile oluşturulur ve imzalı bir IPA oluşturulur. Geçerlilik süresi bir Ad Hoc profili için bir yıldır, sonrasında uygulamalar açılmayı durdurur.

# Fastlane — Ad Hoc dağıtımını otomatikleştirin
lane :adhoc do
    match(type: "adhoc")
    gym(scheme: "MyApp",
        export_method: "ad-hoc")
    pilot(
        distribute_only: true,
        devices_file: "./devices.txt"
    )
end

Bir Ad Hoc uygulaması yüklemek için kullanıcının, cihazında geliştirici sertifikasına güvenmesi gerekir. Bunun için iOS ayarlarında "Genel" → "VPN ve Cihaz Yönetimi" → "Profil"e gidin ve "Güven"e dokunun. Bu adım olmadan uygulama başlatılmaz.

UDID kaydı ve 100 cihaz sınırı

UDID (Unique Device Identifier), her iOS cihazı için benzersiz bir tanımlayıcıdır. Ad Hoc dağıtımı için, tüm test cihazlarının UDID'lerini toplamanız ve Apple Developer Portal'a eklemeniz gerekir. Maksimum, geliştirici hesabı başına yılda 100 cihazdır. Bu sınır, her uygulama için ayrı ayrı değil, geliştiricinin tüm uygulamaları için geçerlidir.

100 cihaz sınırı, takvim yılının sonunda sıfırlanır — sıfırlama 1 Ocak'ta gerçekleşir. Ancak Apple, 10 000'e kadar harici test uzmanını destekleyen TestFlight'ın büyük ölçekli testler için kullanılmasını önerir. Ad Hoc Distribution, 2022'den beri, uygulamanın henüz Beta App Review'dan geçmediği veya testlerin orijinal IPA dosyasına erişim gerektirdiği durumlarda geçerliliğini korur.

Ad Hoc Distribution kurulumu

Kurulum, Apple Developer Portal ve Xcode üzerinden gerçekleştirilir. Süreç, cihaz kaydı, Provisioning Profile oluşturma, uygulamayı imzalama ve dağıtım için IPA'yı dışa aktarmayı içerir. Ekip geliştirmesi için Fastlane veya CI/CD üzerinden otomasyon kullanılması önerilir.

1. udid.io veya bir yapılandırma profili aracılığıyla test cihazlarının UDID'lerini toplayın
2. Apple Developer Portal'a UDID'leri ekleyin → Certificates, Identifiers & Profiles → Devices
3. Gerekli Bundle ID için kayıtlı cihazları içeren bir Ad Hoc Provisioning Profile oluşturun
4. Xcode'da Ad Hoc profiliyle uygulamayı imzalayın: Product → Archive → Distribute Ad Hoc
5. IPA dosyasını dışa aktarın ve bağlantıyı bir OTA sunucusu veya Firebase App Distribution üzerinden dağıtın
6. Kullanıcı için: cihazda bağlantıyı açın, uygulamayı yükleyin, ayarlarda sertifikaya güvenin

Süreci basitleştirmek için dağıtım hizmetleri kullanılır: Firebase App Distribution, Microsoft App Center veya BuddyBuild. Bu hizmetler UDID'leri otomatik olarak yönetir, Ad Hoc profilleri oluşturur ve test uzmanlarına davetiyeler gönderir. Firebase App Distribution ayrıca Gradle veya Fastlane aracılığıyla CI/CD boru hatlarıyla entegre olur.

Önemli bir nüans — UDID güncellemesi. Profile yeni bir cihaz eklemeniz gerekiyorsa, Provisioning Profile'i yeniden oluşturmanız ve uygulamayı yeniden imzalamanız gerekir. Uygulamayı zaten yüklemiş olan cihazlar, profilin süresi dolana kadar (1 yıl) kullanmaya devam edecektir. Bundan sonra, yeni bir profille yeniden yükleme gerekir.

Ad Hoc vs TestFlight ve Enterprise

Ad Hoc Distribution, App Store olmadan iOS uygulamaları dağıtmanın üç yönteminden yalnızca biridir. TestFlight (ücretsiz, 10 000'e kadar harici test uzmanı) ve Enterprise Distribution (cihaz sınırı yok, kurumsal uygulamalar için) farklı sınırlamalar ve gereksinimlerle benzer görevleri çözer.

TestFlight, Apple'ın beta testi için tercih ettiği yöntemdir. UDID toplama gerektirmez, 100 dahili ve 10 000 harici test uzmanını destekler, sürümleri otomatik olarak yönetir ve kurulum analitiği sağlar. Ancak TestFlight, harici test uzmanları için Beta App Review'den geçmeyi gerektirir ve bu 1–2 gün sürebilir. Ad Hoc Distribution hiçbir denetim gerektirmez.

Enterprise Distribution, sınırsız sayıda cihazla kurumsal uygulamalar için uygundur, ancak bir D-U-N-S numarasıyla Apple Developer Enterprise Program'a ($299/yıl) kayıt gerektirir. Ad Hoc, standart programın ($99/yıl) tüm üyeleri tarafından kullanılabilir ve şirketin yasal olarak doğrulanmasını gerektirmez. Küçük ekipler ve projeler için Ad Hoc, App Store olmadan dağıtımın en basit yolu olmaya devam etmektedir.