Dépannage et dépannage de la distribution d'applications FAQ

Impossible de distribuer une application en raison d'un e-mail de contact manquant

Lors du téléchargement d'une application, vous pouvez rencontrer cette erreur :

"Nous n'avons pas trouvé d'adresse e-mail de contact pour l'application <app-id> . Veuillez visiter App Distribution dans la console Firebase pour en créer une."

Définissez une adresse e-mail de contact dans la console Firebase, si disponible. Si le problème persiste, contactez le support Firebase .

Une erreur s'est produite lors du provisionnement de votre application (erreurs 400, 409 ou 500)

Si vous rencontrez à plusieurs reprises les erreurs 400, 409 ou 500 lors du provisionnement, contactez l'assistance Firebase . Fournissez à l'assistance votre numéro de projet Firebase et votre identifiant d'application.

Impossible de télécharger l'IPA

Voici un exemple de réponse réseau du navigateur :

{
"status": "IN_PROGRESS",
  "message": "There was an error processing your
distribution. Ensure you are uploading a valid IPA or APK and try again."
}

Pour résoudre ce problème, procédez comme suit :

1. Vérifiez la taille de l'IPA. La limite maximale de taille de fichier pour tous les fichiers binaires est de 2 048 Mo, soit un peu plus de 2 Go.

2. Si la taille IPA est comprise dans la limite de taille de fichier et est reproductible, procédez comme suit :

   1. Vérifiez votre fichier Info.plist et confirmez si CFBundleDisplayName contient des délimiteurs <array> .

   2. Supprimez les délimiteurs <array> et reconstruisez votre application. Le téléchargement devrait réussir.

   3. Si vous rencontrez toujours des problèmes, contactez l'assistance Firebase .

3. Si la taille IPA dépasse la limite de taille de fichier, apportez toutes les modifications nécessaires pour réduire la taille du fichier.

4. Si la réduction de la taille du fichier IPA ne résout pas le problème, contactez le support Firebase et renseignez-vous sur l'utilisation de Testflight .

Le testeur n'a pas de compte Google

Lorsqu'un utilisateur crée un compte Google, il reçoit automatiquement une adresse Gmail.

Si un testeur ne dispose pas d'adresse Google Workspace ou Gmail, ou s'il préfère utiliser une autre adresse e-mail pour se connecter, demandez-lui d'associer une adresse e-mail autre que Gmail au compte et d'utiliser cette adresse e-mail pour se connecter.

Lors du choix d'un autre e-mail, le testeur doit suivre ces directives :

• N'utilisez pas d'adresse Gmail.
• N'utilisez pas une adresse e-mail déjà liée à un autre compte Google.
• N'oubliez pas d'utiliser le mot de passe de votre compte Google lorsque vous vous connectez avec cette adresse e-mail.

Pour plus d'informations, consultez Connectez-vous à votre compte Google avec une autre adresse e-mail .

Le testeur ne parvient pas à voir les bonnes applications ou builds

Si le testeur a accepté l'invitation par e-mail avec une adresse e-mail différente de celle à laquelle l'invitation a été envoyée, il se peut qu'il ne soit pas en mesure de voir les bonnes applications ou builds.

L'e-mail auquel le développeur envoie des invitations et ajoute aux nouvelles versions (e-mail A) peut être différent de l'e-mail que le testeur utilise pour accepter l'invitation (e-mail B). Cela crée un lien en coulisses. Chaque fois que l'e-mail A est ajouté à de nouvelles versions, c'est en fait l'e-mail B qui y a accès.

Si le testeur a accepté l'invitation par e-mail avec une adresse e-mail différente, suivez ces étapes pour résoudre le problème :

1. Supprimez le testeur de la section Afficher tous les testeurs de l'onglet Testeurs et groupes de la page Distribution d'applications de la console Firebase. Les invitations existantes sont supprimées.

2. Réinvitez le testeur à tester votre application. Le testeur devrait recevoir un email d'invitation.

3. Assurez-vous que le testeur accepte l'invitation avec la même adresse e-mail.

Le testeur ne reçoit pas de notifications par e-mail

Les testeurs peuvent ne pas recevoir de notifications par e-mail si l'un des événements suivants se produit :

