Ad Hoc Distribution — ce este, limitări ale testării iOS

Ce este Ad Hoc Distribution?

Ad Hoc Distribution este o metodă de distribuire a aplicațiilor iOS disponibilă tuturor participanților la Apple Developer Program ($99/an). Permite instalarea aplicațiilor direct pe dispozitive fără a trece prin moderarea App Store. Scopul principal este testarea înainte de publicare: dezvoltatorii, testerii și clienții pot instala aplicația pe propriile dispozitive înainte de lansarea oficială.

Ad Hoc Distribution utilizează un Provisioning Profile care include lista UDID-urilor de dispozitive permise. La semnarea aplicației, Xcode sau Fastlane creează un fișier IPA care poate fi instalat doar pe dispozitivele din această listă. Fiecare UDID este adăugat prin Apple Developer Portal, iar numărul total nu poate depăși 100 de dispozitive per cont de dezvoltator.

Conform datelor Apple (2025), Ad Hoc Distribution rămâne utilizat pentru testarea pre-lansare când aplicația nu a trecut încă de moderarea App Store, dar trebuie deja arătată clientului sau testată pe dispozitive reale. Cu toate acestea, Apple recomandă utilizarea TestFlight pentru testarea beta la scară largă, lăsând Ad Hoc pentru grupuri mici și cazuri speciale.

Cum funcționează distribuirea Ad Hoc?

Distribuirea Ad Hoc funcționează prin mecanismul de instalare OTA (Over-The-Air) sau prin iTunes/Finder. Dezvoltatorul creează un Ad Hoc Provisioning Profile cu UDID-urile selectate, semnează aplicația cu acest profil și exportă fișierul IPA. Utilizatorul instalează aplicația prin Safari printr-un link sau prin Finder pe macOS.

Din punct de vedere tehnic, Ad Hoc Distribution include mai multe etape. Mai întâi, administratorul colectează UDID-urile dispozitivelor de test — fiecare UDID este un identificator unic de 40 de caractere al dispozitivului iOS. Apoi, UDID-urile sunt adăugate în Apple Developer Portal, se creează un Provisioning Profile și se generează un IPA semnat. Perioada de valabilitate a profilului Ad Hoc este de un an, după care aplicațiile nu se mai deschid.

# Fastlane — automatizarea distribuției Ad Hoc
lane :adhoc do
    match(type: "adhoc")
    gym(scheme: "MyApp",
        export_method: "ad-hoc")
    pilot(
        distribute_only: true,
        devices_file: "./devices.txt"
    )
end

Pentru a instala aplicația Ad Hoc, utilizatorul trebuie să aibă încredere în certificatul dezvoltatorului pe dispozitivul său. Pentru aceasta, în setările iOS trebuie să meargă la „General” → „VPN și gestionare dispozitiv” → „Profil” și să apese „Aprobă”. Fără acest pas, aplicația nu se va lansa.

Înregistrarea UDID și limita de 100 de dispozitive

UDID (Unique Device Identifier) este un identificator unic al fiecărui dispozitiv iOS. Pentru Ad Hoc Distribution, trebuie colectate UDID-urile tuturor dispozitivelor de test și adăugate în Apple Developer Portal. Numărul maxim este de 100 de dispozitive per cont de dezvoltator pe an. Această limitare se aplică tuturor aplicațiilor dezvoltatorului, nu fiecărei aplicații în parte.

Limita de 100 de dispozitive se resetează la sfârșitul anului calendaristic — resetarea are loc pe 1 ianuarie. Cu toate acestea, Apple recomandă pentru testarea la scară largă utilizarea TestFlight, care suportă până la 10 000 de testeri externi. Ad Hoc Distribution rămâne relevant din 2022 pentru cazurile în care aplicația nu a trecut încă de Beta App Review sau când testarea necesită acces la fișierul IPA original.

Configurarea Ad Hoc Distribution

Configurarea Ad Hoc Distribution se realizează prin Apple Developer Portal și Xcode. Procesul include înregistrarea dispozitivelor, crearea unui Provisioning Profile, semnarea aplicației și exportarea IPA pentru distribuire. Pentru dezvoltarea în echipă, se recomandă utilizarea Fastlane sau automatizarea prin CI/CD.

1. Colectați UDID-urile dispozitivelor de test prin udid.io sau un profil de configurare
2. Adăugați UDID-urile în Apple Developer Portal → Certificates, Identifiers & Profiles → Devices
3. Creați un Ad Hoc Provisioning Profile pentru Bundle ID-ul dorit, incluzând dispozitivele înregistrate
4. Semnați aplicația cu profilul Ad Hoc în Xcode: Product → Archive → Distribute Ad Hoc
5. Exportați fișierul IPA și distribuiți linkul prin server OTA sau Firebase App Distribution
6. Utilizatorul: deschide linkul pe dispozitiv, instalează aplicația, aprobă certificatul în setări

Pentru simplificarea procesului, se utilizează servicii de distribuire: Firebase App Distribution, Microsoft App Center sau BuddyBuild. Aceste servicii gestionează automat UDID-urile, creează profiluri Ad Hoc și trimit invitații testerilor. Firebase App Distribution se integrează și cu pipeline-ul CI/CD prin Gradle sau Fastlane.

Un aspect important — actualizarea UDID. Dacă trebuie adăugat un nou dispozitiv în profil, va trebui recreat Provisioning Profile-ul și re-semnată aplicația. Dispozitivele care au instalat deja aplicația o vor putea folosi până la expirarea profilului (1 an). După aceea, este necesară reinstalarea cu noul profil.

Ad Hoc vs TestFlight și Enterprise

Ad Hoc Distribution este doar una dintre cele trei metode de distribuire a aplicațiilor iOS fără App Store. TestFlight (gratuit, până la 10 000 de testeri externi) și Enterprise Distribution (fără limitare de dispozitive, pentru aplicații corporative) rezolvă sarcini similare cu limitări și cerințe diferite.

TestFlight este metoda preferată de Apple pentru testarea beta. Nu necesită colectarea UDID-urilor, suportă până la 100 de testeri interni și 10 000 externi, gestionează automat versiunile și oferă analitică a instalărilor. Cu toate acestea, TestFlight necesită trecerea prin Beta App Review pentru testerii externi, ceea ce poate dura 1–2 zile. Ad Hoc Distribution nu necesită deloc moderare.

Enterprise Distribution este potrivită pentru aplicații corporative cu un număr nelimitat de dispozitive, dar necesită înregistrarea în Apple Developer Enterprise Program ($299/an) cu un număr D-U-N-S. Ad Hoc este accesibil tuturor participanților la programul standard ($99/an) și nu necesită confirmare juridică a companiei. Pentru echipe și proiecte mici, Ad Hoc rămâne cea mai simplă metodă de distribuire fără App Store.