Ad Hoc Distribution — nədir, iOS test məhdudiyyətləri

Ad Hoc Distribution nədir?

Ad Hoc Distribution Apple Developer Program ($99/il) bütün iştirakçıları üçün əlçatan olan iOS tətbiqlərinin yayılması üsuludur. O, App Store moderasiyasından keçmədən tətbiqləri birbaşa cihazlarda quraşdırmağa imkan verir. Əsas təyinat — nəşrdən əvvəl sınaq: tərtibatçılar, testçilər və müştərilər rəsmi buraxılışa qədər tətbiqi öz cihazlarında quraşdıra bilərlər.

Ad Hoc Distribution icazə verilən UDID cihazlarının siyahısını ehtiva edən Provisioning Profile-dən istifadə edir. Tətbiqi imzalayarkən Xcode və ya Fastlane IPA faylı yaradır ki, onu yalnız bu siyahıdakı cihazlarda quraşdırmaq olar. Hər UDID Apple Developer Portal vasitəsilə əlavə edilir və ümumi say tərtibatçı hesabına 100 cihazdan çox ola bilməz.

Apple (2025) məlumatına görə, Ad Hoc Distribution pre-release sınaq üçün tələb olunmaqda davam edir, tətbiq hələ App Store moderasiyasından keçmədikdə, lakin onu sifarişçiyə göstərmək və ya real cihazlarda sınamaq lazım olduqda. Bununla belə, Apple geniş miqyaslı beta sınaq üçün TestFlight-dan istifadə etməyi tövsiyə edir, Ad Hoc-u kiçik qruplar və xüsusi hallar üçün saxlayır.

Ad Hoc yayılması necə işləyir?

Ad Hoc yayılması OTA (Over-The-Air) quraşdırma mexanizmi və ya iTunes/Finder vasitəsilə işləyir. Tərtibatçı seçilmiş UDID-lərlə Ad Hoc Provisioning Profile yaradır, tətbiqi bu profillə imzalayır və IPA faylını ixrac edir. İstifadəçi tətbiqi Safari vasitəsilə keçidlə və ya macOS-da Finder vasitəsilə quraşdırır.

Texniki olaraq Ad Hoc Distribution bir neçə mərhələdən ibarətdir. Əvvəlcə administrator test cihazlarının UDID-lərini toplayır — hər UDID iOS cihazının unikal 40 simvoldan ibarət identifikatorudur. Sonra UDID-lər Apple Developer Portal-a əlavə edilir, Provisioning Profile yaradılır və imzalanmış IPA yaradılır. Ad Hoc profilinin etibarlılıq müddəti bir ildir, bundan sonra tətbiqlər açılmağı dayandırır.

# Fastlane — Ad Hoc Distribution avtomatlaşdırılması
lane :adhoc do
    match(type: "adhoc")
    gym(scheme: "MyApp",
        export_method: "ad-hoc")
    pilot(
        distribute_only: true,
        devices_file: "./devices.txt"
    )
end

Ad Hoc tətbiqini quraşdırmaq üçün istifadəçi öz cihazında tərtibatçının sertifikatına etibar etməlidir. Bunun üçün iOS parametrlərində „Ümumi“ → „VPN və cihaz idarəetməsi“ → „Profil“ bölməsinə keçib „Etibar et“ düyməsini sıxmaq lazımdır. Bu addım olmadan tətbiq işə düşməyəcək.

UDID qeydiyyatı və 100 cihaz məhdudiyyəti

UDID (Unique Device Identifier) hər iOS cihazının unikal identifikatorudur. Ad Hoc Distribution üçün bütün test cihazlarının UDID-lərini toplamaq və onları Apple Developer Portal-a əlavə etmək lazımdır. Maksimum say ildə tərtibatçı hesabına 100 cihazdır. Bu məhdudiyyət tərtibatçının bütün tətbiqlərinə aiddir, hər tətbiqə ayrıca deyil.