• Les notifications par e-mail sont envoyées dans des dossiers spam.

• Des filtres de courrier électronique sont définis.

• L'invitation a été envoyée à un compte de messagerie, mais le testeur a accepté avec un autre compte de messagerie. Le testeur reçoit les e-mails des nouvelles versions pour le compte de messagerie auquel l'invitation a été initialement envoyée.

• Le testeur a été préalablement invité mais n’a pas accepté l’invitation initiale. Si le testeur est ajouté aux versions ultérieures, App Distribution n’enverra pas automatiquement de notifications de version à ce testeur, car celui-ci n’a pas accepté l’invitation initiale.

Solution 1

1. Demandez au testeur de vérifier son dossier spam et tous les filtres de messagerie qu'il a définis dans son service de messagerie.

2. Si le testeur s'est désabonné des e-mails, demandez-lui de procéder comme suit :

   1. Recherchez un e-mail que le testeur a déjà reçu de l'application.
   2. Cliquez sur Gérer les paramètres de messagerie en bas et cliquez sur Autoriser le réabonnement des e-mails .

Solution 2

Si le testeur ne souhaite pas recevoir de notifications par e-mail et souhaite simplement pouvoir accepter des invitations à des applications, il peut afficher les invitations à des applications en attente directement dans le clip Web Firebase App Distribution : appdistribution.firebase.google.com .

Solution 3

1. Supprimez le testeur de la section Afficher tous les testeurs de l'onglet Testeurs et groupes de la page Distribution d'applications de la console Firebase. Cette action supprime les invitations existantes.

2. Réinvitez le testeur à tester votre application. Le testeur devrait recevoir un email d'invitation. Assurez-vous que le testeur accepte l'invitation avec la même adresse e-mail à laquelle l'invitation a été envoyée.

Erreur « Développeur d'entreprise non fiable » lors de la tentative d'exécution de l'application de test

L’erreur Untrusted Enterprise Developer apparaît si vous n’avez pas fait confiance au certificat de développeur sur l’appareil de test avant d’ouvrir l’application. Dans l'application Paramètres > Écran Profils et gestion des appareils , sélectionnez le nom du développeur de l'application et faites-lui confiance.

Erreur « Mode développeur requis » lors de la tentative d'exécution de l'application de test

L'erreur Mode développeur requis apparaît lorsque vous essayez de lancer une application iOS provisionnée de manière ad hoc sur iOS 16 ou version ultérieure sans activer au préalable le mode développeur.

Pour activer le mode développeur et résoudre cette erreur, procédez comme suit :

1. Sur votre iPhone, ouvrez l'application Paramètres, puis appuyez sur Confidentialité et sécurité .
2. Faites défiler jusqu'à Sécurité et appuyez sur Mode développeur .
3. Appuyez sur le curseur du mode développeur .
4. Appuyez sur Redémarrer .
5. Après le redémarrage de l'appareil, déverrouillez-le. L'activation du mode développeur ? La boîte de dialogue apparaît.
6. Appuyez sur Activer . Vous pouvez maintenant lancer votre application et commencer les tests.

"Appareil enregistré, vous êtes prêt ! Vous recevrez un e-mail lorsque l'application sera prête à être testée"

Si vous installez une distribution Ad Hoc, ce message apparaît lorsque le développeur n'a pas encore configuré son application pour qu'elle s'exécute sur votre appareil de test. Pour mettre l'application à votre disposition, le développeur doit suivre les instructions dans Enregistrer des appareils supplémentaires .

Le compte Google n'a pas accès à l'application de test

Si votre compte Google n'a pas accès à une application de test que vous avez précédemment installée (ou pour laquelle vous avez accepté une invitation), il est probable que vous vous soyez connecté au mauvais compte Google. Les applications auxquelles vous avez accès sont associées au compte Google que vous avez utilisé lorsque vous avez accepté pour la première fois l'invitation à tester l'application. Réessayez en vous connectant avec le compte Google que vous avez précédemment utilisé pour accepter l'invitation.

Erreur 403 : « Contactez votre administrateur pour accéder »

Lorsque vous rencontrez une erreur 403, cela signifie que le compte que vous utilisez n'est pas autorisé à installer et tester des applications. L'accès est déterminé par l'administrateur du domaine de votre compte dans Google Workspace.

