Ad Hoc Distribution — définition, limitations des tests iOS

Qu'est-ce que Ad Hoc Distribution ?

Ad Hoc Distribution est une méthode de distribution d'applications iOS disponible pour tous les membres de l'Apple Developer Program (99 $/an). Elle permet d'installer des applications directement sur les appareils sans passer par la modération de l'App Store. L'objectif principal est le test de pré-lancement : les développeurs, testeurs et clients peuvent installer l'application sur leurs appareils avant la sortie officielle.

Ad Hoc Distribution utilise un Provisioning Profile qui inclut une liste des UDID d'appareils autorisés. Lors de la signature de l'application, Xcode ou Fastlane crée un fichier IPA qui ne peut être installé que sur les appareils de cette liste. Chaque UDID est ajouté via l'Apple Developer Portal, et le total ne peut pas dépasser 100 appareils par compte développeur.

Selon Apple (2025), Ad Hoc Distribution reste demandée pour les tests de pré-lancement lorsque l'application n'a pas encore passé la modération de l'App Store mais doit déjà être présentée à un client ou testée sur des appareils réels. Cependant, Apple recommande d'utiliser TestFlight pour les tests bêta à grande échelle, réservant Ad Hoc aux petits groupes et aux cas particuliers.

Comment fonctionne la distribution Ad Hoc ?

La distribution Ad Hoc fonctionne via une installation OTA (Over-The-Air) ou via iTunes/Finder. Le développeur crée un Ad Hoc Provisioning Profile avec les UDID sélectionnés, signe l'application avec ce profil et exporte le fichier IPA. L'utilisateur installe l'application via Safari par un lien ou via Finder sur macOS.

Techniquement, la distribution Ad Hoc comprend plusieurs étapes. D'abord, l'administrateur collecte les UDID des appareils de test — chaque UDID est un identifiant unique de 40 caractères pour un appareil iOS. Ensuite, les UDID sont ajoutés à l'Apple Developer Portal, un Provisioning Profile est créé et un IPA signé est généré. La validité d'un profil Ad Hoc est d'un an, après quoi les applications cessent de s'ouvrir.

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

Pour installer une application Ad Hoc, l'utilisateur doit approuver le certificat du développeur sur son appareil. Pour ce faire, dans les réglages iOS, allez dans « Général » → « VPN et gestion de l'appareil » → « Profil » et appuyez sur « Approuver ». Sans cette étape, l'application ne démarrera pas.

Enregistrement UDID et limite de 100 appareils

L'UDID (Unique Device Identifier) est un identifiant unique pour chaque appareil iOS. Pour la distribution Ad Hoc, vous devez collecter les UDID de tous les appareils de test et les ajouter à l'Apple Developer Portal. Le maximum est de 100 appareils par compte développeur par an. Cette limite s'applique à toutes les applications du développeur, pas à chaque application individuellement.

La limite des 100 appareils est réinitialisée à la fin de l'année civile — la réinitialisation a lieu le 1er janvier. Cependant, Apple recommande d'utiliser TestFlight pour les tests à grande échelle, qui prend en charge jusqu'à 10 000 testeurs externes. Ad Hoc Distribution reste pertinent depuis 2022 pour les cas où l'application n'a pas encore passé la Beta App Review ou lorsque les tests nécessitent un accès au fichier IPA original.

Configuration d'Ad Hoc Distribution

La configuration d'Ad Hoc Distribution s'effectue via l'Apple Developer Portal et Xcode. Le processus comprend l'enregistrement des appareils, la création d'un Provisioning Profile, la signature de l'application et l'exportation de l'IPA pour distribution. Pour le développement en équipe, il est recommandé d'utiliser Fastlane ou l'automatisation via CI/CD.

1. Collecter les UDID des appareils de test via udid.io ou un profil de configuration
2. Ajouter les UDID à l'Apple Developer Portal → Certificates, Identifiers & Profiles → Devices
3. Créer un Ad Hoc Provisioning Profile pour le Bundle ID requis, incluant les appareils enregistrés
4. Signer l'application avec le profil Ad Hoc dans Xcode : Product → Archive → Distribute Ad Hoc
5. Exporter le fichier IPA et distribuer le lien via un serveur OTA ou Firebase App Distribution
6. Pour l'utilisateur : ouvrir le lien sur l'appareil, installer l'application, approuver le certificat dans les réglages

Pour simplifier le processus, des services de distribution sont utilisés : Firebase App Distribution, Microsoft App Center ou BuddyBuild. Ces services gèrent automatiquement les UDID, créent des profils Ad Hoc et envoient des invitations aux testeurs. Firebase App Distribution s'intègre également avec les pipelines CI/CD via Gradle ou Fastlane.

Une nuance importante — mise à jour des UDID. Si vous devez ajouter un nouvel appareil au profil, vous devrez recréer le Provisioning Profile et resigner l'application. Les appareils ayant déjà installé l'application continueront à l'utiliser jusqu'à l'expiration du profil (1 an). Après cela, une réinstallation avec un nouveau profil est nécessaire.

Ad Hoc vs TestFlight et Enterprise

Ad Hoc Distribution n'est que l'une des trois méthodes de distribution d'applications iOS sans l'App Store. TestFlight (gratuit, jusqu'à 10 000 testeurs externes) et Enterprise Distribution (sans limite d'appareils, pour les applications d'entreprise) résolvent des tâches connexes avec différentes limitations et exigences.

TestFlight est la méthode préférée d'Apple pour les tests bêta. Il ne nécessite pas de collecte d'UDID, prend en charge jusqu'à 100 testeurs internes et 10 000 testeurs externes, gère automatiquement les versions et fournit des analyses d'installation. Cependant, TestFlight nécessite de passer la Beta App Review pour les testeurs externes, ce qui peut prendre 1 à 2 jours. Ad Hoc Distribution ne nécessite aucune modération.

Enterprise Distribution convient aux applications d'entreprise avec un nombre illimité d'appareils, mais nécessite une inscription à l'Apple Developer Enterprise Program (299 $/an) avec un numéro D-U-N-S. Ad Hoc est accessible à tous les membres du programme standard (99 $/an) et ne nécessite pas de vérification légale de l'entreprise. Pour les petites équipes et les projets, Ad Hoc reste le moyen le plus simple de distribution sans l'App Store.