Cette page fournit une aide au dépannage et des réponses aux questions fréquemment posées sur la distribution et le test d'applications avec App Distribution.
Distribution d'applications
Utilisez les conseils suivants pour résoudre les problèmes que vous pourriez rencontrer lors de la distribution d'applications à vos testeurs.
Lors de l'importation d'une application, vous pouvez rencontrer cette erreur :
"Nous n'avons pas pu trouver d'adresse e-mail de contact pour l'application <app-id> . Veuillez visiter App Distribution dans la console Firebase pour en configurer une."
Définissez une adresse e-mail de contact dans la console Firebase, si disponible. Si le problème persiste, contactez l'assistance Firebase .
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 l'identifiant de l'application.
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'IPA. La limite de taille de fichier maximale pour tous les binaires est de 2048 Mio, soit un peu plus de 2 Go.
Si la taille de l'IPA est dans la limite de taille de fichier et est reproductible, procédez comme suit :
Vérifiez votre fichier
Info.plistet confirmez siCFBundleDisplayNamecontient des délimiteurs<array>.Supprimez les délimiteurs
<array>et reconstruisez votre application. Le téléchargement devrait réussir.Si vous rencontrez toujours des problèmes, 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 posez des questions sur l'utilisation de Testflight .
Installer et tester des applications
Utilisez les conseils suivants pour résoudre les problèmes que vos testeurs peuvent rencontrer lorsqu'ils installent et testent vos applications.
Lorsqu'un utilisateur crée un compte Google, il reçoit automatiquement une adresse Gmail.
Si un testeur n'a 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'une autre adresse e-mail, le testeur doit suivre ces directives :
- 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 plus d'informations, consultez Se connecter à votre compte Google avec une autre adresse e-mail .
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 builds.
L'e-mail auquel le développeur envoie des invitations et qu'il 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 dans les 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, 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 Distribution d'applications de la console Firebase. Les invitations existantes sont supprimées.
Réinvitez le testeur à tester votre application. Le testeur devrait recevoir un e-mail d'invitation.
Assurez-vous que le testeur accepte l'invitation avec la même adresse 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 aux dossiers de spam.
Les filtres de messagerie 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 de nouvelle version pour le compte de messagerie auquel l'invitation a été initialement envoyée.
Le testeur a déjà été invité mais n'a pas accepté l'invitation initiale. Si le testeur est ajouté aux versions suivantes, App Distribution n'enverra pas automatiquement de notifications de version à ce testeur car celui-ci n'a pas accepté l'invitation initiale.
solution 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.
Si le testeur s'est désabonné des e-mails, demandez-lui de faire ce qui 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 et cliquez sur Autoriser les e-mails à se réabonner.
solution 2
Si le testeur ne se soucie pas de recevoir des notifications par e-mail et souhaite 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 Distribution d'applications dans la console Firebase. Cette action supprime les invitations existantes.
Réinvitez le testeur à tester votre application. Le testeur devrait recevoir un e-mail d'invitation. Assurez-vous que le testeur accepte l'invitation avec la même adresse e-mail à laquelle l'invitation a été envoyée.
L'erreur Développeur d'entreprise non approuvé s'affiche 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.
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 jusqu'à Sécurité et appuyez sur Mode développeur .
- Appuyez sur le curseur Mode développeur .
- Appuyez sur Redémarrer .
- Une fois l'appareil redémarré, déverrouillez l'appareil. Le bouton Activer le mode développeur ? boîte de dialogue apparaît.
- Appuyez sur Activer . Vous pouvez maintenant lancer votre application et commencer les tests.
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 mettre l'application à votre disposition, le développeur doit suivre les instructions de la section Enregistrer des appareils supplémentaires .
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.
Lorsque vous rencontrez une erreur 403, cela signifie que le compte que vous utilisez n'a pas l'autorisation d'installer et de 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 les paramètres de votre compte. Votre administrateur doit suivre les instructions de 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 compte différent qui n'est pas limité à l'installation et au test des applications.
Activation des alertes dans l'application avec le SDK App Distribution iOS
Utilisez les conseils suivants pour résoudre les problèmes impliquant l'activation des alertes de nouvelle version dans l'application à l'aide du SDK App Distribution iOS.
Si vous avez déjà configuré le SDK iOS de distribution d'applications 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 de 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 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 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é en premier lorsque vous avez accepté l'invitation à tester l'application.
Assurez-vous que la nouvelle version de l'application est disponible dans le clip Web.
Par défaut, vos testeurs n'ont besoin de se connecter qu'une seule fois à leur compte Google pour activer les nouvelles alertes de build et installer de nouvelles 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 de distribution d'applications 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 de clé , 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 .
Questions fréquemment posées
Firebase App Distribution a les limites de testeur suivantes :
Ajouter un maximum de 500 testeurs à un projet Firebase
Ajouter un maximum de 200 testeurs à un groupe de distribution d'applications
Pour ajouter plus de testeurs, demandez une augmentation de limite sans frais .
Les testeurs ont 30 jours pour accepter une invitation à tester l'application avant son expiration. Lorsqu'une invitation est à 5 jours de l'expiration, un avis d'expiration apparaît dans la console Firebase à côté du testeur sur une release. Une invitation peut être renouvelée en la renvoyant via le menu déroulant sur la ligne du testeur.
Voir Enregistrer des appareils supplémentaires .
Les versions d'application sont supprimées de la distribution d'applications 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 antérieure aux 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'applications, 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, utilisez 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 de distribution d'applications. Ensuite, re-téléchargez l'IPA en tant que nouvelle version sur App Distribution.
- Téléchargez la version et importez-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 de distribution d'applications 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 installent la version à partir de l'application Web du testeur App Distribution sur leur appareil de test.
Lorsque la version est de 30 jours à compter de la date d'expiration, une notification d'expiration de la version de l'application apparaît sur votre version dans la page App Distribution de la console Firebase et dans l'application Web de test App Distribution.
App Distribution prend en charge un maximum de 1 000 versions
La distribution d'applications autorise un maximum de 1 000 versions par application. Lorsque votre application atteint la limite de 1 000 versions d'applications, App Distribution supprime automatiquement les versions les plus anciennes au-dessus de 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 .
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 versions que vous êtes invité à tester sont automatiquement ajoutées au clip Web.
Pour obtenir de l'aide sur l'installation des profils de configuration sur votre appareil iOS, consultez la documentation d'Apple .
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 :
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.
Pour supprimer votre compte testeur App Distribution et ses données associées, suivez ces étapes dans l'ordre :
Visitez https://appdistribution.firebase.google.com et connectez-vous avec votre compte Google.
En haut à droite, cliquez sur ( 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 d'abord supprimer votre compte App Distribution ne supprime pas votre compte ou vos données de testeur.