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 du téléchargement d'une application, vous pouvez rencontrer cette erreur :
"Nous n'avons pas trouvé d'adresse e-mail de contact pour l'application <app-id> . Veuillez visiter App Distribution dans la console Firebase pour en créer une."
Définissez une adresse e-mail de contact dans la console Firebase, si disponible. Si le problème persiste, contactez le support 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 votre identifiant d'application.
Vérifiez la taille de l'APK. La limite maximale de taille de fichier pour tous les fichiers binaires est de 2 048 Mo, soit un peu plus de 2 Go.
Si la taille de l'APK se situe dans la limite de taille de fichier et est reproductible, contactez l'assistance Firebase .
Vérifiez que l'APK est signé en utilisant les éléments suivants :
apksigner verify --verbose ~/app-distro/app-distro-apps/[path_name]/app/ build/outputs/apk/debug/app-debug.apk
Distribution d'App Bundles Android (AAB)
Lorsque vous téléchargez un AAB sur App Distribution, Google Play annule automatiquement l'APK généré à l'aide d'un certificat de clé de signature d'application de test. Lorsque vous y êtes invité, vous devez enregistrer votre application auprès des fournisseurs d'API si vous souhaitez continuer à utiliser leurs services tiers. Une fois signé, le certificat de test de votre application peut être consulté dans la console Firebase.
Les builds AAB que vous téléchargez sur App Distribution n'apparaissent pas dans votre compte de développeur Google Play (cela inclut App Bundle Explorer et le partage d'applications interne).
Si une application Android Firebase n'est pas associée à Google Play, les événements suivants se produisent :
Vous ne pourrez pas télécharger de nouveaux app bundles sur App Distribution et les exporter vers Google Play via l'intégration d'App Distribution avec Google Play.
Les versions existantes continueront d'être disponibles dans le tableau de bord Firebase App Distribution et pour vos testeurs.
Toutes les données précédemment exportées entre Firebase et Google Play resteront accessibles dans les deux produits.
Pour distribuer un Android App Bundle (AAB) via App Distribution et lier automatiquement les AAB téléchargés à votre projet Firebase et à votre compte de développeur Google Play, assurez-vous de remplir les conditions suivantes :
Votre compte développeur Google Play possède l'un des niveaux d'accès suivants : Propriétaire ou Administrateur.
Pour votre projet Firebase, vous disposez de l'un des rôles suivants : Propriétaire ou Administrateur Firebase .
Votre application est enregistrée auprès de Firebase et de votre compte de développeur Google Play. Cela signifie que vous disposez à la fois d’une application Firebase Android et d’une application Google Play.
L'application sur Google Play et l'application Firebase Android sont toutes deux enregistrées sous le même nom de package.
L'application dans Google Play est configurée sur le tableau de bord de l'application et est distribuée sur l'une des pistes de Google Play (tests internes, tests fermés, tests ouverts ou production).
L'examen de l'application sur Google Play est terminé et l'application est publiée. Votre application est publiée si la colonne Statut de l'application affiche l'un des statuts suivants : Test interne (pas de test interne préliminaire), Test fermé, Test ouvert ou Production.
Si vous avez téléchargé une application qui ne répondait pas auparavant aux critères d'association répertoriés ci-dessus, mais que c'est le cas maintenant, vous pouvez réessayer d'associer votre application Android Firebase à Google Play .
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 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 d'utiliser cette adresse e-mail pour se connecter.
Lors du choix d'un autre e-mail, le testeur doit suivre ces directives :
- N'utilisez pas d'adresse Gmail.
- N'utilisez pas une adresse e-mail déjà lié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 Connectez-vous à 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 soit pas en mesure de voir les bonnes applications ou builds.
L'e-mail auquel le développeur envoie des invitations et 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 en 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, suivez ces étapes 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 email 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 dans des dossiers spam.
Des filtres de courrier électronique 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 des nouvelles versions pour le compte de messagerie auquel l'invitation a été initialement envoyée.
Le testeur a été préalablement 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 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 procéder comme suit :
- Recherchez un e-mail que le testeur a déjà reçu de l'application.
- Cliquez sur Gérer les paramètres de messagerie en bas et cliquez sur Autoriser le réabonnement des e-mails .
Solution 2
Si le testeur ne souhaite pas de notifications par e-mail mais souhaite pouvoir accepter les invitations à des applications, il peut afficher les invitations à des applications en attente directement dans l'application App Tester ( instructions de téléchargement ).
Solution 3
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. Cette action supprime les invitations existantes.
Réinvitez le testeur à tester votre application. Le testeur devrait recevoir un email d'invitation. Assurez-vous que le testeur accepte l'invitation avec la même adresse e-mail à laquelle l'invitation a été envoyée.
Si un testeur télécharge et installe une version mais que l'interface utilisateur des détails de l'application n'indique pas que l'application est installée, il s'agit d'un problème connu. Dans certains cas, l'ID du bundle dans l'application Firebase ne correspond pas à l'ID du bundle de l'APK.
Vérifiez que l'ID de bundle de l'APK correspond à l'ID de bundle de l'application Firebase que vous avez utilisée pour télécharger la distribution.
L'alerte Android apparaît si votre application ou votre navigateur en cours d'exécution n'a pas encore été autorisé à installer des applications en dehors de Google Play. Pour accorder l'autorisation :
Android version 8 ou ultérieure : dans l'application Paramètres , appuyez sur Autoriser à partir de cette source .
Android version 7 ou antérieure : dans l'application Paramètres , appuyez sur Sécurité et sélectionnez Sources inconnues . Lorsque l'invite apparaît, appuyez sur OK > Confiance .
Si un APK de test ne parvient pas à s'installer sur l'appareil d'un testeur :
- Vérifiez que le(s) certificat(s) de la nouvelle version correspondent à ceux de la version installée sur l'appareil du testeur. Le système Android permet uniquement à l'application de se mettre à jour si les certificats correspondent. Pour en savoir plus, consultez Considérations sur la signature .
- Assurez-vous que la version du système d'exploitation de l'appareil testeur est prise en charge par l'application (vérifiez le
minSdkVersion).
Si l'application App Tester vous empêche de vous connecter et vous redirige vers l'écran de connexion, vous utilisez peut-être un espace de travail Google (anciennement GSuite) qui inclut des paramètres de restriction.
Pour supprimer vos paramètres de restriction :
Dans l' onglet Applications de votre espace de travail Google, assurez-vous que Firebase App Distribution n'est pas défini sur Accès : bloqué .
Dans l' onglet Services , assurez-vous que Cloud Platform n'est pas restreint.
Une fois les paramètres supprimés, essayez de vous reconnecter.
Cette erreur peut se produire lorsque l'application en cours d'installation entre en conflit avec une application déjà installée sur l'appareil. Par exemple, il peut s'agir d'une variante différente de la même application avec la même autorisation personnalisée ou le même nom de ContentProvider .
Vous pouvez demander au testeur de collecter un rapport de bogue immédiatement après avoir rencontré le problème et d'inspecter le rapport pour plus d'informations sur la cause. Le testeur doit supprimer toutes les applications en conflit avant que la nouvelle application puisse être installée.
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 dans Gérer l'accès aux services qui ne sont pas contrôlés individuellement .
Si vous disposez de plusieurs comptes, essayez de vous connecter avec un autre compte qui n'est pas limité à l'installation et au test d'applications.
Si vous êtes un testeur novice, consultez Se configurer en tant que testeur .
Si vous êtes déjà un testeur d'App Distribution et que vous disposez d'un nouvel appareil Android sur lequel tester, au lieu de parcourir à nouveau l'intégralité du flux du nouveau testeur, procédez comme suit :
Accédez à appdistribution.firebase.google.com sur votre appareil Android.
Connectez-vous avec votre compte de testeur existant et cliquez sur le bouton Télécharger App Tester en bas de l'écran pour installer l'application Android App Tester.
Activation des fonctionnalités du testeur avec le SDK Android App Distribution
Utilisez les conseils suivants pour résoudre les problèmes liés à l’activation d’alertes de nouvelle build dans l’application ou à l’envoi de commentaires dans l’application à l’aide du SDK Android App Distribution.
Si vous avez déjà configuré le SDK Android App Distribution dans votre application pour prendre en charge les commentaires dans l'application et que vos testeurs ne sont pas en mesure d'envoyer des commentaires, procédez comme suit :
Activez la journalisation détaillée pour le SDK Android App Distribution dans votre application :
adb shell setprop log.tag.FirebaseAppDistribution VERBOSERecherchez les messages d'erreur dans les journaux de vos applications en filtrant "FirebaseAppDistribution".
Confirmez que le testeur a accès à la version installée :
Si les journaux indiquent que « le testeur n'a pas accès à cette ressource », votre testeur n'a peut-être pas été invité à l'application ou n'a peut-être pas accès à la version.
Dans le tableau de bord App Distribution de la console Firebase, recherchez la version exacte en cours d'exécution sur l'appareil du testeur et assurez-vous que le testeur est répertorié dans l'onglet Testeurs de la carte de version et qu'il est à l'état Accepté.
Si vous ne recevez toujours pas de commentaires, procédez comme suit :
Sur l'appareil de test, connectez-vous à Firebase App Distribution à l'aide d'App Tester ou de l'application Web du testeur. Assurez-vous de sélectionner le compte Google que vous avez utilisé pour la première fois lorsque vous avez accepté l'invitation à tester l'application.
Installez à nouveau l'application à l'aide d'App Tester ou de l'application Web de test pour vous assurer que le testeur a accès à la version.
Essayez d'envoyer vos commentaires, en veillant encore une fois à vous connecter avec le même compte Google.
Assurez-vous d'avoir activé l'API Firebase App Testers. Pour plus d’informations, consultez Activer l’API App Distribution Tester .
Sous Restrictions clés , assurez-vous que l'API Firebase App Testers est incluse dans la liste des API autorisées.
Si vous voyez ce message lors de l'envoi de commentaires : "Aurait envoyé des commentaires, mais ne l'a pas fait en raison du mode développement", désactivez le mode développeur sur l'appareil en exécutant cette commande :
adb shell setprop debug.firebase.appdistro.devmode falseVérifiez votre fichier
google-services.jsonpour vous assurer que vous soumettez des commentaires pour le bon projet et la bonne application.Activez la journalisation détaillée pour le SDK Android App Distribution dans votre application :
adb shell setprop log.tag.FirebaseAppDistribution VERBOSERecherchez les messages d'erreur dans les journaux de vos applications en filtrant "FirebaseAppDistribution".
Si vous avez déjà configuré le SDK Android App Distribution dans votre application et que vos testeurs ne reçoivent pas d'alertes dans l'application, procédez comme suit :
Recherchez les messages d'erreur en attachant un
OnFailureListenerà la tâche renvoyée par l'API Firebase App Distribution.Java
firebaseAppDistribution.updateIfNewReleaseAvailable().addOnFailureListener ( e -> { if (e instanceof FirebaseAppDistributionException) { // Log exception here }});Kotlin
firebaseAppDistribution.updateIfNewReleaseAvailable().addOnFailureListener { e -> if (e is FirebaseAppDistributionException) { // Log exception here } }Vérifiez que le testeur a accès à la nouvelle version :
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 « FirebaseAppDistribution ».
Si les journaux indiquent qu'aucune version n'a été trouvée ou que le testeur n'y a pas accès, 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 d'alertes, demandez-lui de suivre les conseils ci-dessous pour vous 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 à Firebase App Distribution via App Tester ou via l'application Web du testeur. 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.
Vérifiez que la nouvelle version de l'application est disponible dans App Tester ou dans l'application Web du testeur.
Par défaut, vos testeurs ne doivent se connecter qu'une seule fois à leur compte Google pour activer les fonctionnalités de test. Si vos testeurs sont invités à se reconnecter après la fermeture et la réouverture de 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 plus d’informations, consultez Activer l’API App Distribution Tester .
Sous Restrictions 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 les préférences partagées 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 présente les limites de testeur suivantes :
Ajouter un maximum de 500 testeurs à un projet Firebase
Ajouter un maximum de 200 testeurs à un groupe App Distribution
Pour ajouter davantage de testeurs, demandez une augmentation de la limite sans frais .
Les testeurs disposent de 30 jours pour accepter une invitation à tester l’application avant son expiration. Lorsqu'une invitation expire dans 5 jours, un avis d'expiration apparaît dans la console Firebase à côté du testeur sur une version. Une invitation peut être renouvelée en la renvoyant via le menu déroulant sur la ligne du testeur.
Les versions d'application sont supprimées d'App Distribution 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 plus ancienne que les 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, la version est supprimée du tableau de bord App Distribution et de l'application Firebase App Tester. 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 version, téléchargez l'APK ou l'AAB et supprimez la version du tableau de bord App Distribution. Ensuite, téléchargez à nouveau l'APK ou l'AAB en tant que nouvelle version sur App Distribution.
- Téléchargez la version et téléchargez-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 App Distribution 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 l'installent à partir de l'application Firebase App Tester 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 apparaît sur votre version dans l'application Firebase App Tester.
App Distribution prend en charge un maximum de 1 000 versions
App Distribution autorise un maximum de 1 000 versions par application. Lorsque votre application atteint la limite de 1 000 versions d’application, App Distribution supprime automatiquement les versions les plus anciennes dépassant 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 .
Si vous êtes un testeur, nous vous recommandons de télécharger Firebase App Tester , une application qui vous permet d'accéder à toutes vos versions de test en un seul endroit.
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 supprimer au préalable votre compte App Distribution ne supprime pas votre compte ou vos données de testeur.