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 APK
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'APK est inférieure à la limite de taille de fichier et qu'elle est reproductible, contactez l'assistance Firebase.
Impossible d'importer l'APK avec Fastlane. L'APK n'est pas signé.
Vérifiez que l'APK est signé à l'aide de la commande suivante:
apksigner verify --verbose ~/app-distro/app-distro-apps/[path_name]/app/ build/outputs/apk/debug/app-debug.apk
Distribuer des Android App Bundles (AAB)
Recevoir des erreurs avec les fournisseurs d'API tiers/connexion aux réseaux sociaux
Lorsque vous importez un AAB dans App Distribution, Google Play signe 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 AAB que j'importe-t-elle également apparaître sur Google Play ?
Les builds AAB que vous importez dans App Distribution n'apparaissent pas dans votre compte de développeur Google Play (cela inclut l'explorateur d'app bundle et le partage d'application interne).
Que se passe-t-il si je dissocie Firebase de Google Play ?
Si une application Android pour Firebase est dissociée de Google Play, les conséquences sont les suivantes:
Vous ne pourrez pas importer de nouveaux app bundles dans App Distribution ni les exporter vers Google Play via l'intégration de App Distribution à Google Play.
Les builds existants resteront disponibles dans le tableau de bord Firebase App Distribution et auprès de vos testeurs.
Les données précédemment partagées entre Firebase et Google Play resteront accessibles dans les deux produits.
Puis-je réessayer d'associer une application à Google Play ?
Pour distribuer un Android App Bundle (AAB) via App Distribution et associer automatiquement les AAB importés à la fois à votre projet Firebase et à votre compte de développeur Google Play, assurez-vous de respecter les conditions suivantes:
Votre compte de développeur Google Play dispose de l'un des niveaux d'accès suivants : propriétaire ou administrateur.
Vous disposez de l'un des rôles suivants pour votre projet Firebase : 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 Android pour Firebase et d'une application Google Play.
L'application dans Google Play et l'application Android pour Firebase sont enregistrées sous le même nom de package.
L'application dans Google Play est configurée dans le tableau de bord des applications et distribuée dans l'un des canaux Google Play (tests internes, de tests fermés, de tests ouverts ou de production).
Une fois l'examen de l'application dans Google Play terminé, celle-ci est publiée. Votre application est publiée si la colonne État de l'application indique l'un des états suivants : "Tests internes" (pas "Brouillon" ni "Tests internes"), "Tests fermés", "Tests ouverts" ou "Production".
Si vous avez importé une application qui ne remplissait pas auparavant les critères d'association listés ci-dessus, mais qui le fait maintenant, vous pouvez réessayer d'associer votre application Android Firebase à Google Play.
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, mais qu'il souhaite pouvoir accepter les invitations d'application, il peut afficher les invitations d'application en attente directement dans l'application Testeur d'applications (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 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.
L'application n'indique pas qu'elle est installé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 qu'elle est installée, il s'agit d'un problème connu. Dans certains cas, l'ID de bundle de l'application Firebase ne correspond pas à celui de l'APK.
Vérifiez que l'ID de bundle de l'APK correspond à celui de l'application Firebase que vous avez utilisée pour importer la distribution.
Alerte Android indiquant que mon appareil ne peut pas installer d'applications inconnues
L'alerte Android s'affiche 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 8 ou version ultérieure: dans l'application Paramètres, appuyez sur Autoriser depuis cette source.
Android 7 ou version antérieure: dans l'application Paramètres, appuyez sur Sécurité, puis sélectionnez Sources inconnues. Lorsque l'invite s'affiche, appuyez sur OK > Approuver.
Échec de l'installation des APK de test
Si l'installation d'un APK de test échoue sur l'appareil d'un testeur:
- Vérifiez que le ou les certificats de la nouvelle version correspondent à ceux de la version installée sur l'appareil du testeur. Le système Android n'autorise la mise à jour de l'application que si les certificats correspondent. Pour en savoir plus, consultez la section Consignes de signature.
- Assurez-vous que la version de l'OS de l'appareil de test est compatible avec l'application (consultez
minSdkVersion
).
Impossible de se connecter à l'application Testeur d'applications Android
Si l'application Testeur d'applications vous empêche de vous connecter et vous redirige vers l'écran de connexion, il est possible que vous utilisiez un compte Google Workspace (anciennement G Suite) qui inclut des paramètres de restriction.
Pour supprimer vos paramètres de restriction:
Dans l'onglet Applications de votre compte Google Workspace, 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 soumis à des restrictions.
Une fois les paramètres supprimés, réessayez de vous connecter.
Erreur lors de l'installation d'un AAB: "Impossible d'installer l'application"
Cette erreur peut se produire lorsque l'application en cours d'installation est en conflit avec une application déjà installée sur l'appareil. Il peut s'agir, par exemple, 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 générer un rapport de bug immédiatement après avoir rencontré le problème, puis d'examiner le rapport pour en savoir plus sur la cause. Le testeur doit supprimer toutes les applications en conflit avant que la nouvelle application puisse être installée.
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.
Tester sur un nouvel appareil Android
Si vous êtes un testeur pour la première fois, consultez Configurer votre compte de testeur.
Si vous êtes déjà testeur App Distribution et que vous recevez un nouvel appareil Android à tester, au lieu de suivre à nouveau l'intégralité du parcours de testeur, procédez comme suit:
Accédez à appdistribution.firebase.google.com sur votre appareil Android.
Connectez-vous avec votre compte de testeur existant, puis cliquez sur le bouton Télécharger l'appli Testeur d'applications en bas de l'écran pour installer l'application Testeur d'applications Android.
Activer les fonctionnalités de test avec le SDK Android App Distribution
Suivez les conseils ci-dessous pour résoudre les problèmes liés à l'activation d'alertes de nouveau build dans l'application ou à l'envoi de commentaires dans l'application à l'aide du SDK Android App Distribution.
Le testeur ne peut pas démarrer de commentaires dans l'application
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 peuvent pas envoyer de 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 VERBOSE
Recherchez des messages d'erreur dans les journaux de votre application en filtrant par "FirebaseAppDistribution".
Vérifiez que le testeur a accès à la version installée:
Si les journaux indiquent que "le testeur n'a pas accès à cette ressource", il est possible qu'il n'ait pas été invité à l'application ou qu'il n'ait pas accès à la version.
Dans le tableau de bord App Distribution de la console Firebase, recherchez la version exacte exécutée sur l'appareil du testeur et assurez-vous que le testeur est listé dans l'onglet Testeurs de la fiche 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 de l'appli de test ou de l'appli Web de test. Veillez à sélectionner le compte Google que vous avez utilisé pour la première fois lorsque vous avez accepté l'invitation à tester l'application.
Réinstallez 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 des commentaires, en vous assurant de vous connecter avec le même compte Google.
Assurez-vous d'avoir activé l'API Firebase App Testers. Pour en savoir plus, consultez Activer l'API Testeur de distribution d'applications.
Sous Restrictions relatives aux clés, assurez-vous que l'API Firebase App Testers est incluse dans la liste des API autorisées.
Je n'ai pas reçu les commentaires envoyés dans l'application
Si le message "J'aurais envoyé des commentaires, mais je ne l'ai pas fait à cause du mode de développement" s'affiche lorsque vous envoyez des commentaires, désactivez le mode développeur sur l'appareil en exécutant cette commande:
adb shell setprop debug.firebase.appdistro.devmode false
Vérifiez votre fichier
google-services.json
pour vous assurer que vous envoyez 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 VERBOSE
Recherchez des messages d'erreur dans les journaux de votre application en filtrant sur "FirebaseAppDistribution".
Le testeur ne reçoit pas les alertes dans l'application
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 joignant un
OnFailureListener
à la tâche renvoyée par l'API App Distribution de Firebase.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, il est possible qu'il 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 d'alertes, 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 à Firebase App Distribution via l'appli testeur ou via l'appli Web de 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 l'application de test ou dans l'application Web de test.
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 fonctionnalités de test. 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 SharedPreferences à 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.
Pendant combien de temps les versions d'applications sont-elles disponibles ?
Les versions d'application 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.
Une fois que l'application a atteint ou dépassé 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 versions, téléchargez l'APK ou l'AAB, puis supprimez la version du tableau de bord App Distribution. Importez ensuite l'APK ou l'AAB en tant que nouveau build sur 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 depuis l'application Firebase App Tester sur leur appareil de test.
Lorsque la version est à 30 jours de l'expiration, une notification d'expiration de la version de l'application s'affiche dans l'application Firebase App Tester.
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.
Comment accéder aux applications de test que j'ai installées sur mon appareil ?
Si vous êtes testeur, nous vous recommandons de télécharger Firebase App Tester, une application qui vous permet d'accéder à tous vos builds de test au même endroit.
Existe-t-il des limites de quota pour la fonctionnalité Testeur automatique ?
Firebase App Distribution utilise l'infrastructure Firebase Test Lab. Ses limites de quota et ses tarifs sont les mêmes. Les quotas de test sont mesurés en fonction du nombre de tests exécutés par jour. Pour en savoir plus sur les quotas de test et la facturation, consultez la section Niveaux d'utilisation, quotas et tarifs pour Test Lab.
Quelles sont les limites de quota de nouvelle tentative pour la fonctionnalité Testeur automatique ?
Si vous dépassez le quota, des erreurs de dépassement de quota s'affichent. La réinitialisation des quotas prend environ 24 heures. Vous devez donc éviter les nouvelles tentatives jusqu'à ce que le quota soit libéré. Toutefois, si vous recevez des erreurs liées à l'infrastructure du testeur automatisé, les appels ont plus de chances de réussir si vous réessayez immédiatement.
De quelles autorisations ai-je besoin pour exécuter la fonctionnalité bêta du testeur automatique ?
Vous devez disposer d'un accès éditeur au projet Firebase pour pouvoir exécuter des tests avec la fonctionnalité de testeur automatisé.
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.