Ad Hoc Distribution — wat is het, beperkingen van iOS testen

Wat is Ad Hoc Distribution?

Ad Hoc Distribution is een methode voor het distribueren van iOS-apps die beschikbaar is voor alle deelnemers aan het Apple Developer Program ($99/jaar). Hiermee kunnen apps rechtstreeks op apparaten worden geïnstalleerd zonder App Store-goedkeuring. Het belangrijkste doel is testen vóór publicatie: ontwikkelaars, testers en klanten kunnen de app op hun eigen apparaten installeren vóór de officiële release.

Ad Hoc Distribution maakt gebruik van een Provisioning Profile dat de lijst met toegestane UDID-apparaten bevat. Bij het ondertekenen van de app maken Xcode of Fastlane een IPA-bestand dat alleen kan worden geïnstalleerd op apparaten uit deze lijst. Elke UDID wordt toegevoegd via de Apple Developer Portal en het totale aantal mag niet meer dan 100 apparaten per ontwikkelaarsaccount bedragen.

Volgens Apple-gegevens (2025) blijft Ad Hoc Distribution relevant voor pre-release testen wanneer de app nog niet door de App Store-goedkeuring is gegaan, maar al wel aan de klant moet worden getoond of op echte apparaten moet worden getest. Apple raadt echter aan om TestFlight te gebruiken voor grootschalige bètatesten en Ad Hoc te bewaren voor kleine groepen en speciale gevallen.

Hoe werkt Ad Hoc-distributie?

Ad Hoc-distributie werkt via OTA-installatie (Over-The-Air) of via iTunes/Finder. De ontwikkelaar maakt een Ad Hoc Provisioning Profile met geselecteerde UDID's, ondertekent de app met dit profiel en exporteert het IPA-bestand. De gebruiker installeert de app via Safari via een link of via Finder op macOS.

Technisch gezien omvat Ad Hoc Distribution verschillende fasen. Eerst verzamelt de beheerder de UDID's van de testapparaten — elke UDID is een unieke 40-karakter identificeerder van het iOS-apparaat. Vervolgens worden de UDID's toegevoegd aan de Apple Developer Portal, wordt een Provisioning Profile aangemaakt en wordt een ondertekende IPA gegenereerd. De geldigheidsduur van het Ad Hoc-profiel is één jaar, waarna apps niet meer openen.

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

Om een Ad Hoc-app te installeren, moet de gebruiker het ontwikkelaarscertificaat op zijn apparaat vertrouwen. Ga hiervoor in de iOS-instellingen naar „Algemeen“ → „VPN en apparaatbeheer“ → „Profiel“ en tik op „Vertrouw“. Zonder deze stap wordt de app niet gestart.

UDID-registratie en limiet van 100 apparaten

UDID (Unique Device Identifier) is een unieke identificatie van elk iOS-apparaat. Voor Ad Hoc Distribution moeten de UDID's van alle testapparaten worden verzameld en toegevoegd aan de Apple Developer Portal. Het maximum is 100 apparaten per ontwikkelaarsaccount per jaar. Deze beperking geldt voor alle apps van de ontwikkelaar, niet voor elke app afzonderlijk.

De limiet van 100 apparaten wordt aan het einde van het kalenderjaar gereset — reset vindt plaats op 1 januari. Apple raadt echter voor grootschalig testen aan om TestFlight te gebruiken, dat tot 10.000 externe testers ondersteunt. Ad Hoc Distribution blijft sinds 2022 relevant voor gevallen waarin de app nog geen Beta App Review heeft doorlopen of wanneer testen toegang tot het originele IPA-bestand vereist.

Ad Hoc Distribution instellen

Het instellen van Ad Hoc Distribution gebeurt via de Apple Developer Portal en Xcode. Het proces omvat het registreren van apparaten, het aanmaken van een Provisioning Profile, het ondertekenen van de app en het exporteren van IPA voor distributie. Voor teamontwikkeling wordt Fastlane of automatisering via CI/CD aanbevolen.

1. Verzamel UDID's van testapparaten via udid.io of een configuratieprofiel
2. Voeg UDID's toe in Apple Developer Portal → Certificates, Identifiers & Profiles → Devices
3. Maak een Ad Hoc Provisioning Profile voor de gewenste Bundle ID, inclusief geregistreerde apparaten
4. Onderteken de app met het Ad Hoc-profiel in Xcode: Product → Archive → Distribute Ad Hoc
5. Exporteer het IPA-bestand en verspreid de link via een OTA-server of Firebase App Distribution
6. Gebruiker: open de link op het apparaat, installeer de app, vertrouw het certificaat in instellingen

Om het proces te vereenvoudigen worden distributiediensten gebruikt: Firebase App Distribution, Microsoft App Center of BuddyBuild. Deze diensten beheren automatisch UDID's, maken Ad Hoc-profielen aan en sturen uitnodigingen naar testers. Firebase App Distribution integreert ook met CI/CD-pipelines via Gradle of Fastlane.

Een belangrijke nuance — UDID bijwerken. Als er een nieuw apparaat aan het profiel moet worden toegevoegd, moet het Provisioning Profile opnieuw worden aangemaakt en de app opnieuw worden ondertekend. Apparaten die de app al hebben geïnstalleerd, kunnen deze blijven gebruiken tot het profiel verloopt (1 jaar). Daarna is herinstallatie met het nieuwe profiel vereist.

Ad Hoc vs TestFlight en Enterprise

Ad Hoc Distribution is slechts een van de drie manieren om iOS-apps zonder App Store te distribueren. TestFlight (gratis, tot 10.000 externe testers) en Enterprise Distribution (zonder apparaatlimiet, voor bedrijfsapps) lossen vergelijkbare taken op met verschillende beperkingen en vereisten.

TestFlight is de door Apple geprefereerde methode voor bètatesten. Het vereist geen UDID-verzameling, ondersteunt tot 100 interne en 10.000 externe testers, beheert automatisch versies en biedt installatie-analyses. TestFlight vereist echter wel Beta App Review voor externe testers, wat 1–2 dagen kan duren. Ad Hoc Distribution heeft helemaal geen goedkeuring nodig.

Enterprise Distribution is geschikt voor bedrijfsapps met een onbeperkt aantal apparaten, maar vereist registratie in het Apple Developer Enterprise Program ($299/jaar) met een D-U-N-S-nummer. Ad Hoc is toegankelijk voor alle deelnemers aan het standaardprogramma ($99/jaar) en vereist geen juridische bevestiging van het bedrijf. Voor kleine teams en projecten blijft Ad Hoc de eenvoudigste distributiemethode zonder App Store.