Si vous pensez que vous devriez être autorisé à installer et tester des applications, demandez à l'administrateur de votre compte Google Workspace de modifier les paramètres de votre compte. Votre administrateur doit suivre les instructions dans Gérer l'accès aux services qui ne sont pas contrôlés individuellement .

Si vous disposez de plusieurs comptes, essayez de vous connecter avec un autre compte qui n'est pas limité à l'installation et au test d'applications.

Le testeur ne reçoit pas d'alertes dans l'application

Si vous avez déjà configuré le SDK iOS App Distribution dans votre application et que vos testeurs ne reçoivent pas d'alertes dans l'application, vérifiez que votre application récupère les nouvelles versions :

1. Activez le mode débogage dans votre application. Pour savoir comment procéder, consultez la documentation Google Analytics .

2. Exécutez votre application dans un simulateur et recherchez la chaîne « [Firebase/AppDistribution] ».

3. Vérifiez que le testeur a accès à la nouvelle version :

   • Si un objet de version valide est renvoyé, il est probable qu'il y ait un problème dans le cycle de vie de View Controller où la boîte de dialogue d'alerte est chargée avant que la vue n'apparaisse.

   • Si aucune version n'est renvoyée, votre testeur n'est peut-être pas encore associé à la nouvelle version. Dans le tableau de bord App Distribution de la console Firebase, assurez-vous que votre testeur est inclus dans votre distribution de build et qu'il est à l'état Accepté .

     Si votre testeur ne reçoit toujours pas de mises à jour, demandez-lui de suivre les conseils ci-dessous pour vous assurer qu'il a accepté l'invitation à tester votre application et qu'il a correctement configuré son appareil de test :

     1. Sur l'appareil de test, connectez-vous au clip Web Firebase App Distribution. N'oubliez pas de sélectionner le compte Google que vous avez utilisé pour la première fois lorsque vous avez accepté l'invitation à tester l'application.

     2. Assurez-vous que la nouvelle version de l'application est disponible dans le clip Web.

Le testeur est invité à se reconnecter après la fermeture de l'application

Par défaut, vos testeurs n'ont besoin de se connecter qu'une seule fois à leur compte Google pour activer les alertes de nouvelles builds et installer de nouvelles builds. Si vos testeurs sont invités à se reconnecter après la fermeture et la réouverture de votre application, suivez ces conseils pour vous assurer que votre configuration App Distribution est correctement configurée :

• Vérifiez que vous avez activé l'API Firebase App Testers. Pour plus d’informations, consultez Activer l’API App Distribution Tester .

• Sous Restrictions clés , assurez-vous que l'API Firebase App Testers est incluse dans la liste des API autorisées.

• Si vous effacez généralement UserDefaults lors de la déconnexion, vous effacez peut-être l’état de votre testeur. App Distribution stocke un indicateur qui indique si votre testeur s'est déjà connecté à l'application. Pour plus d'informations, consultez le référentiel GitHub .

Y a-t-il des limites pour l'ajout de testeurs à mon application ?

Firebase App Distribution présente les limites de testeur suivantes :

• Ajouter un maximum de 500 testeurs à un projet Firebase

• Ajouter un maximum de 200 testeurs à un groupe App Distribution

Pour ajouter davantage de testeurs, demandez une augmentation de la limite sans frais .

Mes invitations de testeur expirent-elles ?

Les testeurs disposent de 30 jours pour accepter une invitation à tester l’application avant son expiration. Lorsqu'une invitation expire dans 5 jours, un avis d'expiration apparaît dans la console Firebase à côté du testeur sur une version. Une invitation peut être renouvelée en la renvoyant via le menu déroulant sur la ligne du testeur.

Quand une nouvelle version est-elle créée pour les téléchargements iOS ?

Voir Enregistrer des appareils supplémentaires .

Pendant combien de temps les versions d’applications sont-elles disponibles ?

Les versions d'application sont supprimées d'App Distribution si l'une des conditions suivantes se produit :

• La version de l’application date de plus de 150 jours.
• Vous dépassez la limite de 1 000 versions d’application et la version de l’application est plus ancienne que les 1 000 versions d’application les plus récentes.

