Ad Hoc Distribution — ano ito, mga limitasyon ng pagsubok sa iOS

Ano ang Ad Hoc Distribution?

Ad Hoc Distribution ay isang paraan ng pamamahagi ng mga iOS app na available sa lahat ng miyembro ng Apple Developer Program ($99/taon). Pinapayagan nito ang pag-install ng mga app nang direkta sa mga device nang hindi dumadaan sa moderasyon ng App Store. Pangunahing layunin — pagsubok bago ilathala: mga developer, tester at kliyente ay maaaring mag-install ng app sa kanilang mga device bago ang opisyal na paglabas.

Ang Ad Hoc Distribution ay gumagamit ng Provisioning Profile na naglalaman ng listahan ng mga pinapayagang UDID device. Kapag nag-sign ng app, ang Xcode o Fastlane ay gumagawa ng IPA file na maaari lamang i-install sa mga device mula sa listahang ito. Bawat UDID ay idinaragdag sa pamamagitan ng Apple Developer Portal, at ang kabuuang bilang ay hindi maaaring lumampas sa 100 device bawat developer account.

Ayon sa datos ng Apple (2025), ang Ad Hoc Distribution ay nananatiling ginagamit para sa pre-release testing kapag ang app ay hindi pa dumaan sa moderasyon ng App Store, ngunit kailangan nang ipakita sa kliyente o subukan sa mga tunay na device. Gayunpaman, inirerekomenda ng Apple ang paggamit ng TestFlight para sa malawakang beta testing, na iniiwan ang Ad Hoc para sa maliliit na grupo at mga espesyal na kaso.

Paano gumagana ang pamamahagi ng Ad Hoc?

Ang pamamahagi ng Ad Hoc ay gumagana sa pamamagitan ng mekanismo ng OTA (Over-The-Air) na pag-install o sa pamamagitan ng iTunes/Finder. Gumagawa ang developer ng Ad Hoc Provisioning Profile na may mga napiling UDID, pinipirmahan ang app gamit ang profile na ito, at ini-export ang IPA file. Ini-install ng user ang app sa pamamagitan ng Safari gamit ang link o sa pamamagitan ng Finder sa macOS.

Sa teknikal na aspeto, ang Ad Hoc Distribution ay may ilang yugto. Una, kinokolekta ng administrator ang mga UDID ng mga test device — bawat UDID ay isang natatanging 40-character na identifier ng iOS device. Pagkatapos, ang mga UDID ay idinaragdag sa Apple Developer Portal, gumagawa ng Provisioning Profile, at bumubuo ng sign na IPA. Ang tagal ng bisa ng Ad Hoc profile ay isang taon, pagkatapos nito ang mga app ay hihinto sa pagbubukas.

# Fastlane — i-automate ang Ad Hoc Distribution
lane :adhoc do
    match(type: "adhoc")
    gym(scheme: "MyApp",
        export_method: "ad-hoc")
    pilot(
        distribute_only: true,
        devices_file: "./devices.txt"
    )
end

Upang mag-install ng Ad Hoc app, dapat pagkatiwalaan ng user ang certificate ng developer sa kanilang device. Para dito, sa mga setting ng iOS, pumunta sa „General“ → „VPN at Device Management“ → „Profile“ at pindutin ang „Trust“. Kung wala ang hakbang na ito, hindi magbubukas ang app.

Pagrehistro ng UDID at limitasyon sa 100 device

Ang UDID (Unique Device Identifier) ay isang natatanging identifier ng bawat iOS device. Para sa Ad Hoc Distribution, kailangan mong kolektahin ang mga UDID ng lahat ng test device at idagdag ang mga ito sa Apple Developer Portal. Ang maximum na bilang ay 100 device bawat developer account bawat taon. Ang limitasyong ito ay nalalapat sa lahat ng app ng developer, hindi sa bawat app nang hiwalay.

