Résoudre les problèmes liés à App Distribution Questions fréquentes

Impossible de distribuer une application, car l'adresse e-mail de contact est manquante

Lorsque vous importez une application, vous pouvez rencontrer l'erreur suivante :

"Nous n'avons trouvé aucune adresse e-mail de contact pour l'application <app-id>. Veuillez accéder à App Distribution dans la console Firebase pour en configurer un."

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

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

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

Impossible d'importer 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 du fichier IPA. La taille maximale de tous les fichiers binaires est de 2 048 Mio, soit un peu plus de 2 Go.

2. Si la taille de l'IPA ne dépasse pas la limite de taille de fichier et que le problème 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 recompilez votre application. L'importation devrait réussir.

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

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

4. Si la réduction de la taille du fichier IPA ne résout pas le problème, contactez l'assistance Firebase et demandez à utiliser 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'une 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 à son compte et de l'utiliser pour se connecter.

Lorsque vous choisissez une adresse e-mail secondaire, vous devez respecter les consignes suivantes :

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

Pour en savoir plus, consultez Se connecter à un compte Google avec une autre adresse e-mail.

Le testeur ne voit pas les bonnes applications ou versions

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 puisse pas voir les bonnes applications ou versions.

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

Si le testeur a accepté l'invitation par e-mail avec une autre adresse e-mail, procédez comme suit pour résoudre le problème :

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

2. Réinvitez le testeur à tester votre application. Il devrait recevoir un e-mail 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 dans les cas suivants :

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

• Les filtres d'e-mails sont définis.

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

• Le testeur a déjà été 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 il n'a pas accepté l'invitation initiale.

Solution 1

1. Demandez au testeur de vérifier son dossier de spam et 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 de la page, puis sur Autoriser les e-mails pour vous réabonner.

Solution 2

Si le testeur ne souhaite pas recevoir de notifications par e-mail et veut simplement pouvoir accepter les invitations à l'application, il peut afficher les invitations 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 sur la page App Distribution de la console Firebase. Cette action supprime les invitations existantes.

2. Réinvitez le testeur à tester votre application. Il devrait recevoir un e-mail d'invitation. Assurez-vous que le testeur accepte l'invitation avec l'adresse e-mail à laquelle elle a été envoyée.

Erreur "Développeur d'entreprise non approuvé" lors de la tentative d'exécution de l'application de test

L'erreur Untrusted Enterprise Developer (Développeur d'entreprise non approuvé) s'affiche si vous n'avez pas approuvé le certificat du développeur sur l'appareil de test avant d'ouvrir l'application. Dans l'application Settings (Paramètres) > écran Profiles & Device Management (Profils et gestion des appareils), sélectionnez le nom du développeur de l'application et approuvez-le.

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

L'erreur "Mode développeur requis" s'affiche lorsque vous essayez de lancer une application iOS provisionnée ad hoc sur iOS 16 ou version ultérieure sans avoir d'abord activé 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 Réglages, puis appuyez sur Confidentialité et sécurité.
2. Faites défiler l'écran vers le bas jusqu'à "Sécurité", puis appuyez sur Mode développeur.
3. Appuyez sur le curseur Mode développeur.
4. Appuyez sur Redémarrer.
5. Une fois l'appareil redémarré, déverrouillez-le. La boîte de dialogue "Activer le mode développeur ?" s'affiche.
6. Appuyez sur Activer. Vous pouvez maintenant lancer votre application et commencer à la tester.

"Appareil enregistré, tout est 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 s'affiche lorsque le développeur n'a pas encore configuré son application pour qu'elle s'exécute sur votre appareil de test. Pour que l'application soit disponible, le développeur doit suivre les instructions de la section 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 déjà 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é l'invitation à tester l'application pour la première fois. Réessayez en vous connectant avec le compte Google que vous avez utilisé précédemment pour accepter l'invitation.

Erreur 403 : "Contactez votre administrateur pour les obtenir"

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 de l'article Gérer l'accès aux services qui ne sont pas contrôlés individuellement.