Pour plus d’informations, consultez App Distribution prend en charge un maximum de 1 000 versions .

Une fois que l’application atteint ou dépasse la limite d’expiration de 150 jours ou la limite de 1 000 versions d’application, la version est supprimée du tableau de bord App Distribution et de l’application Web du testeur App Distribution. Si votre testeur a installé la version, la version locale de l'application continue de s'exécuter.

Pour que la version de l'application reste disponible plus longtemps, suivez l'une des recommandations suivantes :

• Avant que la version de l'application n'expire ou ne dépasse la limite de version, téléchargez l'IPA et supprimez la version du tableau de bord App Distribution. Ensuite, téléchargez à nouveau l'IPA en tant que nouvelle version sur App Distribution.
• Téléchargez la version et téléchargez-la sur Cloud Storage pour un archivage à long terme.

Les versions d'application expirent après 150 jours

Lorsque vous téléchargez une version de votre application sur Firebase, la version apparaît dans le tableau de bord App Distribution pendant 150 jours, à compter de la date de téléchargement. Après avoir téléchargé la version, vous pouvez la distribuer aux testeurs, qui l'installent à partir de l'application Web du testeur App Distribution sur leur appareil de test.

Lorsque la version est à 30 jours de la date d'expiration, une notification d'expiration de la version de l'application apparaît sur votre version sur la page App Distribution de la console Firebase et dans l'application Web du testeur App Distribution.

App Distribution prend en charge un maximum de 1 000 versions

App Distribution autorise un maximum de 1 000 versions par application. Lorsque votre application atteint la limite de 1 000 versions d’application, App Distribution supprime automatiquement les versions les plus anciennes dépassant la limite.

Si vous souhaitez gérer manuellement les versions de votre application, utilisez l'API REST App Distribution pour répertorier et supprimer les versions d'application en masse.

Si vous avez des questions, contactez l'assistance Firebase .

Qu'est-ce que le profil Firebase ?

Le profil Firebase est un profil de configuration qui permet à App Distribution de :

• Enregistrez l'appareil de test en collectant l'ID d'appareil unique (UDID) de l'appareil. Si vous testez une distribution ad hoc, Firebase envoie au développeur de l'application un e-mail contenant l'UDID de l'appareil de test, ainsi que des instructions sur la façon d'inclure l'appareil dans le profil de provisionnement de l'application afin que la version puisse être testée sur votre appareil.

• Installez un clip Web Firebase App Distribution sur l'écran d'accueil de votre appareil. Le clip Web vous permet d'installer et d'accéder à toutes vos applications de test en un seul endroit. Les nouvelles builds que vous êtes invités à tester sont automatiquement ajoutées au clip Web.

Pour obtenir de l'aide sur l'installation des profils de configuration sur votre appareil iOS, reportez-vous à la documentation d'Apple .

Comment puis-je accéder aux applications de test que j'ai installées sur mon appareil ?

Si vous êtes un testeur, vous pouvez accéder à toutes vos applications de test avec le clip Web Firebase App Distribution , qui est automatiquement ajouté à l'écran d'accueil de votre appareil de test lorsque vous installez le profil Firebase. Si vous testez une distribution Ad Hoc, vous devez d'abord installer le profil avant de pouvoir tester l'application.

Si vous testez une distribution Enterprise, vous pouvez installer manuellement le profil :

1. Si vous ne l'avez pas déjà fait, connectez-vous à Google et acceptez l'invitation.

2. Sous Tester les applications , sélectionnez l'application que vous souhaitez tester.

3. En haut à droite de la page de l'application, appuyez sur mobile_screen_share .

4. Suivez les instructions affichées pour installer le profil Firebase.

Comment supprimer mon compte testeur ?

Pour supprimer votre compte testeur App Distribution et ses données associées, suivez ces étapes dans l'ordre :

1. Visitez https://appdistribution.firebase.google.com et connectez-vous avec votre compte Google.

2. En haut à droite, cliquez sur settings ( Gérer le compte )

   Supprimer le compte .

3. Facultatif : dans les autorisations de votre compte Google , révoquez l'accès à Firebase App Distribution. Notez que la révocation de l'accès sans supprimer au préalable votre compte App Distribution ne supprime pas votre compte ou vos données de testeur.