Ad Hoc Distribution — mi ez, iOS tesztelés korlátai

Mi az Ad Hoc Distribution?

Az Ad Hoc Distribution egy iOS-alkalmazások terjesztésére szolgáló módszer, amely az Apple Developer Program ($99/év) minden résztvevője számára elérhető. Lehetővé teszi alkalmazások közvetlen telepítését eszközökre anélkül, hogy át kellene esni az App Store moderáción. Fő cél — közzététel előtti tesztelés: a fejlesztők, tesztelők és ügyfelek telepíthetik az alkalmazást saját eszközeikre a hivatalos megjelenés előtt.

Az Ad Hoc Distribution egy Provisioning Profile-t használ, amely tartalmazza a engedélyezett UDID eszközök listáját. Az alkalmazás aláírásakor az Xcode vagy Fastlane létrehoz egy IPA fájlt, amely csak a lista eszközeire telepíthető. Minden UDID az Apple Developer Portalon keresztül kerül hozzáadásra, és a teljes szám nem haladhatja meg a 100 eszközt fejlesztői fiókonként.

Az Apple (2025) adatai szerint az Ad Hoc Distribution továbbra is használatos a megjelenés előtti teszteléshez, amikor az alkalmazás még nem ment át az App Store moderáción, de már meg kell mutatni az ügyfélnek vagy valós eszközökön kell tesztelni. Az Apple azonban a TestFlight használatát ajánlja nagyszabású béta teszteléshez, az Ad Hoc-ot kis csoportok és speciális esetek számára megtartva.

Hogyan működik az Ad Hoc terjesztés?

Az Ad Hoc terjesztés az OTA (Over-The-Air) telepítési mechanizmuson vagy az iTunes/Finderen keresztül működik. A fejlesztő létrehoz egy Ad Hoc Provisioning Profile-t a kiválasztott UDID-ekkel, aláírja az alkalmazást ezzel a profillal, és exportálja az IPA fájlt. A felhasználó az alkalmazást Safarin keresztül egy linkkel vagy a Finderen keresztül macOS-en telepíti.

Technikailag az Ad Hoc Distribution több szakaszból áll. Először a rendszergazda összegyűjti a teszteszközök UDID-jeit — minden UDID egy egyedi 40 karakteres iOS-eszköz azonosító. Ezután a UDID-k hozzáadásra kerülnek az Apple Developer Portalhoz, létrejön a Provisioning Profile, és létrejön az aláírt IPA. Az Ad Hoc profil érvényességi ideje egy év, utána az alkalmazások nem nyílnak meg.

# Fastlane — az Ad Hoc terjesztés automatizálása
lane :adhoc do
    match(type: "adhoc")
    gym(scheme: "MyApp",
        export_method: "ad-hoc")
    pilot(
        distribute_only: true,
        devices_file: "./devices.txt"
    )
end

Az Ad Hoc alkalmazás telepítéséhez a felhasználónak meg kell bíznia a fejlesztői tanúsítványban az eszközén. Ehhez az iOS beállításokban lépjen az „Általános” → „VPN és eszközkezelés” → „Profil” menüpontba, és nyomja meg a „Megbízom” gombot. E lépés nélkül az alkalmazás nem indul el.

UDID regisztráció és 100 eszközös korlátozás

Az UDID (Unique Device Identifier) minden iOS-eszköz egyedi azonosítója. Az Ad Hoc Distributionhoz össze kell gyűjteni az összes teszteszköz UDID-jét, és hozzáadni az Apple Developer Portalhoz. A maximális szám 100 eszköz fejlesztői fiókonként évente. Ez a korlátozás a fejlesztő összes alkalmazására vonatkozik, nem minden alkalmazásra külön-külön.

A 100 eszközös korlátozás a naptári év végén alaphelyzetbe áll — a reset január 1-jén történik. Az Apple azonban nagyszabású teszteléshez a TestFlight használatát ajánlja, amely akár 10 000 külső tesztelőt is támogat. Az Ad Hoc Distribution 2022-től kezdve azokban az esetekben maradt releváns, amikor az alkalmazás még nem ment át a Beta App Review-n, vagy amikor a tesztelés hozzáférést igényel az eredeti IPA fájlhoz.

Az Ad Hoc Distribution beállítása

Az Ad Hoc Distribution beállítása az Apple Developer Portalon és Xcode-on keresztül történik. A folyamat magában foglalja az eszközök regisztrálását, a Provisioning Profile létrehozását, az alkalmazás aláírását és az IPA exportálását terjesztéshez. Csapatfejlesztéshez a Fastlane vagy a CI/CD-n keresztüli automatizálás használata ajánlott.

1. Gyűjtse össze a teszteszközök UDID-jeit az udid.io-n vagy konfigurációs profilon keresztül
2. Adja hozzá a UDID-ket az Apple Developer Portal → Certificates, Identifiers & Profiles → Devices menüpontban
3. Hozzon létre Ad Hoc Provisioning Profile-t a kívánt Bundle ID-hoz, beleértve a regisztrált eszközöket
4. Írja alá az alkalmazást az Ad Hoc profillal az Xcode-ban: Product → Archive → Distribute Ad Hoc
5. Exportálja az IPA fájlt, és terjessze a linket OTA szerveren vagy Firebase App Distributionön keresztül
6. Felhasználó: nyissa meg a linket az eszközön, telepítse az alkalmazást, bízzon meg a tanúsítványban a beállításokban

A folyamat egyszerűsítéséhez terjesztési szolgáltatásokat használnak: Firebase App Distribution, Microsoft App Center vagy BuddyBuild. Ezek a szolgáltatások automatikusan kezelik a UDID-ket, létrehozzák az Ad Hoc profilokat, és meghívókat küldenek a tesztelőknek. A Firebase App Distribution a CI/CD pipeline-nal is integrálódik a Gradle vagy Fastlane segítségével.

Fontos árnyalat — UDID frissítése. Ha új eszközt kell hozzáadni a profilhoz, újra kell hozni a Provisioning Profile-t, és újra kell írni az alkalmazást. Azok az eszközök, amelyek már telepítették az alkalmazást, továbbra is használhatják a profil lejáratáig (1 év). Ezután újratelepítés szükséges az új profillal.

Ad Hoc vs TestFlight és Enterprise

Az Ad Hoc Distribution csak egy a három iOS-alkalmazás App Store nélküli terjesztési módja közül. A TestFlight (ingyenes, akár 10 000 külső tesztelővel) és az Enterprise Distribution (eszközkorlátozás nélkül, vállalati alkalmazásokhoz) hasonló feladatokat oldanak meg különböző korlátozásokkal és követelményekkel.

A TestFlight az Apple által preferált módszer a béta teszteléshez. Nem igényel UDID gyűjtést, akár 100 belső és 10 000 külső tesztelőt támogat, automatikusan kezeli a verziókat, és telepítési analitikát biztosít. A TestFlight azonban Beta App Review-t igényel a külső tesztelőkhöz, ami 1–2 napig is eltarthat. Az Ad Hoc Distribution egyáltalán nem igényel moderációt.

Az Enterprise Distribution vállalati alkalmazásokhoz alkalmas, korlátlan számú eszközzel, de regisztrációt igényel az Apple Developer Enterprise Programban ($299/év) D-U-N-S számmal. Az Ad Hoc a standard program minden résztvevője számára elérhető ($99/év), és nem igényel jogi megerősítést a cégtől. Kis csapatok és projektek számára az Ad Hoc marad a legegyszerűbb terjesztési mód App Store nélkül.