Si vous possédez plusieurs comptes, essayez de vous connecter avec un autre compte qui n'est pas soumis à des restrictions concernant l'installation et le 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 du contrôleur de vue, où la boîte de dialogue d'alerte est chargée avant l'affichage de la vue.

   • Si aucune version n'est renvoyée, il est possible que votre testeur ne soit 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 la distribution de votre 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 suivants pour s'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é la première fois que 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 avoir fermé l'application

Par défaut, vos testeurs n'ont besoin de se connecter à leur compte Google qu'une seule fois pour activer les alertes de nouvelles versions et installer de nouvelles versions. Si vos testeurs sont invités à se reconnecter après avoir fermé et rouvert 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 en savoir plus, consultez Activer l'API App Distribution Tester.

• Sous Restrictions relatives aux 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 risquez d'effacer l'état de votre testeur. App Distribution stocke un indicateur qui indique si votre testeur s'est déjà connecté à l'application. Pour en savoir plus, consultez le dépôt GitHub.

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

Firebase App Distribution est soumis aux limites suivantes concernant les testeurs :

• Ajouter un maximum de 500 testeurs à un projet Firebase

• Ajoutez un maximum de 200 testeurs à un groupe App Distribution.

Pour ajouter d'autres testeurs, demandez une augmentation de la limite sans frais.

Mes invitations de testeurs expirent-elles ?

Les testeurs disposent de 30 jours pour accepter une invitation à tester l'application avant qu'elle n'expire. Lorsqu'une invitation expire dans cinq jours, un avis d'expiration s'affiche dans la console Firebase à côté du testeur d'une version. Vous pouvez renouveler une invitation en la renvoyant à l'aide du menu déroulant de la ligne du testeur.

Quand une nouvelle version est-elle créée pour les importations iOS ?

Consultez Enregistrer des appareils supplémentaires.

Pendant combien de temps les versions d'application sont-elles disponibles ?

Les versions d'application sont supprimées de App Distribution si l'une des conditions suivantes est remplie :

• 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 antérieure aux 1 000 versions d'application les plus récentes.

Pour en savoir plus, consultez App Distribution accepte 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 de test 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 versions, téléchargez l'IPA et supprimez la version du tableau de bord App Distribution. Ensuite, réimportez l'IPA en tant que nouvelle compilation dans App Distribution.
• Téléchargez la version et importez-la dans Cloud Storage pour l'archiver à long terme.

Les versions d'application expirent au bout de 150 jours

Lorsque vous importez une version de votre application dans Firebase, elle s'affiche dans le tableau de bord App Distribution pendant 150 jours à compter de la date d'importation. Une fois la version importée, vous pouvez la distribuer aux testeurs, qui l'installent à partir de l'application Web de test 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 s'affiche sur votre version sur la page App Distribution de la console Firebase et dans l'application Web de test App Distribution.

App Distribution accepte un maximum de 1 000 versions

App Distribution accepte un maximum de 1 000 versions par application. Lorsque votre application atteint cette limite, App Distribution supprime automatiquement les versions les plus anciennes au-delà de la limite.

Si vous souhaitez gérer manuellement les versions de votre application, utilisez l'API REST App Distribution pour lister et supprimer des versions d'application de manière groupée.

Pour toute question, contactez l'assistance Firebase.

Qu'est-ce que le profil Firebase ?

Le profil Firebase est un profil de configuration qui permet à App Distribution d'effectuer les opérations suivantes :

• Enregistrez l'appareil de test en collectant son identifiant unique (UDID). 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 pour inclure l'appareil dans le profil de provisionnement de l'application afin que la compilation 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 toutes vos applications de test et d'y accéder au même endroit. Les nouvelles versions que vous êtes invité à tester sont automatiquement ajoutées au clip Web.

Pour savoir comment installer des profils de configuration sur votre appareil iOS, consultez la documentation d'Apple.

Comment 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 des 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 de testeur ?

Pour supprimer votre compte testeur App Distribution et les données associées, procédez comme suit :

1. Accédez à 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 de Firebase App Distribution. Notez que révoquer l'accès sans supprimer d'abord votre compte App Distribution ne supprime pas votre compte de testeur ni vos données.