Vous pouvez utiliser Firebase Test Lab lorsque vous développez 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 compiler et de tester automatiquement votre application chaque fois que vous vérifiez les mises à jour de votre code source.
Utiliser Firebase Test Lab avec l'intégration continue Jenkins
Cette section explique comment utiliser Test Lab avec Jenkins CI.
Conditions requises
Avant de pouvoir utiliser Firebase Test Lab avec Jenkins, vous devez suivre les étapes ci-dessous:
Configurez gcloud. Suivez les instructions de la section Utiliser Firebase Test Lab à partir de la ligne de commande gcloud pour créer un projet Firebase et configurer votre environnement de SDK Google Cloud local.
Créez et autorisez un compte de service. Les comptes de service ne sont pas soumis à des vérifications antispam ni à des requêtes de captcha, ce qui pourrait bloquer vos builds de CI. Créez un compte de service avec le rôle Éditeur dans la console Google Cloud, puis activez-le (consultez la documentation gcloud auth activate-service-account pour savoir comment procéder).
Activez les API requises. Après vous être connecté avec le compte de service, sur la page de la bibliothèque d'API de la console pour les développeurs Google, activez l'API Google Cloud Testing et l'API Cloud Tool Results. Pour activer ces API, saisissez leur nom dans le champ de recherche en haut de la console, puis cliquez sur Enable API (Activer l'API) sur la page d'informations de l'API.
Installer et configurer Jenkins
Vous pouvez installer et configurer la CI Jenkins sur Linux ou Windows. Certains détails de ce guide sont spécifiques à l'installation et à l'exécution de la CI Jenkins sur Linux, y compris l'utilisation de barres obliques (/) dans les chemins d'accès aux fichiers.
Pour télécharger et installer Jenkins sur un ordinateur exécutant Linux ou Windows, suivez les instructions de la section Installer Jenkins. Après avoir installé Jenkins, suivez les instructions de la section Démarrer et accéder à Jenkins pour terminer la configuration et accéder au tableau de bord Jenkins.
Configurer les paramètres de sécurité globaux
L'authentification utilisateur et le contrôle des accès ne sont pas configurés lorsque Jenkins est installé pour la première fois. Avant d'utiliser Jenkins avec Firebase Test Lab, configurez les paramètres de sécurité globaux pour appliquer le contrôle des accès et authentifier les utilisateurs.
Pour configurer les paramètres de sécurité globaux :
- Accédez au tableau de bord Jenkins sur votre serveur. Pour ce faire, accédez à http://<nomduserveur>:8080, où <nomduserveur> est le nom de l'ordinateur sur lequel vous avez installé Jenkins.
- Dans le tableau de bord Jenkins, cliquez sur Manage Jenkins (Gérer Jenkins), puis sur Configure Global Security (Configurer la sécurité globale).
- Sur la page Configure Global Security (Configurer la sécurité globale), cliquez sur Enable security (Activer la sécurité), puis sur Save (Enregistrer).
Pour en savoir plus sur la configuration des paramètres de sécurité pour Jenkins, consultez les articles Sécurité rapide et simple, Configuration de sécurité standard et Sécuriser 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
- Accédez au tableau de bord Jenkins sur votre serveur. Pour ce faire, accédez à http://<nomduserveur>:8080, où <nomduserveur> est le nom de l'ordinateur sur lequel vous avez installé Jenkins.
- Dans le tableau de bord Jenkins, cliquez sur New Item (Nouvel élément).
- Saisissez un nom pour votre projet dans le champ Item name (Nom de l'élément) :
- Choisissez Freestyle project (Projet libre) pour créer un projet qui utilise une seule configuration de compilation.
- Choisissez Créer un projet multiconfiguration pour créer un projet qui s'exécute sur plusieurs configurations de compilation différentes. Si vous prévoyez de compiler votre application avec différentes configurations de compilation (plusieurs paramètres régionaux, plusieurs niveaux d'API Android, etc.), un projet multiconfiguration est le meilleur choix.
- Cliquez sur Enregistrer.
Une fois le projet créé, votre navigateur Web affiche la page principale de votre projet.
Ajouter un contrôle des révisions et des étapes de compilation Gradle
Cette section explique comment intégrer Jenkins à des systèmes de contrôle des versions tels que GitHub, et comment ajouter des étapes de compilation Gradle pour créer des packages APK à partir du code source.
Intégrer l'outil à GitHub et à d'autres systèmes de contrôle des révisions
Si vous utilisez GitHub ou un autre système de contrôle des versions pour gérer le code source de votre application, vous pouvez configurer Jenkins pour qu'il exécute des compilations et des tests automatiques chaque fois que des mises à jour de votre application sont enregistrées. Vous pouvez également configurer Jenkins pour exécuter des compilations régulièrement.
Pour en savoir plus sur la configuration des compilations dans Jenkins, consultez la section Configurer les compilations automatiques.
Ajouter des étapes de compilation Gradle pour recompiler des packages APK
Si vous utilisez un système de contrôle des versions pour gérer le code source de votre application, vous devez inclure une étape de compilation 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 des versions.
Ajoutez une étape de compilation pour exécuter les commandes suivantes dans le répertoire principal de votre application:
./gradlew :app:assembleDebug ./gradlew :app:assembleDebugAndroidTest
Ajoutez une étape de compilation pour utiliser le ou les packages APK créés par Gradle lors des tests avec Test Lab. Vous pouvez utiliser ce chemin en tant que <local_server_path> dans l'exemple de script shell fourni ci-dessous, où <AppFolder> est le dossier de projet Android Studio de votre application:
<AppFolder>/app/build/outputs/apk
Ajouter des étapes de compilation Test Lab à 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
- Sur la page principale de votre projet, cliquez sur Configurer.
Sur la page Configuration du projet, faites défiler la page jusqu'à la section Compilation, puis sélectionnez Exécuter le shell dans le menu Ajouter une étape de compilation.
Dans la fenêtre Jenkins Execute shell command (Exécuter la commande shell Jenkins), saisissez la commande suivante, en remplaçant <local_server_path> par le chemin d'accès à l'application exemple sur le serveur, <app_apk> par l'APK de votre application et <app_test_apk> par l'APK de test de votre application:
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
Une fois que Test Lab a terminé de tester votre application, vous pouvez consulter les résultats des tests dans la console Firebase ou dans un bucket Google Cloud Storage de votre projet. Vous pouvez également ajouter une commande gsutil à la commande shell indiquée ci-dessus pour copier les données des résultats des tests sur votre ordinateur local.
Pour en savoir plus, consultez la section Analyser les résultats Firebase Test Lab.
Intégration continue avec d'autres systèmes CI
Pour savoir comment utiliser Firebase Test Lab avec d'autres systèmes d'intégration continue, consultez la documentation: