Cette page fournit une aide au 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 ci-dessous pour résoudre les problèmes que vous pourriez rencontrer lorsque vous distribuez des 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 un."
Définissez une adresse e-mail de contact dans la console Firebase, si disponible. 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 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 le fichier IPA
Voici un exemple de réponse réseau d'un 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'IPA. La taille maximale autorisée pour tous les binaires est de 2 048 Mio, soit un peu plus de 2 Go.
Si la taille du fichier IPA ne dépasse pas la limite et que le problème est reproductible, procédez comme suit :
Vérifiez votre fichier
Info.plist
et confirmez siCFBundleDisplayName
contient des délimiteurs<array>
.Supprimez les délimiteurs
<array>
et recréez votre application. L'importation devrait réussir.Si le problème persiste, contactez l'assistance Firebase.
Si la taille du fichier IPA dépasse la limite autorisée, apportez les modifications nécessaires pour la réduire.
Si la réduction de la taille du fichier IPA ne résout pas le problème, contactez l'assistance Firebase et demandez-lui des informations sur l'utilisation de Testflight.
Installer et tester des applications
Suivez les conseils ci-dessous pour résoudre les problèmes que vos testeurs peuvent rencontrer lorsqu'ils installent et testent vos applications.
Le testeur ne possède pas de compte Google
Lorsqu'un utilisateur crée un compte Google, il reçoit automatiquement une adresse Gmail.
Si un testeur ne possède 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 à son compte et de l'utiliser pour se connecter.
Lorsqu'il choisit une autre adresse e-mail, le testeur doit 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 avec cette adresse e-mail.
Pour en savoir plus, consultez Se connecter à votre compte Google avec une autre adresse e-mail.
Le testeur ne voit pas les applications ou les versions appropriées
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 versions appropriées.
L'adresse e-mail à laquelle le développeur envoie les invitations et ajoute les nouveaux builds (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 obtient l'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.
Invitez à nouveau le testeur à 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 de notifications par e-mail
Il est possible que les testeurs ne reçoivent pas de notifications par e-mail dans les cas suivants :
Les notifications par e-mail sont envoyées dans les dossiers de spam.
Des filtres de messagerie sont définis.
L'invitation a été envoyée à une adresse e-mail, mais le testeur l'a acceptée avec une autre adresse e-mail. Le testeur reçoit des e-mails concernant les nouvelles versions 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é 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
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 déjà reçu de l'application.
- En bas de l'écran, cliquez sur Gérer les paramètres de messagerie, 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 à tester des applications, il peut consulter les invitations en attente directement dans le Firebase App Distribution web clip : 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.
Invitez à nouveau 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é" lorsque vous essayez d'exécuter l'application de test
L'erreur 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. Sur l'écran Paramètres > Profils et gestion des appareils, sélectionnez le nom du développeur de l'application et approuvez-le.
Erreur "Mode développeur requis" lorsque vous essayez d'exécuter 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 activé 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 Réglages, puis appuyez sur Confidentialité et sécurité.
- Faites défiler l'écran jusqu'à "Sécurité", puis appuyez sur Mode développeur.
- Appuyez sur le bouton bascule 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 à 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 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 installée précédemment (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 y accéder"
Lorsque vous rencontrez une erreur 403, cela signifie que le compte que vous utilisez n'est pas autorisé à installer ni à 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 avez 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.
Activer les alertes dans l'application avec le SDK iOS App Distribution
Suivez les conseils ci-dessous pour résoudre les problèmes liés à l'activation des alertes de nouvelle version dans l'application à l'aide du SDK iOS App Distribution.
Le testeur ne reçoit pas d'alertes dans l'application
Si vous avez déjà configuré le SDK App Distribution iOS 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 faire, 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 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 les 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 Webclip Firebase App Distribution. N'oubliez pas de sélectionner le compte Google que vous avez utilisé 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 web clip.
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 figure dans la liste des API autorisées.
Si vous effacez généralement les 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.
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 de testeur suivantes :
Ajouter jusqu'à 500 testeurs à un projet Firebase
Ajoutez jusqu'à 200 testeurs à un groupe App Distribution.
Pour ajouter d'autres testeurs, demandez une augmentation de 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 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 depuis le menu déroulant de la ligne du testeur.
Quand une version est-elle créée pour les importations iOS ?
Consultez Enregistrer d'autres appareils.
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 avez dépassé la limite de 1 000 versions d'application, et la version de l'application est antérieure aux 1 000 versions les plus récentes.
Pour en savoir plus, 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 pour les testeurs 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 le fichier IPA et supprimez la version du tableau de bord App Distribution. Ensuite, importez à nouveau l'IPA en tant que nouvelle version sur 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 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'installeront à partir de l'application Web de testeurs App Distribution sur leur appareil de test.
Lorsque la date d'expiration de la version est dans 30 jours, une notification d'expiration de la version de l'application s'affiche sur la version sur la page App Distribution de la console Firebase et dans l'application Web de testeur 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 les versions de l'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 incluant 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 Web Clip 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 Web Clip.
Pour obtenir de l'aide sur l'installation de 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 web clip 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 :
Si vous ne l'avez pas encore 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 de testeur ?
Pour supprimer votre compte de 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 à Firebase App Distribution. Notez que la révocation de l'accès sans avoir d'abord supprimé votre compte App Distribution n'entraîne pas la suppression de votre compte ni de vos données de testeur.