Ad Hoc Distribution — Was es ist, Einschränkungen bei iOS-Tests

Was ist Ad Hoc Distribution?

Ad Hoc Distribution ist eine Methode zur Verteilung von iOS-Apps, die allen Mitgliedern des Apple Developer Program ($99/Jahr) zur Verfügung steht. Sie ermöglicht die Installation von Apps direkt auf Geräten ohne die App Store-Moderation. Der Hauptzweck sind Pre-Release-Tests: Entwickler, Tester und Kunden können die App vor der offiziellen Veröffentlichung auf ihren Geräten installieren.

Ad Hoc Distribution verwendet ein Provisioning Profile, das eine Liste der zugelassenen Geräte-UDIDs enthält. Beim Signieren der App erstellt Xcode oder Fastlane eine IPA-Datei, die nur auf Geräten aus dieser Liste installiert werden kann. Jede UDID wird über das Apple Developer Portal hinzugefügt, und die Gesamtzahl darf 100 Geräte pro Entwicklerkonto nicht überschreiten.

Laut Apple (2025) ist Ad Hoc Distribution weiterhin für Pre-Release-Tests gefragt, wenn die App noch nicht die App Store-Moderation durchlaufen hat, aber bereits einem Kunden gezeigt oder auf echten Geräten getestet werden muss. Apple empfiehlt jedoch die Verwendung von TestFlight für umfangreiche Beta-Tests und lässt Ad Hoc für kleine Gruppen und Sonderfälle.

Wie funktioniert die Ad Hoc-Verteilung?

Die Ad Hoc-Verteilung funktioniert über OTA-Installation (Over-The-Air) oder über iTunes/Finder. Der Entwickler erstellt ein Ad Hoc Provisioning Profile mit ausgewählten UDIDs, signiert die App mit diesem Profil und exportiert die IPA-Datei. Der Benutzer installiert die App über Safari über einen Link oder über den Finder auf macOS.

Technisch umfasst die Ad Hoc-Verteilung mehrere Phasen. Zunächst sammelt der Administrator die UDIDs der Testgeräte — jede UDID ist eine eindeutige 40-stellige Kennung für ein iOS-Gerät. Dann werden die UDIDs zum Apple Developer Portal hinzugefügt, ein Provisioning Profile wird erstellt und eine signierte IPA wird generiert. Die Gültigkeit eines Ad Hoc-Profils beträgt ein Jahr, danach lassen sich die Apps nicht mehr öffnen.

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

Um eine Ad Hoc-App zu installieren, muss der Benutzer dem Entwicklerzertifikat auf seinem Gerät vertrauen. Dazu gehen Sie in den iOS-Einstellungen zu „Allgemein" → „VPN & Geräteverwaltung" → „Profil" und tippen auf „Vertrauen". Ohne diesen Schritt wird die App nicht gestartet.

UDID-Registrierung und das Limit von 100 Geräten

UDID (Unique Device Identifier) ist eine eindeutige Kennung für jedes iOS-Gerät. Für die Ad Hoc-Verteilung müssen Sie die UDIDs aller Testgeräte sammeln und zum Apple Developer Portal hinzufügen. Das Maximum beträgt 100 Geräte pro Entwicklerkonto pro Jahr. Diese Beschränkung gilt für alle Apps des Entwicklers, nicht für jede App einzeln.

Das Limit von 100 Geräten wird am Ende des Kalenderjahres zurückgesetzt — der Reset erfolgt am 1. Januar. Apple empfiehlt jedoch für umfangreiche Tests die Verwendung von TestFlight, das bis zu 10.000 externe Tester unterstützt. Ad Hoc Distribution bleibt seit 2022 relevant für Fälle, in denen die App noch nicht die Beta App Review durchlaufen hat oder wenn Tests Zugriff auf die originale IPA-Datei erfordern.

Einrichtung von Ad Hoc Distribution

Die Einrichtung von Ad Hoc Distribution erfolgt über das Apple Developer Portal und Xcode. Der Prozess umfasst die Registrierung von Geräten, die Erstellung eines Provisioning Profiles, das Signieren der App und den Export der IPA zur Verteilung. Für die Teamentwicklung wird die Verwendung von Fastlane oder die Automatisierung über CI/CD empfohlen.

1. Sammeln Sie die UDIDs der Testgeräte über udid.io oder ein Konfigurationsprofil
2. Fügen Sie die UDIDs im Apple Developer Portal hinzu → Certificates, Identifiers & Profiles → Devices
3. Erstellen Sie ein Ad Hoc Provisioning Profile für die erforderliche Bundle-ID, einschließlich der registrierten Geräte
4. Signieren Sie die App mit dem Ad Hoc-Profil in Xcode: Product → Archive → Distribute Ad Hoc
5. Exportieren Sie die IPA-Datei und verteilen Sie den Link über einen OTA-Server oder Firebase App Distribution
6. Für den Benutzer: Link auf dem Gerät öffnen, App installieren, dem Zertifikat in den Einstellungen vertrauen

Zur Vereinfachung des Prozesses werden Verteilungsdienste verwendet: Firebase App Distribution, Microsoft App Center oder BuddyBuild. Diese Dienste verwalten UDIDs automatisch, erstellen Ad Hoc-Profile und senden Einladungen an Tester. Firebase App Distribution integriert sich auch über Gradle oder Fastlane in CI/CD-Pipelines.

Eine wichtige Nuance — UDID-Updates. Wenn Sie ein neues Gerät zum Profil hinzufügen müssen, müssen Sie das Provisioning Profile neu erstellen und die App neu signieren. Geräte, die die App bereits installiert haben, können sie bis zum Ablauf des Profils (1 Jahr) weiterhin nutzen. Danach ist eine Neuinstallation mit einem neuen Profil erforderlich.

Ad Hoc vs. TestFlight und Enterprise

Ad Hoc Distribution ist nur eine von drei Methoden zur Verteilung von iOS-Apps ohne den App Store. TestFlight (kostenlos, bis zu 10.000 externe Tester) und Enterprise Distribution (keine Gerätebeschränkung, für Unternehmens-Apps) lösen ähnliche Aufgaben mit unterschiedlichen Einschränkungen und Anforderungen.

TestFlight ist die von Apple bevorzugte Methode für Beta-Tests. Es erfordert kein Sammeln von UDIDs, unterstützt bis zu 100 interne und 10.000 externe Tester, verwaltet Versionen automatisch und bietet Installationsanalysen. Allerdings erfordert TestFlight für externe Tester die Beta App Review, die 1–2 Tage dauern kann. Ad Hoc Distribution erfordert überhaupt keine Moderation.

Enterprise Distribution eignet sich für Unternehmens-Apps mit unbegrenzter Geräteanzahl, erfordert jedoch die Registrierung im Apple Developer Enterprise Program ($299/Jahr) mit einer D-U-N-S-Nummer. Ad Hoc ist allen Mitgliedern des Standardprogramms ($99/Jahr) zugänglich und erfordert keine rechtliche Überprüfung des Unternehmens. Für kleine Teams und Projekte bleibt Ad Hoc der einfachste Weg zur Verteilung ohne den App Store.