100 cihaz məhdudiyyəti təqvim ilinin sonunda sıfırlanır — sıfırlama 1 yanvarda baş verir. Bununla belə, Apple geniş miqyaslı sınaq üçün 10 000 xarici testçiyə qədər dəstəkləyən TestFlight-dan istifadə etməyi tövsiyə edir. Ad Hoc Distribution 2022-ci ildən etibarən tətbiqin hələ Beta App Review-dan keçmədiyi və ya sınaq üçün orijinal IPA faylına giriş tələb olunduğu hallarda aktual qalır.

Ad Hoc Distribution quraşdırılması

Quraşdırma Ad Hoc Distribution Apple Developer Portal və Xcode vasitəsilə həyata keçirilir. Proses cihazların qeydiyyatını, Provisioning Profile yaradılmasını, tətbiqin imzalanmasını və yayılma üçün IPA-nın ixracını əhatə edir. Komanda işləməsi üçün Fastlane və ya CI/CD vasitəsilə avtomatlaşdırmadan istifadə etmək tövsiyə olunur.

1. udid.io və ya konfiqurasiya profili vasitəsilə test cihazlarının UDID-lərini toplayın
2. UDID-ləri Apple Developer Portal → Certificates, Identifiers & Profiles → Devices bölməsində əlavə edin
3. Lazım olan Bundle ID üçün Ad Hoc Provisioning Profile yaradın, qeydiyyatdan keçmiş cihazları daxil edin
4. Xcode-da tətbiqi Ad Hoc profili ilə imzalayın: Product → Archive → Distribute Ad Hoc
5. IPA faylını ixrac edin və keçidi OTA serveri və ya Firebase App Distribution vasitəsilə yayın
6. İstifadəçi: cihazda keçidi açın, tətbiqi quraşdırın, parametrlərdə sertifikata etibar edin

Prosesi sadələşdirmək üçün yayılma xidmətlərindən istifadə olunur: Firebase App Distribution, Microsoft App Center və ya BuddyBuild. Bu xidmətlər avtomatik olaraq UDID-ləri idarə edir, Ad Hoc profilləri yaradır və testçilərə dəvətlər göndərir. Firebase App Distribution həmçinin Gradle və ya Fastlane vasitəsilə CI/CD boru xətti ilə inteqrasiya olunur.

Vacib nüans — UDID yeniləməsi. Profile yeni cihaz əlavə etmək lazımdırsa, Provisioning Profile-i yenidən yaratmalı və tətbiqi yenidən imzalamalısınız. Artıq tətbiqi quraşdırmış cihazlar profilin müddəti bitənə qədər (1 il) ondan istifadə etməyə davam edəcək. Bundan sonra yeni profillə yenidən quraşdırma tələb olunacaq.

Ad Hoc vs TestFlight və Enterprise

Ad Hoc Distribution App Store olmadan iOS tətbiqlərinin yayılmasının üç üsulundan yalnız biridir. TestFlight (pulsuz, 10 000 xarici testçiyə qədər) və Enterprise Distribution (cihaz məhdudiyyəti olmadan, korporativ tətbiqlər üçün) müxtəlif məhdudiyyətlər və tələblərlə oxşar vəzifələri həll edir.

TestFlight Apple-ın beta sınaq üçün üstünlük verdiyi üsuldur. O, UDID toplamaq tələb etmir, 100 daxili və 10 000 xarici testçiyə qədər dəstəkləyir, versiyaları avtomatik idarə edir və quraşdırma analitikası təqdim edir. Bununla belə, TestFlight xarici testçilər üçün Beta App Review-dan keçməyi tələb edir ki, bu da 1–2 gün çəkə bilər. Ad Hoc Distribution ümumiyyətlə moderasiya tələb etmir.

Enterprise Distribution korporativ tətbiqlər üçün uyğundur, limitsiz sayda cihazla, lakin D-U-N-S nömrəsi ilə Apple Developer Enterprise Program ($299/il) qeydiyyatı tələb edir. Ad Hoc standart proqramın bütün iştirakçıları üçün əlçatandır ($99/il) və şirkətin hüquqi təsdiqini tələb etmir. Kiçik komandalar və layihələr üçün Ad Hoc App Store olmadan ən sadə yayılma üsulu olaraq qalır.