Distribuer les versions de l'app bundle aux testeurs - Codelab

image10.png

Dans cet atelier de programmation, vous apprendrez à distribuer les versions Android App Bundle aux testeurs à l'aide de Firebase App Distribution et de son plug-in Gradle. App Distribution fournit un hub central pour vous permettre de gérer les versions préliminaires de votre application et les testeurs que vous invitez à chaque version.

Ce que vous apprendrez

  • Comment lier votre application Firebase à Google Play
  • Comment empaqueter et créer votre application en tant que bundle d'applications
  • Comment créer une version et la partager avec des testeurs en direct
  • Comment télécharger et tester les nouvelles versions en tant que testeur

Ce dont vous aurez besoin

  • Android Studio v4.0+
  • Un fichier d'ensemble signé que vous avez généré à partir d'Android Studio
  • Un compte de développeur Google Play dont vous êtes le propriétaire ou l'administrateur
  • Votre application dans Google Play est configuré sur l'application Google Play tableau de bord , et il a le suivant statut :
    • L'application est dans un état publié, ce qui signifie que ce n'est pas dans le projet et son examen est terminé (la colonne d'état de mise à jour dans la console Google Play est vide).
    • L'application est distribuée sur l'une des pistes Google Play suivantes : test interne, test fermé, test ouvert ou production.
  • Une adresse e-mail que vous pouvez utiliser en tant que testeur pour recevoir de nouvelles invitations de build de Firebase
  1. Se connecter à Firebase .
  2. Dans la console Firebase, cliquez sur Ajouter un projet, puis nommez votre projet « AppBundlesCodelab. » N'oubliez pas l'ID de projet de votre projet Firebase. Si vous ne modifiez pas l'ID du projet, Firebase attribue automatiquement un ID unique à votre projet.

    image8.png
  3. (Facultatif) Lorsque vous êtes invité, activez Google Analytics.
  4. Effectuez les étapes restantes, puis cliquez sur Créer un projet.

Ajouter votre app bundle au projet

  1. Dans la console Firebase, cliquez sur Ajouter application.

    image5.png
  2. Lors de l' enregistrement de votre application, assurez - vous d'utiliser le même nom de package que l'application qui est téléchargé sur votre compte Google Play développeur. Enfin, cliquez sur l' application de vous inscrire.
  3. Effectuez les étapes restantes pour ajouter le fichier de configuration Firebase de votre application ( google-services.json ) à votre application. Notez que pour Android, App Distribution n'a pas de SDK Firebase à ajouter à votre application.
  4. Cliquez sur Continuer pour consoler.
  1. Dans la console Firebase, allez à vos paramètres du projet.

    image2.png
  2. Dans l'onglet Intégrations, cliquez sur Lien sur la carte Google Play.
  3. Suivez les instructions à l'écran pour activer l'intégration de la distribution d'applications, puis sélectionnez votre application Firebase nouvellement créée pour la lier à Google Play.

Maintenant que vous avez terminé ces étapes, votre application Firebase sera liée à votre application dans votre compte développeur Google Play tant que les noms de package des applications correspondent.

Ajouter le plug-in App Distribution Gradle

Maintenant, vous allez utiliser Android Studio pour ajouter App Distribution et son plugin Gradle en tant que dépendances de buildscript à votre application.

  1. Dans votre fichier Gradle niveau du projet ( android/build.gradle ), ajoutez la distribution App plug - in Gradle et le dépôt Maven de Google.
    buildscript {
        repositories {
            // Check that you have Google's Maven repository (if not, add it).
            google()
            jcenter()
        }
        dependencies {
            // Add the App Distribution Gradle plugin
            classpath `com.google.firebase:firebase-appdistribution-gradle:2.1.2`
        }
    }
    
  2. Dans votre fichier Gradle app-niveau ( android/app/build.gradle ), ajoutez le plug - in de distribution App:
    apply plugin: `com.android.application`
    
    // ...
    
    // Apply the App Distribution Gradle plugin
    apply plugin: `com.google.firebase.appdistribution`
    
    // ...
    
  3. Si vous êtes derrière un proxy d' entreprise ou de pare - feu, ajoutez la propriété système Java suivant qui permet la distribution App pour télécharger vos distributions à Firebase:
    -Djavax.net.ssl.trustStore=/path/to/truststore -Djavax.net.ssl.trustStorePassword=password
    

Authentifier votre projet Firebase

Avant de pouvoir utiliser le plug-in Gradle, vous devez authentifier votre projet Firebase. Pour cet atelier de programmation, vous vous connecterez à votre compte Google à l'aide de l'action de connexion du plug-in.

  1. Exécutez la commande suivante à la racine de votre projet Android:
    ~/your-android-project$ ./gradlew appDistributionLogin
    
  2. Lorsque la commande imprime un lien d'authentification, ouvrez-le dans un navigateur. Lorsque vous y êtes invité, connectez-vous à votre compte Google et autorisez l'accès à votre projet Firebase. La commande Gradle imprime un jeton d'actualisation, que le plug-in App Distribution utilise pour s'authentifier auprès de Firebase.
  3. Définissez la variable d'environnement FIREBASE_TOKEN au jeton de l'étape précédente:
    ~/your-android-project$ export FIREBASE_TOKEN=your_firebase_token
    

Dans cette étape, vous vous ajouterez en tant que testeur pour la version que vous distribuerez plus tard. Une fois que vous avez distribué la version, les testeurs reçoivent des notifications par e-mail de Firebase les invitant à tester la nouvelle version.

Dans votre app/build.gradle , ajoutez une firebaseAppDistribution section et inclure les paramètres suivants:

  • appID : Votre application de Firebase ID App. Vous pouvez le trouver dans l' onglet Général de paramètres du projet.
  • artifactType : type de fichier de votre application ( AAB ).
  • testers : les adresses e - mail de vos testeurs. Pour cet atelier de programmation, ajoutez votre propre e-mail afin de pouvoir tester votre build une fois qu'il est distribué.

Par exemple:

android {

   // ...

   buildTypes {
       release {
           firebaseAppDistribution {
               appId="yourAppId"
               artifactType="AAB"
               testers="your@exampleemail.com, cerseimartell.772371@email.com"
           }
       }
   }

// ...
}

En option, vous pouvez également remplacer les valeurs définies dans votre build.gradle en fournissant des arguments de ligne de commande sous forme de -PappDistribution- property-name = property-value la -PappDistribution- property-name = property-value .

  1. Exécutez le bundle Variant tâche Gradle pour construire votre Appstore fichier:
    $ ./gradlew :base:bundleRelease
    
  2. Localiser le paquet dans le répertoire de construction de votre application (l'emplacement par défaut est app/build/outputs/bundle/release ).
  3. Pour distribuer la libération, construire les cibles bundleRelease et appDistributionUploadRelease avec enveloppe Gradle de votre projet. Incluez le jeton Firebase (celui que vous avez reçu à l'étape 3 : Ajoutez la distribution d'applications à votre application).
    export FIREBASE_TOKEN=your_firebase_token
    
    ./gradlew --stop // Only needed for environment variable changes
    
    ./gradlew bundleRelease appDistributionUploadRelease
    

Les testeurs recevront désormais des invitations par e-mail pour télécharger et tester la version. En tant que développeur, vous pouvez maintenant surveiller l'accumulation dans l'onglet versions du tableau de bord de distribution App.

Dans cette section, vous serez configuré en tant que testeur afin de télécharger la version que vous avez distribuée. En tant que testeur, vous devrez authentifier votre appareil de test et activer le partage d'application interne dans l'application Google Play Store.

  1. Sur votre appareil de test, connectez-vous à votre compte de messagerie de testeur et ouvrez l'invitation depuis Firebase.

    image6.png
  2. Connectez-vous avec votre compte Google et acceptez l'invitation pour tester la version distribuée. En option, vous pouvez également télécharger Firebase App Tester, ce qui évite les rejets téléchargés d'être ajouté à votre appareil Downloads dossier. Il affiche également des informations supplémentaires sur les versions, telles que la progression du téléchargement et la version de la version.

    image9.png
  3. Appuyez sur Télécharger sur la version pour l' installer à partir du Play Store.
  4. Lorsque vous y êtes invité, effectuez les étapes restantes pour activer le partage d'application interne (les instructions sont affichées sur votre appareil de test et ne doivent être effectuées qu'une seule fois).

Une fois le téléchargement terminé, votre version apparaîtra automatiquement sous forme de raccourci sur l'écran d'accueil de votre appareil.

Vous venez d'utiliser Firebase App Distribution pour télécharger un app bundle et distribuer une version aux testeurs.

Prochaines étapes