Cette page fournit une aide pour le dépannage et répond aux questions fréquentes sur la distribution et le test d'applications avec App Distribution.
Distribuer des applications
Suivez les conseils suivants pour résoudre les problèmes que vous pourriez rencontrer lors de la distribution d'applications à vos testeurs.
Impossible de distribuer une application en raison d'une adresse e-mail de contact manquante
Lorsque vous importez une application, vous pouvez rencontrer l'erreur suivante:
"Nous n'avons pas trouvé d'adresse e-mail de contact pour l'application <app-id>. Veuillez accéder à App Distribution dans la console Firebase pour en configurer une."
Définissez une adresse e-mail de contact dans la console Firebase, le cas échéant. Si le 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 régulièrement les erreurs 400, 409 ou 500 lors du provisionnement, contactez l'assistance Firebase. Indiquez à l'assistance votre numéro de projet Firebase et l'identifiant de votre application.
Impossible d'importer le fichier 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 :
Vérifiez la taille de l'APK. La taille maximale de fichier pour tous les binaires est de 2 048 Mo, soit un peu plus de 2 Go.
Si la taille de l'IPA est inférieure à la limite de taille de fichier et est reproductible, procédez comme suit:
Vérifiez votre fichier
Info.plistet vérifiez siCFBundleDisplayNamecontient des séparateurs<array>.Supprimez les séparateurs
<array>et recréez votre application. L'importation devrait réussir.Si le problème persiste, contactez l'assistance Firebase.
Si la taille de l'IPA dépasse la limite de taille de fichier, apportez les modifications nécessaires pour réduire la taille du fichier.
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.
Installer et tester des applications
Suivez les conseils ci-dessous pour résoudre les problèmes que vos testeurs peuvent rencontrer lors de l'installation et du test de vos applications.
Le testeur ne dispose pas d'un compte Google
Lorsqu'un utilisateur crée un compte Google, une adresse Gmail lui est automatiquement attribuée.
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 de s'en servir pour se connecter.
Lorsque le testeur choisit une autre adresse e-mail, il doit respecter les consignes suivantes:
- N'utilisez pas d'adresse Gmail.
- N'utilisez pas d'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 avec cette adresse e-mail.
Pour en savoir plus, consultez Se connecter à un compte Google avec une autre adresse e-mail.
Le testeur ne parvient pas à voir les applications ou les builds appropriés
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 est possible qu'il ne puisse pas voir les applications ou les builds appropriés.
L'adresse e-mail à laquelle le développeur envoie des invitations et qu'il ajoute aux nouveaux builds (e-mail A) peut être différente de celle que le testeur utilise pour accepter l'invitation (e-mail B). Un lien est ainsi créé en arrière-plan. Chaque fois que l'adresse e-mail A est ajoutée à de nouvelles compilations, c'est l'adresse e-mail B qui 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:
Supprimez le testeur de la section Afficher tous les testeurs de l'onglet Testeurs et groupes de la page App Distribution de la console Firebase. Les invitations existantes sont supprimées.
Redemandez au testeur de tester votre application. Il devrait recevoir un e-mail d'invitation.
Assurez-vous que le testeur accepte l'invitation avec la même adresse e-mail.
Le testeur ne reçoit pas les notifications par e-mail
Les testeurs peuvent ne pas recevoir de notifications par e-mail si l'un des cas suivants se produit:
Les notifications par e-mail sont envoyées dans les dossiers de spam.
Les filtres de messagerie 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 de nouvelle version pour 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é à des versions ultérieures, App Distribution n'envoie pas automatiquement de notifications de version à ce testeur, car il n'a pas accepté l'invitation initiale.
Solution 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.
Si le testeur s'est désabonné des e-mails, demandez-lui de procéder comme suit:
- Recherchez un e-mail que le testeur a précédemment reçu de l'application.
- 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 qu'il veut simplement pouvoir accepter les invitations d'application, il peut afficher les invitations d'application en attente directement dans le clip Web Firebase App Distribution : appdistribution.firebase.google.com.
Solution 3
Supprimez le testeur de la section Afficher tous les testeurs de l'onglet Testeurs et groupes de la page App Distribution dans la console Firebase. Cette action supprime les invitations existantes.
Redemandez au testeur de tester votre application. Il devrait recevoir un e-mail d'invitation. Assurez-vous que le testeur accepte l'invitation avec la même adresse e-mail à laquelle elle lui a été envoyée.
Erreur "Développeur d'entreprise non approuvé" lors de l'exécution de l'application de test
L'erreur Développeur d'entreprise non approuvé s'affiche si vous n'avez pas approuvé le certificat de développeur sur l'appareil de test avant d'ouvrir l'application. Dans l'application Paramètres > Gestion des profils et des appareils, sélectionnez le nom du développeur de l'application et approuvez-le.
Erreur "Mode développeur requis" lors de l'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 activer au préalable le mode développeur.
Pour activer le mode développeur et résoudre cette erreur, procédez comme suit:
- Sur votre iPhone, ouvrez l'application Paramètres, puis appuyez sur Confidentialité et sécurité.
- Faites défiler la page jusqu'à "Sécurité", puis appuyez sur Mode développeur.
- Appuyez sur le curseur Mode développeur.
- Appuyez sur Redémarrer.
- Une fois l'appareil redémarré, déverrouillez-le. La boîte de dialogue "Activer le mode développeur ?" s'affiche.
- Appuyez sur Activer. Vous pouvez maintenant lancer votre application et commencer les tests.
"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 pour vous, 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 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é l'invitation pour tester l'application pour la première fois. Réessayez en vous connectant avec le compte Google que vous avez utilisé pour accepter l'invitation.
Erreur 403: "Contactez votre administrateur pour y accéder"
Si 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 avoir l'autorisation d'installer et de tester des applications, demandez à l'administrateur de votre compte Google Workspace de modifier ses paramètres. Votre administrateur doit suivre les instructions de la section Gérer l'accès aux services qui ne sont pas contrôlés individuellement.
Si vous avez plusieurs comptes, essayez de vous connecter avec un autre compte qui n'est pas soumis à des restrictions d'installation et de test d'applications.
Activer les alertes dans l'application avec le SDK iOS App Distribution
Utilisez les conseils suivants pour résoudre les problèmes liés à l'activation des alertes de nouveau build dans l'application à l'aide du SDK iOS App Distribution.
Le testeur ne reçoit pas les 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:
Activez le mode débogage dans votre application. Pour savoir comment procéder, consultez la documentation Google Analytics.
Exécutez votre application dans un simulateur et recherchez la chaîne "[Firebase/AppDistribution]".
Vérifiez que le testeur a accès à la nouvelle version:
Si un objet de publication 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 que la vue ne s'affiche.
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 dans l'état Accepté.
Si votre testeur ne reçoit toujours pas de mises à jour, demandez-lui de suivre les conseils ci-dessous pour s'assurer qu'il a accepté l'invitation à tester votre application et qu'il a correctement configuré son appareil de test:
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.
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 nouveaux builds et installer de nouveaux builds. 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 la section 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 indiquant si votre testeur s'est déjà connecté à l'application. Pour en savoir plus, consultez le dépôt GitHub.
Questions fréquentes
Existe-t-il une limite au nombre de testeurs que je peux ajouter à mon application ?
Firebase App Distribution présente les limites suivantes pour les testeurs:
Ajouter jusqu'à 500 testeurs à un projet Firebase
Ajouter jusqu'à 200 testeurs à un groupe App Distribution
Pour ajouter d'autres 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 qu'elle n'expire. Lorsqu'une invitation est sur le point d'expirer dans cinq jours, une notification d'expiration s'affiche dans la console Firebase à côté du testeur d'une version. Vous pouvez renouveler une invitation en la renvoyant via le 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'applications sont-elles disponibles ?
Les versions d'applications sont supprimées de App Distribution si l'une des conditions suivantes se produit:
- La version de l'application date de plus de 150 jours.
- Vous avez dépassé la limite de 1 000 versions d'applications, et la version de l'application est plus ancienne que les 1 000 versions les plus récentes.
Pour en savoir plus, consultez la section App Distribution accepte un maximum de 1 000 versions.
Lorsque 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. Importez ensuite l'IPA en tant que nouveau build dans App Distribution.
- Téléchargez la version et importez-la dans Cloud Storage pour l'archivage à long terme.
Les versions d'applications expirent au bout de 150 jours
Lorsque vous importez une version de votre application dans Firebase, elle apparaît 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 de:
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 le build puisse être testé sur votre appareil.
Installez un extrait 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 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 Apple.
Comment accéder aux applications de test que j'ai installées sur mon appareil ?
Si vous êtes testeur, vous pouvez accéder à toutes vos applications de test avec le extrait 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 le profil manuellement:
Si ce n'est pas déjà fait, connectez-vous à Google et acceptez l'invitation.
Sous Applications de test, sélectionnez l'application que vous souhaitez tester.
En haut à droite de la page de l'application, appuyez sur mobile_screen_share.
Suivez les instructions affichées pour installer le profil Firebase.
Comment supprimer mon compte testeur ?
Pour supprimer votre compte testeur App Distribution et les données associées, procédez comme suit:
Accédez à https://appdistribution.firebase.google.com et connectez-vous avec votre compte Google.
En haut à droite, cliquez sur settings (Gérer le compte).
Supprimer le compte.
Facultatif: Dans les autorisations de votre compte Google, révoquez l'accès de Firebase App Distribution. Notez que la révocation de l'accès sans supprimer au préalable votre compte App Distribution n'entraîne pas la suppression de votre compte de testeur ni de vos données.