Symptôme : votre build est téléversé, mais personne ne peut commencer les tests externes TestFlight.
Résolution rapide : vérifiez d’abord l’admissibilité du build et son état de distribution, puis le groupe, l’examen, les informations de test et le mode d’invitation. Ne confondez pas un blocage App Store Connect avec un problème de connexion au Mac à distance.
Cet article s’adresse à vous si :
Vous êtes développeur iOS indépendant et votre build TestFlight n’est pas disponible pour les testeurs externes.
Vous travaillez en déplacement et devez livrer une version de test depuis un Mac à distance.
Vous coordonnez une petite équipe et cherchez à séparer un défaut de build d’un réglage de distribution.
Distinguer le téléversement de la distribution externe
Un build téléversé n’est pas nécessairement prêt à être distribué à des testeurs externes. Le Mac distant sert à préparer l’archive et à envoyer le build. Ensuite, App Store Connect indique son état, permet de configurer le groupe et présente les étapes nécessaires à la distribution. Enfin, les testeurs accèdent à la version depuis leur appareil. Ces opérations sont liées, mais une réussite à une étape ne prouve pas que les suivantes sont terminées.
Pour diagnostiquer le problème, séparez les trois espaces de travail :
- Sur le Mac : vérifiez le projet, l’archive produite et le résultat du téléversement. La documentation Apple décrit la procédure de téléversement d’un build.
- Dans App Store Connect : consultez l’état du build, son admissibilité, le groupe choisi et les informations demandées. Apple distingue les états de téléversement des états d’un build.
- Sur l’appareil du testeur : vérifiez son accès au groupe, le moyen d’invitation et les conditions qui s’appliquent au build.
Cette séparation évite deux erreurs courantes. Vous pouvez relancer inutilement une archive alors que le build est déjà présent, ou chercher un défaut réseau sur votre Mac alors que la distribution attend une action dans App Store Connect. Un problème d’examen ou de configuration ne permet pas, à lui seul, de conclure que le Mac distant est en cause.
Vérifier l’admissibilité avant de reconstruire
Si l’envoi semble réussi, ouvrez l’application concernée dans App Store Connect et examinez l’état précis du build. L’interface et les indications affichées vous aident à déterminer si le téléversement est terminé, si le build peut être utilisé et si une action reste nécessaire. Référez-vous aux définitions officielles des états des builds, plutôt qu’à la seule confirmation affichée à la fin de l’envoi.
Vérifiez ensuite que le build choisi correspond bien à l’application et à la plateforme du groupe externe. Une archive téléversée pour un projet ou une plateforme différente ne devient pas disponible dans le groupe voulu simplement parce qu’elle apparaît dans l’historique des envois. Comparez les informations de la fiche, le build sélectionné et les éléments visibles dans App Store Connect.
Portez aussi attention aux messages associés au build. Si la page affiche une action requise ou une restriction, traitez ce point avant de créer une nouvelle archive. Apple documente les étapes de gestion des builds pour les tests bêta externes. Suivez l’état affiché dans votre compte : ne déduisez pas un délai d’examen ni une cause particulière à partir du seul fait que le build n’est pas encore sélectionnable.
À retenir : une confirmation de téléversement prouve que le fichier a été envoyé. Elle ne prouve pas que le build est admissible aux tests externes, qu’il a franchi les étapes requises ou qu’il est associé au bon groupe.
Réparer un groupe sans build disponible
Quand un groupe externe existe mais ne propose aucun build, commencez par vérifier le contexte plutôt que par renvoyer l’application. Confirmez le nom de l’application ouverte, la plateforme concernée et le build que vous voulez distribuer. Examinez ensuite les réglages du groupe et les conditions susceptibles d’exclure le build ou certains testeurs.
| Symptôme | Contrôle à effectuer | Indice à relever | Action suivante |
|---|---|---|---|
| Aucun build dans le groupe | Application, plateforme et sélection du build | Le build est-il affiché ailleurs dans App Store Connect ? | Corriger la sélection ou vérifier son état |
| Le build apparaît, mais ne peut pas être distribué | Admissibilité et actions demandées sur sa fiche | Quel état ou message est affiché ? | Traiter l’action indiquée avant de relancer un envoi |
| Le build est proposé, mais pas au testeur attendu | Conditions du groupe et compatibilité du testeur | Le compte et l’appareil correspondent-ils aux réglages ? | Adapter le groupe ou vérifier le testeur |
| Le groupe fonctionne pour certains testeurs seulement | Appartenance au groupe et mode d’accès | Le testeur a-t-il reçu la bonne invitation ? | Vérifier son inscription et transmettre le bon accès |
Apple explique comment inviter des testeurs externes et gérer les builds associés. Utilisez cette procédure pour comparer ce qui est configuré dans le groupe avec ce que vous voyez sur la fiche du build. Si le build est absent, consignez l’application, la plateforme, son état et le groupe sélectionné. Ces éléments rendent le diagnostic plus fiable qu’une série de téléversements répétés.
Le contrôle des conditions du groupe est particulièrement utile lorsque vous travaillez en déplacement. Vous pouvez vérifier les réglages depuis un navigateur sans confondre ce contrôle avec l’ouverture d’une session graphique sur le Mac. Si le groupe contient des critères liés au testeur ou à l’accès, comparez-les à la situation de la personne qui tente de rejoindre la version.
Traiter l’examen et les informations manquantes
Si vous avez soumis les tests externes et qu’ils ne sont pas encore disponibles, regardez l’état indiqué dans App Store Connect. Distinguez les étapes en attente, un refus et une approbation. Ne supposez pas qu’un examen suit un délai fixe et n’attribuez pas une attente à une panne du Mac : l’état affiché et les éventuels motifs fournis sont les éléments à vérifier.
Avant de conclure que la distribution est bloquée par l’examen, contrôlez les informations demandées pour le test. Apple décrit les informations à fournir pour les tests. Comparez les champs renseignés avec les indications de la page de votre application. Si un élément est incomplet, corrigez-le dans App Store Connect, puis vérifiez à nouveau l’état présenté.
Pour les builds concernés par la conformité à l’exportation, consultez également les indications Apple sur les informations de conformité pour les builds bêta. Ne choisissez pas une réponse au hasard pour faire disparaître une étape : traitez la demande selon le contenu de votre application et les renseignements disponibles dans votre compte.
En cas de refus, partez du motif affiché. Identifiez l’information ou le réglage demandé, apportez la correction appropriée et vérifiez si une nouvelle soumission est nécessaire. Évitez de modifier simultanément le build, le groupe et les renseignements de test sans noter ce que vous avez changé : vous perdriez la possibilité de relier une correction précise à l’évolution de l’état.
Comparer les points de contrôle selon le symptôme
Le tableau ci-dessous sert à choisir le prochain contrôle sans refaire toutes les étapes. Il distingue un problème possible dans le livrable d’un problème de distribution ou d’accès. Il ne remplace pas l’état visible dans votre compte : en cas de désaccord, appuyez-vous sur les messages d’App Store Connect et sur la documentation Apple.
| Ce que vous observez | Contrôle prioritaire | Où chercher la preuve | Suite logique |
|---|---|---|---|
| Le build n’apparaît pas après l’envoi | Résultat du téléversement et état du build | Fiche du build dans App Store Connect | Confirmer l’envoi ou traiter le message d’état |
| Le build existe, mais le groupe n’en propose aucun | Application, plateforme, groupe et admissibilité | Fiche de l’application et réglages du groupe | Corriger le groupe ou l’association du build |
| Les tests sont soumis, mais ne sont pas actifs | État d’examen et informations requises | Écran de distribution et indications de la fiche | Compléter les éléments demandés ou répondre au motif |
| Le build est approuvé, mais les testeurs ne le voient pas | Notifications, appartenance et mode d’invitation | Groupe et informations du testeur | Envoyer l’accès attendu et vérifier sa réception |
| Le lien est accessible, mais l’inscription échoue | Statut du lien, restrictions et build associé | Réglages du lien et du groupe | Ajuster l’accès ou réexaminer le build |
Cette lecture par symptôme répond à une question pratique : faut-il reconstruire, ajuster la distribution ou aider le testeur à rejoindre le groupe ? Si l’état du build est le point bloquant, reprenez le processus de préparation et de téléversement. Si le build est prêt, concentrez-vous sur App Store Connect. Si la distribution est configurée, examinez le mode d’accès côté testeur.
Contrôler les invitations et les liens publics
Une approbation ne garantit pas que chaque testeur a reçu ou utilisé le bon moyen d’accès. Vérifiez si le groupe est configuré pour envoyer une notification automatique. Si ce n’est pas le cas, informez les testeurs par le moyen prévu et confirmez qu’ils sont associés au groupe concerné. Apple fournit des indications sur la consultation et la gestion des informations des testeurs.
Distinguez l’invitation adressée à une personne de l’accès par lien public. Pour une invitation, confirmez que le destinataire a reçu le message correspondant et qu’il utilise le compte attendu. Pour un lien public, vérifiez qu’il est toujours activé et que les conditions d’accès correspondent au testeur. Comparez également le build associé au groupe avec celui que vous souhaitez tester.
Un lien qui reste visible ne prouve pas que l’inscription est ouverte sans restriction. Si les réglages imposent des conditions ou une limite, le testeur peut ne pas pouvoir rejoindre le groupe. Consultez les paramètres actuels avant de renvoyer le lien. Gardez aussi à l’esprit qu’un lien public peut être transmis au-delà du cercle prévu : si le test concerne des données ou un projet client, choisissez un accès qui reste compatible avec votre périmètre de test.
Avant de diffuser le lien : vérifiez qui peut le recevoir, quelles conditions s’appliquent et si le build actuellement associé est bien celui que vous souhaitez partager. Si le public visé change, réévaluez l’ouverture du groupe au lieu de laisser circuler un lien devenu trop large.
Suivre une procédure de diagnostic reproductible
Pour éviter les téléversements en boucle, procédez dans cet ordre. Notez les éléments observés dans un compte rendu de livraison : cela vous permettra, à vous ou à votre équipe, de reprendre le contrôle depuis un autre appareil si votre connexion au Mac est interrompue.
- Identifiez l’application et la plateforme. Vérifiez que vous examinez le même projet que celui utilisé pour produire l’archive. Relevez le nom du build et les informations affichées sur sa fiche.
- Contrôlez l’envoi depuis le Mac. Consultez le résultat du processus de téléversement et vérifiez si le build apparaît dans App Store Connect. Si l’envoi a échoué, suivez le message correspondant avant toute autre action.
- Vérifiez l’état et l’admissibilité. Comparez les indications de la fiche aux descriptions officielles des états. Si une action est requise, traitez-la avant de reconstruire.
- Examinez le groupe externe. Confirmez qu’il s’agit du groupe attendu, que le build est associé et que ses conditions ne l’excluent pas.
- Vérifiez l’examen et les informations de test. Consultez l’état affiché, les éléments demandés et, le cas échéant, les indications de conformité à l’exportation.
- Contrôlez l’accès des testeurs. Vérifiez l’appartenance au groupe, le canal d’invitation et les réglages du lien public si vous l’utilisez.
- Choisissez une action fondée sur l’indice observé. Corrigez le build si son état le justifie, ajustez le groupe si le build n’y est pas disponible, complétez les renseignements si App Store Connect le demande, ou contactez l’assistance Apple si les éléments visibles ne permettent pas de résoudre le blocage.
Cette séquence sépare concrètement la construction et l’envoi du travail de distribution. Elle est aussi adaptée au développement iOS à distance : vous pouvez vérifier les états et les groupes depuis un appareil léger, puis revenir au Mac uniquement si les preuves indiquent que l’archive ou le téléversement est en cause.
Si vous devez maintenir un environnement macOS pour construire et livrer un projet en voyage, consultez les solutions de Mac à distance proposées par MACCOME. Cette option n’est pas nécessaire pour corriger un réglage App Store Connect et ne remplace pas un Mac local si vous avez besoin de périphériques physiques ou d’un poste durablement disponible sur place. En revanche, si votre matériel actuel vous oblige à emporter un MacBook, dépend d’une connexion locale fragile ou rend la reprise après perte de l’appareil compliquée, un Mac accessible à distance peut dissocier votre environnement de développement de votre équipement de voyage. Vous pouvez examiner les options MACCOME pour un poste Mac distant si le besoin porte réellement sur la construction et l’envoi, plutôt que sur l’étape de distribution elle-même.