Distribuer des applications Android aux testeurs à l'aide de Fastlane


Ce guide explique comment distribuer des versions AAB aux testeurs à l'aide de fastlane, une plate-forme Open Source qui automatise la compilation et la publication d'applications iOS et Android. Il suit des instructions simples définies dans un Fastfile. Une fois que vous avez configuré fastlane et votre Fastfile, vous pouvez intégrer App Distribution à votre configuration fastlane.

App Distribution s'intègre au service de partage interne d'applications de Google Play pour traiter les AAB que vous importez et distribuer des APK optimisés selon la configuration des appareils de vos testeurs. La distribution d'AAB vous permet d'effectuer les opérations suivantes :

  • Exécutez des APK optimisés (fournis par Google Play) pour les appareils de vos testeurs.

  • Découvrez et déboguez les problèmes spécifiques aux appareils.

  • Testez des fonctionnalités pour app bundles comme Play Feature Delivery et Play Asset Delivery.

  • Réduisez la taille des téléchargements pour vos testeurs.

Autorisations requises

Pour importer des AAB dans App Distribution, vous devez associer votre application Firebase à une application dans Google Play. Vous devez disposer du niveau d'accès requis pour effectuer ces actions.

Si vous ne disposez pas de l'accès Firebase nécessaire, vous pouvez demander à un propriétaire de projet Firebase de vous attribuer le rôle applicable via les paramètres IAM de la console Firebase. Si vous avez des questions sur l'accès à votre projet Firebase, y compris sur la façon de trouver ou d'attribuer un propriétaire, consultez les questions fréquentes sur les autorisations et l'accès aux projets Firebase.

Le tableau suivant s'applique à l'association d'une application Firebase à une application dans Google Play, ainsi qu'à l'importation d'AAB.

Action dans la console Firebase Autorisation IAM requise Rôle(s) IAM incluant les autorisations requises par défaut Rôle(s) requis supplémentaires
Associer une application Firebase à une application dans Google Play firebase.playLinks.update L'un des rôles suivants : Accès à un compte de développeur Google Play en tant qu'administrateur
Importer des fichiers AAB dans App Distribution firebaseappdistro.releases.update L'un des rôles suivants : ––

Avant de commencer

  1. Si ce n'est pas déjà fait, ajoutez Firebase à votre projet Android. À la fin de ce workflow, vous disposerez d'une application Android Firebase dans votre projet Firebase.

    Si vous n'utilisez aucun autre produit Firebase, il vous suffit de créer un projet et d'enregistrer votre application. Si vous décidez d'utiliser d'autres produits, veillez à suivre toutes les étapes de Ajouter Firebase à votre projet Android.

  2. Pour associer Firebase à Google Play et importer des AAB, assurez-vous que votre application répond aux exigences suivantes :

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

  3. Associez votre application Android pour Firebase à votre compte de développeur Google Play :

    1. Dans la console Firebase, accédez à Paramètres du projet, puis sélectionnez l'onglet Intégrations.

    2. Sur la fiche Google Play, cliquez sur Associer.
      Si vous avez déjà effectué l'association, cliquez sur Gérer à la place.

    3. Suivez les instructions à l'écran pour activer l'intégration App Distribution et sélectionner les applications Android Firebase à associer à Google Play.

    En savoir plus sur l'association à Google Play

Étape 1 : Configurer fastlane

  1. Installez et configurez fastlane.

  2. Pour ajouter App Distribution à votre configuration fastlane, exécutez la commande suivante à partir de la racine de votre projet Android :

    fastlane add_plugin firebase_app_distribution

    Si la commande vous invite à choisir une option, sélectionnez Option 3: RubyGems.org.

Étape 2 : S'authentifier avec Firebase

Avant de pouvoir utiliser le plug-in fastlane, vous devez d'abord vous authentifier auprès de votre projet Firebase de l'une des manières suivantes. Par défaut, le plug-in fastlane recherche les identifiants de la CLI Firebase si aucune autre méthode d'authentification n'est utilisée.

