Ad Hoc Distribution — какво е, ограничения за тестване на iOS

Какво е Ad Hoc Distribution?

Ad Hoc Distribution е метод за разпространение на iOS приложения, достъпен за всички участници в Apple Developer Program ($99/годишно). Той позволява инсталиране на приложения директно на устройства без преминаване през одобрение от App Store. Основното предназначение е тестване преди публикуване: разработчици, тестери и клиенти могат да инсталират приложението на своите устройства преди официалното пускане.

Ad Hoc Distribution използва Provisioning Profile, който включва списък с разрешени UDID устройства. При подписване на приложението Xcode или Fastlane създава IPA файл, който може да бъде инсталиран само на устройства от този списък. Всеки UDID се добавя чрез Apple Developer Portal и общият брой не може да надвишава 100 устройства на акаунт на разработчик.

Според данни на Apple (2025), Ad Hoc Distribution остава търсен за тестване преди пускане, когато приложението все още не е преминало одобрение от App Store, но вече трябва да бъде показано на клиента или тествано на реални устройства. Въпреки това, Apple препоръчва използването на TestFlight за мащабно бета тестване, оставяйки Ad Hoc за малки групи и специални случаи.

Как работи Ad Hoc разпространението?

Ad Hoc разпространението работи чрез механизма за OTA (Over-The-Air) инсталиране или чрез iTunes/Finder. Разработчикът създава Ad Hoc Provisioning Profile с избрани UDID, подписва приложението с този профил и експортира IPA файла. Потребителят инсталира приложението чрез Safari чрез връзка или чрез Finder на macOS.

Технически, Ad Hoc Distribution включва няколко етапа. Първо администраторът събира UDID на тестовите устройства — всеки UDID е уникален 40-символен идентификатор на iOS устройство. След това UDID се добавят в Apple Developer Portal, създава се Provisioning Profile и се генерира подписан IPA. Срокът на валидност на Ad Hoc профила е една година, след което приложенията спират да се отварят.

# Fastlane — автоматизиране на Ad Hoc разпространението
lane :adhoc do
    match(type: "adhoc")
    gym(scheme: "MyApp",
        export_method: "ad-hoc")
    pilot(
        distribute_only: true,
        devices_file: "./devices.txt"
    )
end

За да инсталира Ad Hoc приложение, потребителят трябва да се довери на сертификата на разработчика на своето устройство. За целта в настройките на iOS трябва да отиде в „Основни“ → „VPN и управление на устройство“ → „Профил“ и да натисне „Довери се“. Без тази стъпка приложението няма да се стартира.

UDID регистрация и ограничение до 100 устройства

UDID (Unique Device Identifier) е уникален идентификатор на всяко iOS устройство. За Ad Hoc Distribution трябва да се съберат UDID на всички тестови устройства и да се добавят в Apple Developer Portal. Максималният брой е 100 устройства на акаунт на разработчик годишно. Това ограничение се отнася за всички приложения на разработчика, а не за всяко приложение поотделно.

Ограничението от 100 устройства се нулира в края на календарната година — нулирането става на 1 януари. Въпреки това, Apple препоръчва за мащабно тестване използването на TestFlight, който поддържа до 10 000 външни тестери. Ad Hoc Distribution от 2022 г. остава актуален за случаи, когато приложението все още не е преминало Beta App Review или когато тестването изисква достъп до оригиналния IPA файл.

Настройка на Ad Hoc Distribution

Настройката на Ad Hoc Distribution се извършва чрез Apple Developer Portal и Xcode. Процесът включва регистриране на устройства, създаване на Provisioning Profile, подписване на приложението и експортиране на IPA за разпространение. За екипна разработка се препоръчва използването на Fastlane или автоматизация чрез CI/CD.

1. Съберете UDID на тестовите устройства чрез udid.io или конфигурационен профил
2. Добавете UDID в Apple Developer Portal → Certificates, Identifiers & Profiles → Devices
3. Създайте Ad Hoc Provisioning Profile за желания Bundle ID, включвайки регистрираните устройства
4. Подпишете приложението с Ad Hoc профила в Xcode: Product → Archive → Distribute Ad Hoc
5. Експортирайте IPA файла и разпространете връзката чрез OTA сървър или Firebase App Distribution
6. Потребител: отворете връзката на устройството, инсталирайте приложението, доверете се на сертификата в настройките

За опростяване на процеса се използват услуги за разпространение: Firebase App Distribution, Microsoft App Center или BuddyBuild. Тези услуги автоматично управляват UDID, създават Ad Hoc профили и изпращат покани на тестери. Firebase App Distribution също се интегрира с CI/CD тръбопровода чрез Gradle или Fastlane.

Важен нюанс — актуализиране на UDID. Ако трябва да добавите ново устройство към профила, ще трябва да пресъздадете Provisioning Profile и да подпишете отново приложението. Устройствата, които вече са инсталирали приложението, ще продължат да го използват до изтичане на профила (1 година). След това се изисква преинсталиране с новия профил.

Ad Hoc срещу TestFlight и Enterprise

Ad Hoc Distribution е само един от трите начина за разпространение на iOS приложения без App Store. TestFlight (безплатен, до 10 000 външни тестери) и Enterprise Distribution (без ограничение на устройства, за корпоративни приложения) решават подобни задачи с различни ограничения и изисквания.

TestFlight е предпочитаният метод на Apple за бета тестване. Той не изисква събиране на UDID, поддържа до 100 вътрешни и 10 000 външни тестери, автоматично управлява версиите и предоставя анализ на инсталациите. Въпреки това, TestFlight изисква преминаване през Beta App Review за външни тестери, което може да отнеме 1–2 дни. Ad Hoc Distribution не изисква никакво одобрение.

Enterprise Distribution е подходящ за корпоративни приложения с неограничен брой устройства, но изисква регистрация в Apple Developer Enterprise Program ($299/годишно) с D-U-N-S номер. Ad Hoc е достъпен за всички участници в стандартната програма ($99/годишно) и не изисква правно потвърждение на компанията. За малки екипи и проекти Ad Hoc остава най-простият начин за разпространение без App Store.