Cette page fournit des conseils de dépannage et des réponses aux questions fréquentes questions sur la distribution et le test d'applications avec App Distribution.
Distribuer des applications
Utilisez les conseils suivants pour résoudre les problèmes que vous pourriez rencontrer lorsque distribuer 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:
"Impossible de trouver une adresse e-mail de contact pour l'application <app-id>
. Rendez-vous sur
App Distribution dans la console Firebase pour en configurer un."
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 à plusieurs reprises des erreurs 400, 409 ou 500 lors du provisionnement, contactez l'assistance Firebase. Fournissez Obtenez de l'aide concernant votre numéro de projet Firebase et l'identifiant de votre application.
Impossible d'importer l'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'alcool isopropylique. 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 comprise dans la limite de taille du fichier et qu'elle est reproductible, suivez 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 doit pour réussir.Si le problème persiste, contactez l'assistance Firebase.
Si la taille de l'IPA dépasse la limite de taille du fichier, apportez les modifications nécessaires à 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 posez des questions sur l'utilisation Testflight :
Installer et tester des applications
Utilisez les conseils suivants pour résoudre les problèmes que vos testeurs pourraient rencontrer rencontrent quand ils installent et testent vos applications.
Le testeur ne dispose pas d'un 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 Utilisez plutôt une autre adresse e-mail pour vous connecter, demandez au testeur d'associer une adresse e-mail autre que Gmail l'adresse e-mail du compte et l'utiliser pour vous connecter.
Lorsqu'il choisit une adresse e-mail secondaire, le testeur doit suivre 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 pour vous connecter avec cette adresse e-mail adresse e-mail.
Pour en savoir plus, consultez Se connecter à votre 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 que le testeur n'ait pas accès aux applications ou compilations.
Adresse e-mail à laquelle le développeur envoie des invitations et ajoute des versions aux nouveaux builds (Adresse e-mail A) peut être différente de l'adresse e-mail que le testeur utilise pour accepter les d'invitation (e-mail B). Un lien est alors créé en arrière-plan. À chaque fois que l'e-mail A est ajoutée aux nouvelles constructions, c’est en fait l’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.
Invitez de nouveau le testeur à tester votre application. Le testeur doit recevoir une 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
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 ne le sera pas envoie automatiquement des 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 : suivantes:
- 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 se 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 depuis la section Afficher tous les testeurs de l'onglet Testeurs et Onglet "Groupes" dans App Distribution de 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.
"Développeur d'entreprise non approuvé" erreur lors de la tentative d'exécution de l'application de test
Si vous ne l'avez pas fait, le message d'erreur Développeur d'entreprise non approuvé s'affiche. faire confiance au certificat du développeur sur l'appareil de test avant d'ouvrir l'application. Dans l'application Paramètres > Profils et sur l'écran "Gestion des appareils", sélectionnez l'icône son nom de développeur et faites-lui confiance.
"Mode développeur requis" erreur lors de la tentative d'exécution de l'application de test
Le message d'erreur "Mode développeur requis" s'affiche lorsque vous essayez de lancer une annonce. application iOS provisionnée par hoc sur iOS 16 ou version ultérieure sans activation au préalable des d'attention.
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 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. Activer le mode développeur ? s'affiche.
- Appuyez sur Activer. Vous pouvez maintenant lancer votre application et commencer les tests.
"L'appareil a bien été enregistré. Vous avez terminé. 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 que vous puissiez accéder à l'application, le développeur doit suivez 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 utilisée installé (ou pour lequel vous avez accepté une invitation), vous avez probablement signé au mauvais compte Google. Les applications auxquelles vous avez accès sont associés au compte Google que vous avez utilisé lorsque vous avez accepté le une invitation à tester l'application. Réessayez en vous connectant avec le compte Google que vous avez utilisée précédemment pour accepter l'invitation.
Erreur 403 : "Contactez votre administrateur pour obtenir l'accès"
Une erreur 403 signifie que le compte que vous utilisez n'est pas autorisé à installer ni à tester les 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 avez plusieurs comptes, essayez de vous connecter avec un autre compte qui n'est pas restreint pour installer et tester des 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 d'alertes dans l'application
Si vous avez déjà configuré le SDK iOS App Distribution dans votre application et votre les testeurs ne reçoivent pas d'alertes dans l'application, vérifiez que votre application est récupération des nouveautés:
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 "release" valide est renvoyé, il est probable un problème dans le cycle de vie du contrôleur de vue où la boîte de dialogue d'alerte est chargé 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 Firebase, assurez-vous que votre testeur est inclus dans votre build et dont l'état est Accepté.
Si votre testeur ne reçoit toujours pas de notifications, demandez-lui de suivre les instructions conseils ci-dessous pour vous assurer qu'ils ont accepté l'invitation à tester votre l'application et qu'il a correctement configuré son appareil de test:
Sur l'appareil de test, connectez-vous à la plate-forme Web Firebase App Distribution . N'oubliez pas de sélectionner le compte Google que vous avez utilisé pour la première fois a accepté l'invitation à tester l'application.
Assurez-vous que la nouvelle version de l'appli est disponible dans l'extrait 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 nouvelle compilation et installer de nouvelles compilations. Si vos testeurs sont vous êtes invité à vous reconnecter après avoir fermé et rouvert votre application, procédez comme suit : conseils pour vous assurer que votre configuration App Distribution est correctement définie:
Assurez-vous d'avoir activé l'API Firebase App Testers. Pour plus plus d'informations, consultez la section Activer l'API App Distribution Tester.
Sous Restrictions relatives aux clés, assurez-vous que l'API Firebase App Testers est figure 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 les Dépôt GitHub.
Questions fréquentes
Existe-t-il des limites pour ajouter des testeurs à mon application ?
Les limites suivantes pour les testeurs s'appliquent à Firebase App Distribution:
Ajouter un maximum de 500 testeurs à un projet Firebase
Ajouter un maximum de 200 testeurs à un groupe App Distribution
Pour ajouter des testeurs, demandez un accès sans frais d'augmentation de la limite.
Mes invitations en tant que testeurs expirent-elles ?
Les testeurs disposent de 30 jours pour accepter une invitation à tester l'application avant qu'elle n'expire. Lorsqu'un délai de cinq jours avant l'expiration d'une invitation est écoulé, un avis d'expiration s'affiche dans la Console Firebase à côté du testeur sur une version. Vous pouvez renouveler une invitation en le renvoyant via le menu déroulant de la ligne du testeur.
Quand une nouvelle version est-elle créée pour les importations sur iOS ?
Consultez Enregistrer des appareils supplémentaires.
Pendant combien de temps les versions d'application sont-elles disponibles ?
Les versions de l'appli sont supprimées de App Distribution si l'un des éléments suivants 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 les 1 000 applications limite de release, la version est supprimée du tableau de bord App Distribution et Application Web de testeur App Distribution. Si le testeur a installé la version, continue de s'exécuter.
Pour que la version de l'application reste disponible plus longtemps, appliquez l'une des recommandations suivantes:
- Avant que la version de l'application n'expire ou ne dépasse la limite autorisée, téléchargez le IPA et supprimez la version du tableau de bord App Distribution. Ensuite, importez à nouveau l'IPA en tant que nouvelle version dans App Distribution.
- Téléchargez la release et importez-la dans Cloud Storage. pour l'archivage à long terme.
Les versions d'une application expirent au bout de 150 jours
Lorsque vous importez une version de votre application dans Firebase, elle apparaît dans la section Tableau de bord App Distribution pendant 150 jours à compter de la date d'importation. Une fois l'album importé, peut la distribuer aux testeurs, qui installent la version à partir de App Distribution. l'application Web de testeur sur son appareil de test.
Lorsque 30 jours se sont écoulés entre la date d'expiration et la date de sortie d'une release, La notification d'expiration s'affiche pour votre release sur la page App Distribution de la console Firebase et dans l'application Web de test App Distribution.
App Distribution accepte jusqu'à 1 000 versions
App Distribution autorise un maximum de 1 000 versions par application. Lorsque votre application atteint la limite de 1 000 versions, App Distribution supprime automatiquement les plus anciens versions qui dépassent la limite.
Si vous souhaitez gérer manuellement les versions de votre application, utilisez l'API REST App Distribution. pour répertorier et supprimer de nouvelles versions de vos applications de façon groupée.
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 d'effectuer les opérations suivantes:
Enregistrer l'appareil de test en collectant son ID unique (UDID). Si vous testez une distribution ad hoc, Firebase envoie l'application au développeur un e-mail contenant l'UDID de l'appareil de test, ainsi que des instructions pour inclure l'appareil dans le provisionnement de l'application ; afin que le build puisse être testé sur votre appareil.
Installer un extrait du Web de Firebase App Distribution sur la maison de votre appareil l'écran. Cet extrait du Web vous permet d'installer toutes vos applis de test et d'y accéder au même endroit. Les nouveaux builds que vous êtes invité à tester sont automatiquement ajoutée à l'extrait du Web.
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 testeur, vous pouvez accéder à toutes vos applications de test à l'aide de l' Extrait du Web Firebase App Distribution, qui est automatiquement ajouté à votre test l'écran d'accueil de votre appareil 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 Pour une distribution d'entreprise, vous pouvez installer manuellement le profil:
Si vous ne l'avez pas déjà fait, connectez-vous à Google et acceptez l'invitation.
Sous Tester les applications, 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 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 Gérer le compte settings.
Supprimer le compte
(Facultatif) Dans les autorisations de votre compte Google : révoquer l'accès accordé à Firebase App Distribution. Notez que la révocation d'accès la suppression initiale de votre compte App Distribution ne supprime pas votre testeur. votre compte ou vos données.