Étape 3 : Configurer votre Fastfile et distribuer votre application

  1. Dans une voie ./fastlane/Fastfile, ajoutez un bloc firebase_app_distribution. Utilisez les paramètres suivants pour configurer la distribution :
    Paramètres firebase_app_distribution
    app

    Obligatoire : ID d'application Firebase de votre application. Vous trouverez l'ID de l'application dans la console Firebase, sur la page Paramètres généraux.

    app: "1:1234567890:android:0a1b2c3d4e5f67890"
    firebase_cli_token

    Jeton d'actualisation imprimé lorsque vous authentifiez votre environnement d'intégration continue avec la CLI Firebase (pour en savoir plus, consultez Utiliser la CLI avec les systèmes d'intégration continue).

    service_credentials_file

    Chemin d'accès au fichier JSON de votre compte de service Google. Consultez ci-dessus pour savoir comment s'authentifier à l'aide des identifiants d'un compte de service.

    android_artifact_type

    Spécifie le type de fichier Android (APK ou AAB).

    android_artifact_path

    Remplace apk_path (obsolète). Chemin absolu vers le fichier APK ou AAB que vous souhaitez importer. Si elle n'est pas spécifiée, fastlane détermine l'emplacement du fichier à partir de la voie dans laquelle il a été généré.

    release_notes
    release_notes_file

    Notes de version pour ce build.

    Vous pouvez spécifier directement les notes de version :

    release_notes: "Text of release notes"

    Vous pouvez également spécifier le chemin d'accès à un fichier en texte brut :

    release_notes_file: "/path/to/release-notes.txt"
    testers
    testers_file

    Adresses e-mail des testeurs que vous souhaitez inviter.

    Vous pouvez spécifier les testeurs sous forme de liste d'adresses e-mail séparées par une virgule :

    testers: "ali@example.com, bri@example.com, cal@example.com"

    Vous pouvez également spécifier le chemin d'accès à un fichier texte brut contenant une liste d'adresses e-mail séparées par une virgule :

    testers_file: "/path/to/testers.txt"
    groups
    groups_file

    Les groupes de testeurs que vous souhaitez inviter (consultez Gérer les testeurs). Les groupes sont spécifiés à l'aide d'alias de groupe, que vous pouvez rechercher dans la console Firebase.

    Vous pouvez spécifier les groupes sous forme de liste séparée par une virgule :

    groups: "qa-team, trusted-testers"

    Vous pouvez également spécifier le chemin d'accès à un fichier texte brut contenant une liste de noms de groupes séparés par une virgule :

    groups_file: "/path/to/groups.txt"
    test_devices
    test_devices_file

    Les types de distribution suivants font partie de la fonctionnalité bêta du testeur automatique.

    Les appareils de test sur lesquels vous souhaitez distribuer les builds (consultez Tests automatisés).

    Vous pouvez spécifier les appareils de test sous forme de liste d'appareils de test séparés par un point-virgule :

    test_devices: "model=shiba,version=34,locale=en,orientation=portrait;model=b0q,version=33,locale=en,orientation=portrait"

    Vous pouvez également spécifier le chemin d'accès à un fichier texte brut contenant une liste de dispositifs de test séparés par des points-virgules :

    test_devices_file: "/path/to/test-devices.txt"
    test_username

    Nom d'utilisateur pour la connexion automatique à utiliser lors des tests automatisés.

    test_password
    test_password_file

    Mot de passe pour la connexion automatique à utiliser lors des tests automatisés.

    Vous pouvez également spécifier le chemin d'accès à un fichier en texte brut contenant un mot de passe :

    test_password_file: "/path/to/test-password.txt"
    test_username_resource

    Nom de ressource du champ de nom d'utilisateur pour la connexion automatique à utiliser lors des tests automatisés.

    test_password_resource

    Nom de ressource du champ de mot de passe pour la connexion automatique à utiliser lors des tests automatisés.

    test_non_blocking

    Exécutez des tests automatisés de manière asynchrone. Consultez la console Firebase pour obtenir les résultats des tests automatiques.

    debug

    Option booléenne. Vous pouvez définir cette valeur sur true pour imprimer des résultats de débogage détaillés.

platform :android do
    desc "My awesome app"
    lane :distribute do
        build_android_app(task: "bundle", ...)
        # build_android_app is a built-in fastlane action.
        release = firebase_app_distribution(
            app: "1:123456789:android:abcd1234",
            testers: "tester1@company.com, tester2@company.com",
            release_notes: "Lots of amazing new features to test out!",
            android_artifact_type: "AAB"
        )
    end
end

Pour rendre le build disponible pour les testeurs, exécutez votre lane :

fastlane <lane>

La valeur renvoyée de l'action est un hachage représentant la version importée. Ce hachage est également disponible à l'aide de lane_context[SharedValues::FIREBASE_APP_DISTRO_RELEASE]. Pour en savoir plus sur les champs disponibles dans ce hachage, consultez la documentation de l'API REST.

Le plug-in fastlane génère les liens suivants après l'importation de la version. Ces liens vous aident à gérer les binaires et à vous assurer que les testeurs et les autres développeurs disposent de la version appropriée :

  • Lien vers la console Firebase affichant une seule version. Vous pouvez partager ce lien avec d'autres développeurs de votre organisation.
  • Lien vers la version dans l'expérience de testeur (application Android native) qui permet aux testeurs de consulter les notes de version et d'installer l'application sur leur appareil. Le testeur doit avoir accès à la version pour pouvoir utiliser le lien.
  • Lien signé qui télécharge et installe directement le fichier binaire de l'application (fichier APK ou AAB). Le lien expire au bout d'une heure.

Une fois votre build distribué, il est disponible dans le tableau de bord App Distribution de la console Firebase pendant 150 jours. Lorsque la compilation arrive à 30 jours de son expiration, un avis d'expiration s'affiche dans la console et dans la liste des compilations du testeur sur son appareil de test.

Les testeurs qui n'ont pas été invités précédemment à tester l'application reçoivent des invitations par e-mail pour commencer. Les testeurs existants reçoivent des notifications par e-mail les informant qu'une nouvelle version est prête à être testée. Pour savoir comment installer l'application de test, consultez le guide de configuration pour les testeurs. Vous pouvez surveiller l'état de chaque testeur pour déterminer s'il a accepté l'invitation et s'il a téléchargé l'application dans la console Firebase.

(Facultatif) Pour incrémenter automatiquement votre numéro de version chaque fois que vous créez une version dans App Distribution, vous pouvez utiliser l'action firebase_app_distribution_get_latest_release et, par exemple, le plug-in fastlane increment_version_code. Le code suivant montre comment incrémenter automatiquement votre numéro de version :

lane :increment_version do
  latest_release = firebase_app_distribution_get_latest_release(
    app: "<your Firebase app ID>"
  )
  increment_version_code({ version_code: latest_release[:buildVersion].to_i + 1 })
end

Pour en savoir plus sur l'action firebase_app_distribution_get_latest_release, consultez Obtenir des informations sur la dernière version de votre application.

Étape 4 (facultatif) : Gérer les testeurs pour la distribution

Vous pouvez ajouter et supprimer des testeurs de votre projet ou groupe à l'aide de votre fichier Fastfile ou en exécutant directement des actions fastlane. L'exécution d'actions directement remplace les valeurs définies dans votre Fastfile.

Une fois qu'un testeur a été ajouté à votre projet Firebase, vous pouvez l'ajouter à des versions individuelles. Les testeurs supprimés de votre projet Firebase n'ont plus accès aux versions de votre projet, mais ils peuvent conserver l'accès à vos versions pendant un certain temps.

Si vous avez un grand nombre de testeurs, envisagez d'utiliser des groupes.

Utiliser "Fastfile"

# Use lanes to add or remove testers from a project.
lane(:add_testers) do
  firebase_app_distribution_add_testers(
    emails: "foo@google.com,bar@google.com"
    # or file: "/path/to/testers.txt"
    group_alias: "qa-team" # (Optional) add testers to this group
  )
end

lane(:remove_testers) do
  firebase_app_distribution_remove_testers(
    emails: "foo@google.com,bar@google.com"
    # or file: "/path/to/testers.txt"
    group_alias: "qa-team" # (Optional) remove testers from this group only
  )
end
# Add or remove testers with the terminal
$ fastlane add_testers
$ fastlane remove_testers

Exécuter des actions fastlane

fastlane run firebase_app_distribution_create_group display_name:"QA Team" alias:"qa-team"
fastlane run firebase_app_distribution_add_testers group_alias:"qa-team" emails:"foo@google.com,bar@google.com"
fastlane run firebase_app_distribution_remove_testers group_alias:"qa-team" emails:"foo@google.com,bar@google.com"
fastlane run firebase_app_distribution_delete_group alias:"qa-team"

Vous pouvez également spécifier des testeurs à l'aide de --file="/path/to/testers.txt au lieu de --emails.

Les tâches firebase_app_distribution_add_testers et firebase_app_distribution_remove_testers acceptent également les arguments suivants :

  • project_name : numéro de votre projet Firebase.
  • group_alias (facultatif) : si cette option est spécifiée, les testeurs sont ajoutés au groupe spécifié (ou en sont supprimés).
  • service_credentials_file : chemin d'accès au fichier d'identifiants de votre service Google.
  • firebase_cli_token : jeton d'authentification pour la CLI Firebase.

service_credentials_file et firebase_cli_token sont les mêmes arguments que ceux utilisés par l'action d'importation.

Étape 5 (facultatif) : Obtenir des informations sur la dernière version de votre application

Vous pouvez utiliser l'action firebase_app_distribution_get_latest_release pour récupérer des informations sur la dernière version de votre application dans App Distribution, y compris des informations sur la version de l'application, les notes de version et l'heure de création. Les cas d'utilisation incluent l'augmentation automatique de la version et le transfert des notes de version de la version précédente.

La valeur renvoyée de l'action est un hachage représentant la dernière version. Ce hachage est également disponible à l'aide de lane_context[SharedValues::FIREBASE_APP_DISTRO_LATEST_RELEASE]. Pour en savoir plus sur les champs disponibles dans ce hachage, consultez la documentation de l'API REST.

Paramètres

Paramètres firebase_app_distribution_get_latest_release
app

Obligatoire : ID d'application Firebase de votre application. Vous trouverez l'ID de l'application dans la console Firebase, sur la page Paramètres généraux.

app: "1:1234567890:android:0a1b2c3d4e5f67890"
firebase_cli_token

Jeton d'actualisation imprimé lorsque vous authentifiez votre environnement d'intégration continue avec la CLI Firebase (pour en savoir plus, consultez Utiliser la CLI avec les systèmes d'intégration continue).

service_credentials_file

Chemin d'accès au fichier JSON de votre compte de service Google. Consultez ci-dessus pour savoir comment s'authentifier à l'aide des identifiants d'un compte de service.

debug

Option booléenne. Vous pouvez définir cette valeur sur true pour imprimer des résultats de débogage détaillés.

Étapes suivantes