Check out what’s new from Firebase@ Google I/O 2021, and join our alpha program for early access to the new Remote Config personalization feature. Learn more

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

Ce guide explique comment distribuer des builds APK aux testeurs à l'aide de fastlane , une plate-forme open source qui automatise la création et la publication d'applications iOS et Android. Il suit des instructions simples définies dans un Fastfile . Après avoir configuré fastlane et votre Fastfile , vous pouvez intégrer App Distribution à votre configuration fastlane.

Avant que tu commences

Si vous ne l'avez pas déjà fait, ajoutez Firebase à votre projet Android .

Si vous n'utilisez aucun autre produit Firebase, il vous suffit de créer un projet et d'enregistrer votre application. Cependant, si vous décidez d'utiliser des produits supplémentaires à l'avenir, assurez-vous de suivre toutes les étapes de la page liée ci-dessus.

Étape 1 . Configurer la voie rapide

  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 propose une option, sélectionnez Option 3: RubyGems.org .

Étape 2 . S'authentifier avec Firebase

Avant de pouvoir utiliser le plugin Fastlane, vous devez d'abord vous authentifier auprès de votre projet Firebase. Il y a trois façons d'y parvenir :

Étape 3 . Configurez votre Fastfile et distribuez 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 : l'ID d'application Firebase de votre application. Vous pouvez trouver 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

    Un jeton d'actualisation qui est imprimé lorsque vous exécutez l'action de connexion du plugin (voir Authentifier à l'aide d'un compte Google ci-dessus) ou lorsque vous authentifiez votre environnement CI avec la CLI Firebase (lisez Utiliser la CLI avec les systèmes CI pour plus d'informations).

    service_credentials_file

    Le chemin d'accès au fichier json de votre compte de service Google. Voir ci-dessus pour savoir comment s'authentifier à l'aide des informations d'identification du 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 télécharger. S'il n'est pas spécifié, fastlane détermine l'emplacement du fichier à partir de la voie dans laquelle le fichier a été généré.

    release_notes
    release_notes_file

    Notes de version pour cette version.

    Vous pouvez soit spécifier les notes de version directement :

    release_notes: "Text of release notes"

    Ou, spécifiez le chemin d'accès à un fichier texte brut :

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

    Les adresses e-mail des testeurs que vous souhaitez inviter.

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

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

    Ou, vous pouvez spécifier le chemin d'accès à un fichier texte contenant une liste d'adresses e-mail séparées par des virgules :

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

    Les groupes de testeurs que vous souhaitez inviter (voir Gérer les testeurs ). Les groupes sont spécifiés à l'aide de 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 des virgules :

    groups: "qa-team, trusted-testers"

    Ou, vous pouvez spécifier le chemin d'accès à un fichier texte contenant une liste de noms de groupes séparés par des virgules :

    groups_file: "/path/to/groups.txt"
    debug

    Un drapeau booléen. Vous pouvez définir ceci sur true pour imprimer une sortie de débogage détaillée.

    Par example:

    platform :android do
        desc "My awesome app"
        lane :distribute do
            build_android_app(...)
            # build_android_app is a built-in fastlane action.
    
            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!"
            )
    
        end
    end
    
  2. Enfin, pour rendre la version disponible aux testeurs, exécutez votre voie :

    fastlane <lane>

Une fois que vous distribuez votre build, il devient disponible dans le tableau de bord App Distribution de la console Firebase pendant 150 jours (cinq mois). Lorsque la version expire dans 30 jours, un avis d'expiration apparaît à la fois dans la console et dans la liste des versions de votre testeur sur son appareil de test.

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