Ang limitasyon sa 100 device ay nirereseat sa katapusan ng taon ng kalendaryo — ang pag-reset ay magaganap sa Enero 1. Gayunpaman, inirerekomenda ng Apple para sa malawakang pagsubok ang paggamit ng TestFlight, na sumusuporta sa hanggang 10,000 panlabas na tester. Ang Ad Hoc Distribution mula noong 2022 ay nananatiling may kaugnayan para sa mga kaso kung saan ang app ay hindi pa dumaan sa Beta App Review o kapag ang pagsubok ay nangangailangan ng access sa orihinal na IPA file.

Pag-set up ng Ad Hoc Distribution

Ang pag-set up ng Ad Hoc Distribution ay ginagawa sa pamamagitan ng Apple Developer Portal at Xcode. Kasama sa proseso ang pagrehistro ng mga device, paggawa ng Provisioning Profile, pagpirma sa app, at pag-export ng IPA para sa pamamahagi. Para sa pag-develop ng team, inirerekomenda ang paggamit ng Fastlane o automation sa pamamagitan ng CI/CD.

1. Kolektahin ang mga UDID ng test device sa pamamagitan ng udid.io o configuration profile
2. Idagdag ang mga UDID sa Apple Developer Portal → Certificates, Identifiers & Profiles → Devices
3. Gumawa ng Ad Hoc Provisioning Profile para sa nais na Bundle ID, kasama ang mga naka-rehistrong device
4. Pirmahan ang app gamit ang Ad Hoc profile sa Xcode: Product → Archive → Distribute Ad Hoc
5. I-export ang IPA file at ipamahagi ang link sa pamamagitan ng OTA server o Firebase App Distribution
6. User: buksan ang link sa device, i-install ang app, pagkatiwalaan ang certificate sa mga setting

Upang gawing simple ang proseso, ginagamit ang mga serbisyo ng pamamahagi: Firebase App Distribution, Microsoft App Center o BuddyBuild. Ang mga serbisyong ito ay awtomatikong namamahala ng mga UDID, gumagawa ng mga Ad Hoc profile, at nagpapadala ng mga imbitasyon sa mga tester. Ang Firebase App Distribution ay sumasama rin sa CI/CD pipeline sa pamamagitan ng Gradle o Fastlane.

Isang mahalagang nuance — pag-update ng UDID. Kung kailangan magdagdag ng bagong device sa profile, kakailanganing muling likhain ang Provisioning Profile at muling pirmahan ang app. Ang mga device na naka-install na ang app ay patuloy na gagamit nito hanggang sa mag-expire ang profile (1 taon). Pagkatapos nito, kinakailangan ang muling pag-install gamit ang bagong profile.

Ad Hoc vs TestFlight at Enterprise

Ang Ad Hoc Distribution ay isa lamang sa tatlong paraan ng pamamahagi ng iOS app nang walang App Store. Ang TestFlight (libre, hanggang 10,000 panlabas na tester) at Enterprise Distribution (walang limitasyon sa device, para sa corporate app) ay nilulutas ang mga katulad na gawain na may iba't ibang limitasyon at kinakailangan.

Ang TestFlight ay ang ginustong paraan ng Apple para sa beta testing. Hindi ito nangangailangan ng pangongolekta ng UDID, sumusuporta sa hanggang 100 panloob at 10,000 panlabas na tester, awtomatikong namamahala ng mga bersyon, at nagbibigay ng analytics sa pag-install. Gayunpaman, ang TestFlight ay nangangailangan ng Beta App Review para sa mga panlabas na tester, na maaaring tumagal ng 1–2 araw. Ang Ad Hoc Distribution ay hindi nangangailangan ng anumang moderasyon.

Ang Enterprise Distribution ay angkop para sa corporate app na walang limitasyon sa bilang ng device, ngunit nangangailangan ng pagrehistro sa Apple Developer Enterprise Program ($299/taon) na may D-U-N-S number. Ang Ad Hoc ay available sa lahat ng kalahok sa standard program ($99/taon) at hindi nangangailangan ng legal na kumpirmasyon ng kumpanya. Para sa maliliit na team at proyekto, ang Ad Hoc ay nananatiling pinakasimpleng paraan ng pamamahagi nang walang App Store.