Catch up on everthing we announced at this year's Firebase Summit. Learn more

Commencez à tester avec les systèmes CI

Vous pouvez utiliser Firebase Test Lab lors du développement de votre application à l'aide de n'importe quel système d'intégration continue (CI). Les systèmes d'intégration continue vous permettent de créer et de tester automatiquement votre application chaque fois que vous enregistrez des mises à jour du code source de votre application.

Utiliser Firebase Test Lab avec Jenkins CI

Cette section décrit comment utiliser Test Lab avec Jenkins CI .

Conditions

Avant de pouvoir utiliser Firebase Test Lab avec Jenkins, vous devez effectuer les étapes suivantes :

  1. Configurez gcloud. Suivez les instructions de l' aide Firebase Test Lab de la gcloud ligne de commande pour créer un projet Firebase et configurer votre environnement Google SDK nuage local.

  2. Créez et autorisez un compte de service. Les comptes de service ne sont pas soumis à des contrôles de spam ou à des invites captcha, qui pourraient sinon bloquer vos builds CI. Créer un compte de service avec un rôle éditeur dans la console Google Cloud puis l' activer (voir la documentation Activate service compte gcloud auth pour savoir comment).

  3. Activez les API requises. Une fois connecté en utilisant le compte de service: Dans la Page API Google Developers Console Library , activez l'API Google Cloud Test et Cloud Tool Résultats API. Pour activer ces API, saisissez ces noms d'API dans la zone de recherche en haut de la console, puis cliquez sur Activer l' API sur la page d' aperçu de cette API.

Installer et configurer Jenkins

Vous pouvez installer et configurer Jenkins CI sur Linux ou Windows. Certains détails de ce guide sont spécifiques à installer et exécuter Jenkins CI sur Linux, y compris l'utilisation de barres obliques ( / ) dans les chemins de fichiers.

Pour télécharger et installer Jenkins sur un ordinateur exécutant Linux ou Windows, suivez les instructions sur l' installation Jenkins . Après avoir installé Jenkins, suivez les instructions de départ et Jenkins Accès à la configuration complète et accéder au tableau de bord Jenkins.

Configurer les paramètres de sécurité globale

Jenkins n'a pas configuré l'authentification des utilisateurs et le contrôle d'accès lors de sa première installation. Avant d'utiliser Jenkins avec Firebase Test Lab, configurez les paramètres de sécurité globaux pour appliquer le contrôle d'accès et authentifier les utilisateurs.

Pour configurer les paramètres de sécurité globaux

  1. Accédez au tableau de bord Jenkins sur votre serveur. Pour ce faire, accédez à http: // <servername>: 8080,<servername> est le nom de l'ordinateur sur lequel vous avez installé Jenkins.
  2. Sur le tableau de bord Jenkins, cliquez sur Gérer Jenkins, puis cliquez sur Configurer la sécurité mondiale.
  3. Sur la page Configuration de la sécurité globale, cliquez sur Activer la sécurité, puis cliquez sur Enregistrer.

Pour plus d' informations sur la configuration des paramètres de sécurité pour Jenkins, voir Sécurité rapide et simple , le programme d' installation de sécurité standard , et Securing Jenkins .

Créer un projet Jenkins

Ensuite, créez un projet pour exécuter des tests d'intégration continue de votre application avec Firebase Test Lab.

Pour créer un projet Jenkins

  1. Accédez au tableau de bord Jenkins sur votre serveur. Pour ce faire, accédez à http: // <servername>: 8080,<servername> est le nom de l'ordinateur sur lequel vous avez installé Jenkins.
  2. Sur le tableau de bord Jenkins, cliquez sur Nouvel élément.
  3. Tapez un nom pour votre projet dans le champ Nom d'objet:
    • Choisissez projet Freestyle pour créer un projet qui utilise une configuration unique de construction.
    • Choisissez la construction projet multi-configuration pour créer un projet qui fonctionne sur plusieurs configurations de construction différentes. Si vous envisagez de créer votre application avec une variété de configurations de construction (plusieurs paramètres régionaux, plusieurs niveaux d'API Android, etc.), alors un projet multi-configuration est le meilleur choix.
  4. Cliquez sur Enregistrer.

Une fois votre projet créé, votre navigateur Web affiche la page principale de votre projet.

Ajouter un contrôle de révision et des étapes de construction de Gradle

Cette section décrit comment intégrer Jenkins avec des systèmes de contrôle de révision tels que GitHub et comment ajouter des étapes de génération Gradle pour créer des packages APK à partir du code source.

Intégration avec GitHub et d'autres systèmes de contrôle de révision

Si vous utilisez GitHub ou un autre système de contrôle de révision pour gérer le code source de votre application, vous pouvez configurer Jenkins pour exécuter des builds automatisés et exécuter des tests chaque fois que des mises à jour de votre application sont archivées. Vous pouvez également configurer Jenkins pour exécuter des builds périodiquement.

Pour en savoir plus sur la configuration construit dans Jenkins, voir Configuration automatique construit .

Ajout d'étapes de build Gradle pour reconstruire les packages APK

Si vous utilisez un système de contrôle de révision pour gérer le code source de votre application, vous devez inclure une étape de génération Gradle pour créer de nouveaux binaires APK chaque fois que Jenkins télécharge le code source à partir de votre système de contrôle de révision.

  1. Ajouter une étape de génération pour exécuter les commandes suivantes dans le répertoire principal de votre application:

    ./gradlew :app:assembleDebug
    ./gradlew :app:assembleDebugAndroidTest
    

  2. Ajoutez une étape de build pour utiliser le ou les packages APK créés par Gradle lors des tests avec Test Lab. Vous pouvez utiliser ce chemin comme <local_server_path> dans l'exemple de script shell fourni ci - dessous, où <AppFolder> est le dossier du projet Android studio pour votre application:

    <AppFolder>/app/build/outputs/apk
    

Ajouter les étapes de construction du laboratoire de test à Jenkins

Vous êtes maintenant prêt à ajouter une étape de compilation à Jenkins pour exécuter Test Lab à l'aide de la ligne de commande gcloud.

Pour ajouter une étape de compilation gcloud

  1. A partir de la page principale de votre projet, cliquez sur Configurer.
  2. Sur la page de configuration du projet, faites défiler jusqu'à la section Générer, puis sélectionnez Exécuter shell dans le menu étape de génération Ajouter.

  3. Dans la Jenkins Exécuter fenêtre de commande shell, entrez les informations suivantes, en remplaçant <local_server_path> pour le chemin d' accès à l'exemple d' application sur le serveur, <app_apk> pour votre de l' application APK et <app_test_apk> pour le test de votre application APK:

    gcloud firebase test android run --app <local_server_path>/<app_apk>.apk
    --test <local_server_path>/<app_test_apk>.apk
    

Analyser les résultats des tests

Après le test de laboratoire complète le test de votre application, vous pouvez consulter les résultats des tests dans la console Firebase ou dans un Google Cloud Storage seau dans votre projet. Vous pouvez également ajouter une gsutil commande à la commande shell indiquée ci - dessus pour copier les résultats de test des données sur votre ordinateur local. Pour en savoir plus, voir Analyse des résultats de laboratoire de test Firebase .

Intégration continue avec d'autres systèmes CI

Pour apprendre à utiliser Firebase Test Lab avec d'autres systèmes CI, consultez leur documentation :