Cette page fournit une aide au dépannage et des réponses aux questions fréquemment posées sur la distribution et le test d'applications avec App Distribution.
Distribution d'applications
Utilisez les conseils suivants pour résoudre les problèmes que vous pourriez rencontrer lors de la distribution d'applications à vos testeurs.
Lors 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 .
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.
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.
Si la taille de l'APK respecte la limite de taille de fichier et est reproductible, contactez l'assistance Firebase .
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)
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 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).
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.
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.
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 .
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 :
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.
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.
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
Demandez au testeur de vérifier son dossier spam et tous les filtres de messagerie qu'il a définis dans son service de messagerie.
Si le testeur s'est désabonné des e-mails, demandez-lui de faire ce qui 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 et cliquez sur Autoriser les e-mails à se réabonner.
solution 2
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.
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.
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.
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 .
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
).
Si l'application App Tester vous empêche de vous connecter et vous redirige vers l'écran de connexion, vous utilisez peut-être un espace de travail Google (anciennement GSuite) qui inclut des paramètres de restriction.
Pour supprimer vos paramètres de restriction :
Dans l' onglet Applications de votre espace de travail Google, assurez-vous que Firebase App Distribution n'est pas défini sur Accès : Bloqué .
Dans l' onglet Services , assurez-vous que Cloud Platform n'est pas restreint.
Une fois les paramètres supprimés, essayez de vous reconnecter.
Cette erreur peut se produire lorsque l'application en cours d'installation entre en conflit avec une application déjà installée sur l'appareil. Par exemple, il peut s'agir d'une variante différente de la même application avec la même autorisation personnalisée ou le même nom ContentProvider .
Vous pouvez demander au testeur de collecter un rapport de bogue immédiatement après avoir rencontré le problème et d'inspecter le rapport pour plus d'informations sur la cause. Le testeur doit supprimer toutes les applications en conflit avant que la nouvelle application puisse être installée.
Lorsque vous rencontrez une erreur 403, cela signifie que le compte que vous utilisez n'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.
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 :
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 } }
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 de Google Analytics .
Exécutez votre application dans un simulateur et recherchez la chaîne "FirebaseAppDistribution".
Si les journaux indiquent qu'aucune version n'a été trouvée ou que le testeur n'y a pas accès, votre testeur n'est peut-être pas encore associé à la nouvelle version.
Dans le tableau de bord App Distribution de la console Firebase, assurez-vous que votre testeur est inclus dans votre distribution de build et qu'il est à l'état Accepté .
Si votre testeur ne reçoit toujours pas d'alertes, demandez-lui de suivre les conseils ci-dessous pour 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 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.
Assurez-vous que la nouvelle version de l'application est disponible dans App Tester ou dans l'application Web du testeur.
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
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 .
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.
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 .
Si vous êtes un testeur, nous vous recommandons de télécharger Firebase App Tester , une application qui vous permet d'accéder à toutes vos versions de test en un seul endroit.
Pour supprimer votre compte testeur App Distribution et ses données associées, suivez ces étapes dans l'ordre :
Visitez https://appdistribution.firebase.google.com et connectez-vous avec votre compte Google.
En haut à droite, cliquez sur
( Gérer le compte )Supprimer le compte .
Facultatif : Dans les autorisations de votre compte Google , révoquez l'accès à Firebase App Distribution. Notez que la révocation de l'accès sans d'abord supprimer votre compte App Distribution ne supprime pas votre compte ou vos données de testeur.
Cette page fournit une aide au dépannage et des réponses aux questions fréquemment posées sur la distribution et le test d'applications avec App Distribution.
Distribution d'applications
Utilisez les conseils suivants pour résoudre les problèmes que vous pourriez rencontrer lors de la distribution d'applications à vos testeurs.
Lors 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 .
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.
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.
Si la taille de l'APK respecte la limite de taille de fichier et est reproductible, contactez l'assistance Firebase .
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)
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 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).
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.
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.
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 .
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 :
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.
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.
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.
The tester was previously invited but did not accept the initial invitation. If the tester is added to subsequent releases, App Distribution won't automatically send release notifications to that tester because the tester didn't accept the initial invitation.
Solution 1
Ask the tester to check their spam folder and any email filters they set in their email service.
If the tester unsubscribed from the emails, ask the tester to do the following:
- Find an email that the tester previously received from the app.
- Click Manage email settings at the bottom and click Allow emails to resubscribe.
Solution 2
Delete the tester from the Testers & Groups tab in the App Distribution page in the Firebase console. This action removes existing invitations.
Re-invite the tester to test your app. The tester should receive an invitation email. Make sure that the tester accepts the invitation with the same email address that the invitation was sent to.
If a tester downloads and installs a release but the app details user interface does not show that the app is installed, this is a known issue. In some cases, the bundle ID in the Firebase app does not match the bundle ID of the APK.
Verify that the bundle ID of the APK matches the bundle ID of the Firebase app you used to upload the distribution.
The Android alert appears if your running app or browser hasn't yet been given permission to install apps outside of Google Play. To grant permission:
Android version 8 or later : In the Settings app, tap Allow from this source .
Android version 7 or earlier : In the Settings app, tap Security and select Unknown sources . When the prompt appears, tap OK > Trust .
If a test APK fails to install on a tester's device:
- Verify that the certificate(s) in the new version match those in the version installed on the tester's device. The Android system only allows the app to update if the certificates match. To learn more, see Signing considerations .
- Ensure that the OS version of the tester device is supported by the app (check the
minSdkVersion
).
If the App Tester app prevents you from signing in and redirects you back to the signin screen, you may be using a Google Workspace (formerly GSuite) that includes restriction settings.
To remove your restriction settings:
In the Apps tab of your Google Workspace, make sure Firebase App Distribution is not set to Access: Blocked .
In the Services tab , make sure Cloud Platform is unrestricted.
Once the settings are removed, try signing in again.
This error can happen when the app being installed conflicts with an app already installed on the device. For example, it could be a different variant of the same app with the same custom permission or ContentProvider name .
You can ask the tester to collect a bug report immediately after experiencing the issue, and inspect the report for more information about the cause. The tester must delete any conflicting apps before the new app can be installed.
When you encounter a 403 error, this means that the account you're using doesn't have permission to install and test apps. Access is determined by the administrator of your account's domain in Google Workspace.
If you believe you should have permission to install and test apps, ask your Google Workspace account admin to change your account settings. Your admin should follow the instructions in Manage access to services that aren't controlled individually .
If you have multiple accounts, try logging in with a different account that is not restricted from installing and testing apps.
Enabling in-app alerts with the App Distribution Android SDK
Use the following tips to troubleshoot issues that involve enabling in-app new build alerts using the App Distribution Android SDK.
If you have already set up the App Distribution Android SDK in your app and your testers aren't receiving in-app alerts, follow these steps:
Check for error messages by attaching an
OnFailureListener
to the Task returned by the Firebase App Distribution API.Java
firebaseAppDistribution.updateIfNewReleaseAvailable().addOnFailureListener ( e -> { if (e instanceof FirebaseAppDistributionException) { // Log exception here }});
Kotlin
firebaseAppDistribution.updateIfNewReleaseAvailable().addOnFailureListener { e -> if (e is FirebaseAppDistributionException) { // Log exception here } }
Check that the tester has access to the new release:
Enable debug mode in your app. To learn how, see the Google Analytics documentation .
Run your app in a simulator and search for the string "FirebaseAppDistribution".
If the logs indicate that no release was found, or that the tester does not have access, your tester may not yet be associated with the new release.
In the App Distribution dashboard of the Firebase console, make sure your tester is included in your build distribution and is in the Accepted state.
If your tester still isn't receiving alerts, have them follow the tips below to make sure they accepted the invitation to test your app and that they set up their testing device properly:
On the test device, sign into Firebase App Distribution via App Tester or via the tester web app. Remember to select the Google account you first used when you accepted the invitation to test the app.
Check to make sure the new app release is available in App Tester or the tester web app.
By default, your testers only need to sign in to their Google account once to enable new build updates and to install new builds. If your testers are being prompted to sign in again after closing and re-opening your app, follow these tips to make sure your App Distribution configuration is set up properly:
Check to make sure you've enabled the Firebase App Testers API. For more information, see Enable the App Distribution Tester API .
Under Key restrictions , make sure that the Firebase App Testers API is included in the list of allowed APIs.
If you typically clear SharedPreferences on logout, you may be clearing your tester's state. App Distribution stores a flag that indicates whether your tester has already signed into the app. For more information, see the GitHub repository .
Frequently asked questions
Firebase App Distribution has the following tester limits:
Add a maximum of 500 testers to a Firebase project
Add a maximum of 200 testers to an App Distribution group
To add more testers, request a no-cost limit increase .
Testers have 30 days to accept an invitation to test the app before it expires. When an invitation is 5 days from expiring, an expiration notice appears in the Firebase console next to the tester on a release. An invitation can be renewed by resending it via the drop-down menu on the tester row.
App releases are removed from App Distribution if one of the following conditions occurs:
- The app release is older than 150 days.
- You exceed the 1,000 app release limit, and the app release is older than the 1,000 most recent app releases.
For more information, see App Distribution supports a maximum of 1,000 releases .
After the app reaches or exceeds the 150-day expiration limit or the 1,000 release limit, the release is removed from the App Distribution dashboard and the Firebase App Tester app. If your tester has installed the release, the local version of the app continues to run.
To keep the app release available longer, use one of the following recommendations:
- Before the app release expires or exceeds the release limit, download the APK or AAB and delete the release from the App Distribution dashboard. Then, re-upload the APK or AAB as a new build to App Distribution.
- Download the release and upload it to Cloud Storage for long-term archiving.
App releases expire after 150 days
When you upload a release of your app to Firebase, the release appears in the App Distribution dashboard for 150 days, starting from the upload date. After you upload the release, you can distribute it to testers, who install the release from the Firebase App Tester app on their testing device.
When the release is 30 days from the expiration date, an app release expiration notification appears on your release in the Firebase App Tester app.
App Distribution supports a maximum of 1,000 releases
App Distribution allows a maximum of 1,000 releases per app. When your app reaches the 1,000 app release limit, App Distribution automatically deletes the oldest releases above the limit.
If you want to manually manage your app releases, use the App Distribution REST API to list and delete app releases in bulk.
If you have questions, contact Firebase Support .
If you're a tester, we recommend downloading Firebase App Tester , an app that lets you access all your test builds in one place.
To delete your App Distribution tester account and its associated data, follow these steps in order:
Visit https://appdistribution.firebase.google.com and sign in with your Google account.
In the top-right, click
( Manage account )Delete account .
Optional: In your Google account permissions , revoke access from Firebase App Distribution. Note that revoking access without first deleting your App Distribution account does not delete your tester account or data.