Dépannage et FAQ sur la distribution d'applications

iOS Androïd

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.

Impossible de distribuer une application en raison d'un e-mail de contact manquant

Lors de l'importation 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 configurer une."

Définissez une adresse e-mail de contact dans la console Firebase, si disponible. Si le problème persiste, contactez l' assistance Firebase .

Une erreur s'est produite lors du provisionnement de votre application (erreurs 400, 409 ou 500 )

Si vous rencontrez à plusieurs reprises les erreurs 400, 409 ou 500 lors du provisionnement, contactez l'assistance Firebase . Fournissez à l'assistance votre numéro de projet Firebase et l'identifiant de l'application.

Impossible de télécharger le fichier APK

1. Vérifiez la taille de l'APK. La limite de taille de fichier maximale pour tous les binaires est de 2048 Mio, soit un peu plus de 2 Go.

2. Si la taille de l'APK respecte 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 des éléments suivants :

apksigner verify --verbose ~/app-distro/app-distro-apps/[path_name]/app/ build/outputs/apk/debug/app-debug.apk

Distribution d'ensembles d'applications Android (AAB)

Réception d'erreurs avec des fournisseurs d'API de connexion sociale/tiers

Lorsque vous chargez un AAB sur App Distribution, Google Play signe automatiquement à nouveau 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 dans Google Play ?

Les versions 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'application interne).

Que se passe-t-il si je dissocie Firebase de Google Play ?

Si une application Android Firebase est dissociée de Google Play, voici ce qui se passe :

• Vous ne pourrez pas télécharger de nouveaux ensembles d'applications vers 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.

Puis-je réessayer d'associer une application à Google Play ?

Pour distribuer un Android App Bundle (AAB) via App Distribution et lier automatiquement les AAB téléchargés à la fois à votre projet Firebase et à votre compte de développeur Google Play, assurez-vous de remplir les conditions suivantes :

• Votre compte de développeur Google Play possède l'un des niveaux d'accès suivants : propriétaire ou administrateur.

• Pour votre projet Firebase, vous avez l'un des rôles suivants : Owner ou Firebase Admin .

• 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 dans Google Play et l'application Firebase Android sont toutes deux enregistrées avec 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 à l'une des pistes de Google Play (test interne, test fermé, test ouvert ou production).

• L'examen de l'application dans 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 importé une application qui ne répondait pas aux critères d'association indiqués ci-dessus, mais que c'est le cas maintenant, vous pouvez réessayer d' associer votre application Firebase Android à 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.

Le testeur n'a pas de compte Google

Lorsqu'un utilisateur crée un compte Google, il reçoit automatiquement une adresse Gmail.

Si un testeur n'a pas d'adresse Google Workspace ou Gmail, ou s'il préfère utiliser une autre adresse e-mail pour se connecter, demandez-lui d'associer une adresse e-mail autre que Gmail au compte et d'utiliser cette adresse e-mail pour se connecter.

Lors du choix d'une autre adresse e-mail, le testeur doit suivre ces directives :

• N'utilisez pas d'adresse Gmail.
• N'utilisez pas une adresse e-mail déjà associée à un autre compte Google.
• N'oubliez pas d'utiliser le mot de passe de votre compte Google lorsque vous vous connectez avec cette adresse e-mail.

Pour plus d'informations, consultez Se connecter à votre compte Google avec une autre adresse e -mail .

Le testeur ne parvient pas à voir les bonnes applications ou builds

Si le testeur a accepté l'invitation par e-mail avec une adresse e-mail différente de celle à laquelle l'invitation a été envoyée, il se peut qu'il ne puisse pas voir les bonnes applications ou builds.

L'e-mail auquel le développeur envoie des invitations et qu'il ajoute aux nouvelles versions (E-mail A) peut être différent de l'e-mail que le testeur utilise pour accepter l'invitation (E-mail B). Cela crée un lien dans les coulisses. Chaque fois que l'e-mail A est ajouté à de nouvelles versions, c'est en fait l'e-mail B qui y a accès.

Si le testeur a accepté l'invitation par e-mail avec une adresse e-mail différente, procédez comme suit pour résoudre le problème :

