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 le fichier APK
Vérifiez la taille de l'APK. La taille maximale des fichiers binaires est 2 048 Mio, soit un peu plus de 2 Go.
Si la taille de l'APK est inférieure à la limite de taille de fichier et 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 Bundle (AAB)
Erreurs liées aux réseaux sociaux connexion/fournisseurs d'API tiers
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 à l'utiliser leurs services tiers. Une fois signé, le certificat de test de votre application dans la console Firebase.
Les AAB que j'importe-ils s'affichent-ils également sur Google Play ?
Les builds AAB que vous importez dans App Distribution n'apparaissent pas sur Google Play compte de développeur (y compris l'explorateur d'app bundle et le partage interne d'application).
Que se passe-t-il en cas de dissociation ? Firebase de Google Play ?
Voici ce qui se produit si une application Android pour Firebase est dissociée de Google Play:
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.
Toutes les données précédemment exportées entre Firebase et Google Play seront conservées 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 est associé à l'un des éléments suivants : niveaux d'accès: 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 développeur Google Play. de service. Cela signifie que vous disposez à la fois d'une application Firebase pour Android et d'une application Play.
L'application dans Google Play et l'application Firebase pour Android sont toutes deux enregistrées. en utilisant le même nom de package.
L'application dans Google Play est configurée dans l'application. tableau de bord et elle est distribuée dans l'un des canaux Google Play (tests internes, tests fermés, 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 affiche l'un des éléments suivants à un état : "Test interne" (et non "Brouillon de test interne"), Tests fermés. Tests ouverts ou Production.
Si vous avez importé une application qui ne répondait pas aux critères listés ci-dessus pour 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 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, mais qu'il veut pouvoir les accepter il peut consulter les invitations en attente directement dans l'application. Application de test (instructions de téléchargement).
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.
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 dans l'application Firebase ne correspond pas à l'ID de bundle 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'applis inconnues
L'alerte Android s'affiche si votre application ou votre navigateur en cours d'exécution n'a pas encore reçu de réponse l'autorisation d'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 apparaît, appuyez sur OK > Confiance :
Échec de l'installation des APK de test
Si l'installation d'un APK de test échoue sur l'appareil du testeur:
- Vérifiez que les certificats de la nouvelle version correspondent à ceux de la installée sur l'appareil du testeur. Le système Android n'autorise que l'application à mettre à jour si les certificats correspondent. Pour en savoir plus, consultez la section Remarques concernant 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 se peut que vous utilisiez un compte Google Workspace (anciennement G Suite) incluant 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, essayez à nouveau de vous connecter.
Erreur lors de l'installation d'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. installé sur l'appareil. Par exemple, il peut s'agir d'une variante différente du même application avec le même autorisation personnalisée ou 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 d'examiner le rapport pour en savoir plus sur la cause. Le testeur doit supprimer toute application en conflit avant le la nouvelle application peut être installée.
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.
Tester l'application 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 pour au lieu de suivre à nouveau le parcours complet des testeurs, suivez ces étapes:
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 Bouton "Tester" en bas de l'écran pour installer Android App Tester l'application.
Activation des 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 nouvelles fonctionnalités créer des alertes ou envoyer des 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 qu'il accepte commentaires dans l'application et que vos testeurs ne peuvent pas envoyer de commentaires, suivez ces étapes:
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 à ces ressource », si votre testeur n'a pas été invité à utiliser l'application ; ou peut ne pas avoir 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 est listé dans l'onglet Testeurs de la fiche de version et se trouve dans la État accepté.
Si vous ne recevez toujours aucun commentaire, procédez comme suit:
Sur l'appareil de test, connectez-vous à Firebase App Distribution avec l'application ou son application Web de testeur. Veillez à sélectionner le compte Google que vous avez utilisé pour la première fois lorsque vous avez accepté l'invitation pour tester l'application.
Réinstallez l'application à l'aide d'App Tester ou de l'application Web de test pour s'assurer que le testeur a bien accès à la version.
Essayez d'envoyer vos commentaires, en veillant à nouveau à vous connecter avec votre 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 est figure 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 les messages d'erreur dans les journaux de votre application en filtrant par "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 votre les 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 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écuter votre application dans un simulateur et rechercher 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é au nouveau de sortie.
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 dans 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'ils ont accepté l'invitation à tester votre application et configuré leur appareil de test correctement:
Sur l'appareil de test, connectez-vous à Firebase App Distribution via l'application Testeur ou via l'application Web de test. N'oubliez pas de sélectionner compte que vous avez utilisé pour la première fois lorsque vous avez accepté l'invitation l'application.
Vérifiez que la nouvelle version de l'application est disponible dans App Tester ou l'application Web du testeur.
Le testeur est invité à se reconnecter après la fermeture de 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 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 supprimez généralement SharedPreferences lors de la déconnexion, il se peut que vous supprimiez l'état du 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.
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 dépassez la limite de 1 000 versions d'application et la version de l'application est antérieure à les 1 000 dernières versions de l'application.
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 autorisée, téléchargez le APK ou AAB et supprimer la version du tableau de bord App Distribution. Ensuite, réimportez l'APK ou l'AAB 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 le 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 l'application Firebase. Application de test 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 version dans l'application Firebase App Tester.
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.
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 à 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 et son quota les limites et les tarifs sont identiques. Les quotas de test sont mesurés par le 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 nouvelles tentatives pour la fonctionnalité de testeur automatisé ?
Si vous dépassez le quota, vous recevrez des erreurs de dépassement de quota. 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 messages d'erreur liés à l'infrastructure des testeurs automatisés, vos chances de réussite 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 exécuter avec la fonctionnalité de testeur automatisé.
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.