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 APK
Vérifiez la taille de l'APK. La taille maximale autorisée pour tous les binaires est de 2 048 Mio, soit un peu plus de 2 Go.
Si la taille de l'APK respecte la limite de taille de fichier et que le problème est reproductible, contactez l'assistance Firebase.
Impossible d'importer l'APK avec fastlane. L'APK n'est pas signé.
Vérifiez que le fichier APK est signé à l'aide des éléments suivants :
apksigner verify --verbose ~/app-distro/app-distro-apps/[path_name]/app/ build/outputs/apk/debug/app-debug.apk
Distribuer des Android App Bundles (AAB)
Erreurs reçues avec la connexion aux réseaux sociaux/les fournisseurs d'API tiers
Lorsque vous importez un AAB sur App Distribution, Google Play signe de nouveau 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 s'affichent-ils également sur Google Play ?
Les versions AAB que vous importez dans App Distribution n'apparaissent pas dans votre compte de développeur Google Play (y compris dans l'explorateur d'app bundles et le partage interne d'applications).
Que se passe-t-il si je dissocie Firebase de Google Play ?
Si une application Android Firebase est dissociée de Google Play, les conséquences suivantes s'appliquent :
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 pour 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 à votre projet Firebase et à votre compte de développeur Google Play, assurez-vous de répondre aux exigences 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 dans Firebase et 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, tests fermés, tests ouverts ou 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" (et non "Tests internes à l'état brouillon"), "Tests fermés", "Tests ouverts" ou "Production".
Si vous avez importé une application qui ne répondait pas aux critères d'association ci-dessus, mais qui y répond désormais, 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 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, mais qu'il veut pouvoir accepter les invitations à tester des applications, il peut consulter les invitations 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 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.
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 que l'application 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 du 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 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 à partir de 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 un fichier APK de test ne s'installe pas 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 Considérations relatives à la 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 Android App Tester
Si l'application App Tester 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 limité.
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. 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 ContentProvider.
Vous pouvez demander au testeur de générer un rapport de bug immédiatement après avoir rencontré le problème, puis examiner le rapport pour en savoir plus sur la cause. Le testeur doit supprimer toutes les applications en conflit avant de pouvoir installer la nouvelle application.
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.
Tester sur un nouvel appareil Android
Si vous êtes un nouveau testeur, consultez Configurer votre compte de testeur.
Si vous êtes déjà testeur App Distribution et que vous obtenez un nouvel appareil Android pour effectuer des tests, au lieu de suivre à nouveau toute la procédure pour les nouveaux testeurs, 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'application App Tester en bas de l'écran pour installer l'application Android App Tester.
Activer les fonctionnalités de testeur avec le SDK Android App Distribution
Suivez les conseils ci-dessous pour résoudre les problèmes liés à l'activation des alertes de nouvelles versions dans l'application ou à l'envoi de commentaires dans l'application à l'aide du SDK Android App Distribution.
Le testeur ne peut pas envoyer 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 parviennent 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 les messages d'erreur dans les journaux de votre application en filtrant sur "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 que votre testeur n'ait pas été invité à tester 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 qui s'exécute sur l'appareil du testeur et assurez-vous que le testeur est listé dans l'onglet Testeurs de la fiche de la 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'application Testeur ou de l'application Web Testeur. Veillez à sélectionner le compte Google que vous avez utilisé la première fois lorsque vous avez accepté l'invitation à tester l'application.
Installez à nouveau l'application à l'aide de l'outil App Tester ou de l'application Web de test pour vous assurer que le testeur a accès à la version.
Essayez d'envoyer à nouveau vos commentaires, en veillant à 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 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.
Je ne reçois pas 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 la commande suivante :
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 les messages d'erreur dans les journaux de votre application en filtrant sur "FirebaseAppDistribution".
Le testeur ne reçoit pas d'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 ajoutant 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 faire, 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 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 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 App Tester ou l'application Web pour les testeurs. 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.
Vérifiez que la nouvelle version de l'application est disponible dans l'application App Tester ou 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 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 SharedPreferences 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.
Accéder à l'aperçu de l'agent de test d'application
Comment accéder à l'agent de test d'applications ?
Pour accéder à l'aperçu de l'agent de test d'application, vous pouvez activer et commencer à utiliser la fonctionnalité via la bannière sur la page "Versions" de la console Firebase.
Si vous avez fermé la bannière et que seuls des tests guidés par l'IA ont été exécutés sur une version, vous pouvez activer l'agent App Testing depuis l'onglet "Testeur automatique". Un éditeur de votre projet peut importer une version et exécuter un test guidé par l'IA sur une version qui ne comporte pas de tests d'exploration aléatoire. Vous devriez maintenant pouvoir activer le testeur automatique en accédant à l'onglet "Testeur automatique" de cette version.
Si vous ne parvenez toujours pas à activer la fonctionnalité, contactez l'assistance Firebase en indiquant le message suivant : "Demande d'accès à l'agent de test d'application App Distribution".
Si j'active cette fonctionnalité, sera-t-elle disponible pour toute mon équipe ou uniquement pour moi ?
Cette opération n'activera la fonctionnalité que pour votre compte.
J'ai activé la fonctionnalité, mais je ne la vois toujours pas
Essayez d'actualiser la page. Si vous ne parvenez toujours pas à afficher la fonctionnalité après avoir actualisé votre navigateur, contactez l'assistance Firebase en indiquant le message suivant : "Demande d'accès à l'agent App Distribution App Testing".
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.
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 se produit :
- 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, 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. Ensuite, importez à nouveau l'APK ou l'AAB 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 Firebase App Tester 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 votre version 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 les versions de l'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 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 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 identiques. 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 Niveaux d'utilisation, quotas et tarifs pour Test Lab.
Quelles sont les limites de quota pour la fonctionnalité Testeur automatique ?
Si vous dépassez le quota, des erreurs de dépassement de quota s'affichent. Les quotas mettent environ 24 heures à se réinitialiser. Vous devez donc éviter de réessayer tant que le quota n'est pas libéré. Toutefois, si vous recevez des erreurs liées à l'infrastructure du testeur automatique, 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 de testeur automatisé ?
Pour exécuter des tests avec la fonctionnalité de testeur automatisé, vous devez disposer d'un accès en tant qu'éditeur au projet 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.