1. Supprimez le testeur de l'onglet Testeurs et groupes de la page Distribution d'applications de la console Firebase. Les invitations existantes sont supprimées.

2. Réinvitez le testeur à tester votre application. Le testeur devrait recevoir un e-mail d'invitation.

3. 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 événements suivants se produit :

• Les notifications par e-mail sont envoyées aux dossiers de spam.

• Les filtres de messagerie sont définis.

• L'invitation a été envoyée à un compte de messagerie, mais le testeur a accepté avec un autre compte de messagerie. Le testeur reçoit les e-mails de nouvelle version pour le compte de messagerie auquel l'invitation a été initialement envoyée.

• Le testeur a déjà été invité mais n'a pas accepté l'invitation initiale. Si le testeur est ajouté aux versions suivantes, App Distribution n'enverra pas automatiquement de notifications de version à ce testeur car celui-ci n'a pas accepté l'invitation initiale.

solution 1

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.

2. Si le testeur s'est désabonné des e-mails, demandez-lui de faire ce qui suit :

   1. Recherchez un e-mail que le testeur a précédemment reçu de l'application.
   2. Cliquez sur Gérer les paramètres de messagerie en bas et cliquez sur Autoriser les e-mails à se réabonner.

solution 2

1. Supprimez le testeur de l'onglet Testeurs et groupes de la page Distribution d'applications de la console Firebase. Cette action supprime les invitations existantes.

2. Réinvitez le testeur à tester votre application. Le testeur devrait recevoir un e-mail d'invitation. Assurez-vous que le testeur accepte l'invitation avec la même adresse e-mail à laquelle l'invitation a été envoyée.

L'application n'indique pas que l'application 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 groupe dans l'application Firebase ne correspond pas à l'ID de groupe de l'APK.

Vérifiez que l'ID de groupe de l'APK correspond à l'ID de groupe de l'application Firebase que vous avez utilisée pour télécharger la distribution.

Alerte Android indiquant que mon appareil ne peut pas installer d'applications inconnues

L'alerte Android apparaît si votre application en cours d'exécution ou votre navigateur 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 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 du système d'exploitation de l'appareil de test est prise en charge par l'application (vérifiez 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, 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 :

1. 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é .

2. Dans l' onglet Services , assurez-vous que Cloud Platform n'est pas restreint.

3. Une fois les paramètres supprimés, essayez de vous reconnecter.

Erreur lors de l'installation d'AAB : "Impossible d'installer l'application"

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 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.

Erreur 403 : "Contactez votre administrateur pour l'accès"

Lorsque vous rencontrez une erreur 403, cela signifie que le compte que vous utilisez n'a pas l'autorisation d'installer et de tester des applications. L'accès est déterminé par l'administrateur du domaine de votre compte dans Google Workspace.

Si vous pensez que vous devriez avoir l'autorisation d'installer et de tester des applications, demandez à l'administrateur de votre compte Google Workspace de modifier les paramètres de votre compte. Votre administrateur doit suivre les instructions de Gérer l'accès aux services qui ne sont pas contrôlés individuellement .

Si vous avez plusieurs comptes, essayez de vous connecter avec un compte différent qui n'est pas limité à l'installation et au test des applications.

Activation des alertes dans l'application avec le SDK Android App Distribution

Utilisez les conseils suivants pour résoudre les problèmes impliquant l'activation des alertes de nouvelle version dans l'application à l'aide du SDK Android App Distribution.

Le testeur ne reçoit pas d'alertes dans l'application

Si vous avez déjà configuré le SDK App Distribution Android dans votre application et que vos testeurs ne reçoivent pas d'alertes dans l'application, procédez comme suit :

1. Recherchez les messages d'erreur en associant un OnFailureListener à la tâche renvoyée par l'API de distribution d'applications 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
                     }
     }
   

2. Vérifiez que le testeur a accès à la nouvelle version :

   1. Activez le mode débogage dans votre application. Pour savoir comment procéder, consultez la documentation de Google Analytics .

   2. 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.

   3. 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 s'assurer qu'il a accepté l'invitation à tester votre application et qu'il a correctement configuré son appareil de test :

      1. 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é en premier lorsque vous avez accepté l'invitation à tester l'application.

      2. Assurez-vous que la nouvelle version de l'application est disponible dans App Tester ou dans l'application Web du testeur.

Le testeur est invité à se reconnecter après avoir fermé l'application

Par défaut, vos testeurs n'ont besoin de se connecter qu'une seule fois à leur compte Google pour activer les mises à jour des nouvelles versions et installer de nouvelles versions. Si vos testeurs sont invités à se reconnecter après avoir fermé et rouvert votre application, suivez ces conseils pour vous assurer que votre configuration de distribution d'applications est correctement configurée :

• Vérifiez que vous avez activé l'API Firebase App Testers. Pour plus d'informations, consultez Activer l'API App Distribution Tester .

• Sous Restrictions de clé , assurez-vous que l'API Firebase App Testers est incluse dans la liste des API autorisées.

• Si vous effacez généralement SharedPreferences 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

Y a-t-il des limites pour ajouter des testeurs à mon application ?

Firebase App Distribution a les limites de testeur suivantes :

• Ajouter un maximum de 500 testeurs à un projet Firebase

• Ajouter un maximum de 200 testeurs à un groupe de distribution d'applications

Pour ajouter plus de testeurs, demandez une augmentation de limite sans frais .

Mes invitations de testeur expirent-elles ?

Les testeurs ont 30 jours pour accepter une invitation à tester l'application avant son expiration. Lorsqu'une invitation est à 5 jours de l'expiration, un avis d'expiration apparaît dans la console Firebase à côté du testeur sur une release. Une invitation peut être renouvelée en la renvoyant via le menu déroulant sur la ligne du testeur.

Combien de temps les versions d'application sont-elles disponibles ?

Les versions d'application sont supprimées de la distribution d'applications si l'une des conditions suivantes se produit :

• La version de l'application date de plus de 150 jours.
• Vous dépassez la limite de 1 000 versions d'application et la version de l'application est antérieure aux 1 000 versions d'application les plus récentes.

Pour plus d'informations, consultez App Distribution prend en charge un maximum de 1 000 versions .

Une fois que l'application atteint ou dépasse la limite d'expiration de 150 jours ou la limite de 1 000 versions, 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, utilisez l'une des recommandations suivantes :

• Avant que la version de l'application n'expire ou ne dépasse la limite de version, téléchargez l'APK ou l'AAB et supprimez la version du tableau de bord de distribution d'applications. Ensuite, téléchargez à nouveau l'APK ou l'AAB en tant que nouvelle version sur App Distribution.
• Téléchargez la version et importez-la sur Cloud Storage pour un archivage à long terme.

Les versions d'application expirent après 150 jours

Lorsque vous téléchargez une version de votre application sur Firebase, la version apparaît dans le tableau de bord de distribution d'applications pendant 150 jours, à compter de la date de téléchargement. Après avoir téléchargé la version, vous pouvez la distribuer aux testeurs, qui installent la version à partir de l'application Firebase App Tester sur leur appareil de test.

Lorsque la version est de 30 jours à compter de la date d'expiration, une notification d'expiration de la version de l'application apparaît sur votre version dans l'application Firebase App Tester.

App Distribution prend en charge un maximum de 1 000 versions

La distribution d'applications autorise un maximum de 1 000 versions par application. Lorsque votre application atteint la limite de 1 000 versions d'applications, App Distribution supprime automatiquement les versions les plus anciennes au-dessus de la limite.

Si vous souhaitez gérer manuellement les versions de votre application, utilisez l'API REST App Distribution pour répertorier et supprimer les versions d'application en masse.

Si vous avez des questions, contactez l'assistance Firebase .

Comment puis-je 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 en un seul endroit.

Comment supprimer mon compte testeur ?

Pour supprimer votre compte testeur App Distribution et ses données associées, suivez ces étapes dans l'ordre :

1. Visitez https://appdistribution.firebase.google.com et connectez-vous avec votre compte Google.

2. En haut à droite, cliquez sur ( Gérer le compte )

   Supprimer le compte .

3. Facultatif : Dans les autorisations de votre compte Google , révoquez l'accès à Firebase App Distribution. Notez que la révocation de l'accès sans d'abord supprimer votre compte App Distribution ne supprime pas votre compte ou vos données de testeur.