Vous pouvez automatiser le processus de test des applications Android en utilisant l'interface de ligne de commande avec l'utilitaire Android Debug Bridge
(adb) et un outil de ligne de commande tel que curl.
Vous pouvez ensuite combiner les instructions de ligne de commande dans des scripts et des fichiers de commandes.
Avant de commencer
- Installez IBM®
Rational Test Workbench Mobile Test Edition et vérifiez que l'extension pour mobile (Extension for Mobile) est sélectionnée. Pour plus de détails, voir Installation du produit.
- Téléchargez et installez le logiciel SDK Android sur l'ordinateur hébergeant le Test Workbench.
Au minimum, veillez à installer Android SDK Tools, Android SDK Platform-tools,
Android SDK Build-tools et l'utilitaire Android Debug Bridge (adb), s'ils ne sont pas déjà installés. La page de téléchargement en cours du logiciel SDK Android SDK se trouve à l'adresse Get the Android SDK mais le site peut changer dans l'avenir.
- Si vous travaillez sur un ordinateur Windows,
téléchargez curl depuis http://curl.haxx.se/. curl est un outil de ligne
de commande permettant de transférer des données avec une syntaxe URL et est nécessaire pour automatiser le processus d'instrumentation. curl est inclus par défaut dans la plupart des distributions Linux.
- Pour tester des émulateurs Android, définissez une ou plusieurs configurations AVD (Android Virtual Device). Pour plus de détails,
voir Using the Emulator. Cet article décrit également des
méthodes permettant d'améliorer les performances des émulateurs par le biais d'une accélération du matériel.
- Pour effectuer le test sur des périphériques Android, accédez à Paramètres et activez le débogage USB.
Connectez ensuite le périphérique Android à l'aide d'un câble USB à l'ordinateur exécutant Test Workbench.
Comme certains périphériques mobiles ont besoin d'un pilote USB spécifique, il peut être nécessaire d'accéder au site Web du fournisseur de périphérique pour
télécharger et installer le pilote USB correspondant au périphérique. Pour plus de détails, voir Installation du client de test mobile pour Android avec adb.
- Enregistrez les scripts de test pour l'application à tester (AUT).
Le processus d'enregistrement de test ne peut pas être automatisé. Pour plus d'informations, voir Enregistrement de tests à partir du client de test mobile Android.
Pourquoi et quand exécuter cette tâche
Le processus d'automatisation inclut les étapes suivantes :
- Instrumentation de l'édition la plus récente sur une application
- Installation de l'édition la plus récente de l'application sur le périphérique ou l'émulateur Android.
- Installation du client de test mobile et démarrage de celui-ci en mode passif.
- Exécution du test à partir de la ligne de commande
Procédure
- Instrumentez l'édition la plus récente de l'application à tester.
Vous pouvez instrumenter manuellement des applications Android en les téléchargeant à partir d'un périphérique mobile ou d'un émulateur vers
Test Workbench, ou en cliquant sur le bouton Ajouter une application dans la liste depuis
Test Workbench. Pour automatiser le processus, utilisez un outil tel que curl.
- Démarrez Rational
Test Workbench Eclipse Client.
- Dans le Test Workbench, cliquez sur l'icône Afficher l'URL du plan de travail
et notez l'adresse URL du plan de travail. Vous aurez besoin de l'adresse IP et du port de l'URL de plan de travail (Workbench) dans l'étape suivante.
- Exécutez la commande suivante pour instrumenter l'application à tester :
curl -F "appfile=@MonApp.apk"
-F "appdescription=Description de MonApp"
http://Workbench-URL:port/moeb/service/com.ibm.rational.test.lt.core.moeb.services.buildchain.IBuildChainService/?action=upload
Par exemple :
curl -F "appfile=@MesFrais.apk"
-F "appdescription=Appli note de frais"
http://192.0.2.24:7878/moeb/service/com.ibm.rational.test.lt.core.moeb.services.buildchain.IBuildChainService/?action=upload
Cette étape génère trois nouveaux fichiers .apk :
- R-nom apk d'origine.apk - Application prête à la lecture
- T-nom apk d'origine.apk - Moteur de test pour l'application
- I-nom apk d'origine.apk - Application prête à l'enregistrement
Pour plus de détails sur les fichiers .apk, l'instrumentation, et le processus de génération Android, voir
Présentation des tests Android.
- Utilisez adb pour installer l'édition la plus récente de l'application à tester sur le périphérique ou l'émulateur Android. Le fichier .apk prêt à la lecture et le fichier de moteur de test .apk doivent être tous les deux installés. L'utilitaire adb est généralement installé dans emplacement_installation_SDK_Android\sdk\platform-tools.
- Recherchez le fichier .apk prêt à la lecture et le fichier de moteur de test .apk à l'emplacement suivant dans votre
espace de travail Eclipse :
votre_espace_de_travail/.metadata/.plugins/com.ibm.rational.test.lt.models.behavior.moeb/builds/uid_AUT/R-nom_apk-origine.apk
où uid_AUT est le nom de dossier du dernier sous-dossier modifié du dossier builds.
En règle générale, uid_AUT est un nombre hexadécimal long.
Exemple :
C:\workspaces\rtw86\.metadata\.plugins\com.ibm.rational.test.lt.models.behavior.moeb\builds\b01714617a0a34788898e05c9696e0bf\R-frais.apk
Vous pouvez trouver l'application de moteur de test dans le même emplacement. Il suffit de remplacer le préfixe R par T.
- Exécutez les commandes suivantes depuis la ligne de commande :
adb install -r espace de travail/.metadata/.plugins/com.ibm.rational.test.lt.models.behavior.moeb/builds//uid_AUT/R-nom_AUT.apk
adb install -r espace de travail/.metadata/.plugins/com.ibm.rational.test.lt.models.behavior.moeb/builds//uid_AUT/T-nom_AUT.apk
Pour installer l'application à tester sur plusieurs périphériques ou émulateurs, utilisez l'option -s (numéro de série), par exemple :
adb install -s emulator-5556 -r
C:\workspaces\rtw86\.metadata\.plugins\com.ibm.rational.test.lt.models.behavior.moeb\builds\b01714617a0a34788898e05c9696e0bf\R-frais.apk
adb install -s emulator-5558 -r
C:\workspaces\rtw86\.metadata\.plugins\com.ibm.rational.test.lt.models.behavior.moeb\builds\b01714617a0a34788898e05c9696e0bf\T-frais.apk
Pour plus de détails, voir Directing commands to a specific emulator or device.
- Installez le client de test mobile et démarrez-le en mode passif. Le mode passif permet d'utiliser un script ou un fichier de commandes pour contrôler l'exécution du test
dans Test Workbench.
Exécutez les commandes adb suivantes pour désinstaller une version existante du client de test mobile,
réinstaller une nouvelle version du client et définir le mode passif pour le client.
adb uninstall com.ibm.rational.test.mobile.android.client.ui
adb install "chemin_client_Eclipse/com.ibm.rational.test.mobile.android.client.ui-release.apk"
adb shell am start
-n com.ibm.rational.test.mobile.android.client.ui/.MainActivity -e workbench_url "URL_Workbench" --ez passive_mode “true”
Par exemple :
adb uninstall com.ibm.rational.test.mobile.android.client.ui
adb install "C:\Program Files\IBM\IBMIMShared\com.ibm.rational.test.mobile.android.client.ui-release.apk"
adb shell am start
-n com.ibm.rational.test.mobile.android.client.ui/.MainActivity -e workbench_url "9.44.55.666:7878" --ez passive_mode “true”
- Exécutez un test en mode de ligne de commande.
Vous pouvez maintenant exécuter un test. Pour plus de détails sur l'exécution d'un test ou d'un planning en mode de ligne de commande, voir
Exécution d'un test ou d'une planification à partir de la ligne de commande.
Remarque : Vous ne pouvez pas
exécuter un test depuis la ligne de commande sur Mac OS X.
Par défaut, Test Workbench sélectionne le premier périphérique connecté qui répond le mieux aux exigences de
l'exécution du test (système d'exploitation Android ou API Android). Pour exécuter le test sur un ou plusieurs périphériques spécifiques, utilisez l'option
adb -s ID périphérique.
Pour trouver l'ID d'un périphérique, ouvrez l'éditeur de périphériques mobiles dans Test Workbench, sélectionnez un
périphérique et recherchez son ID dans Propriétés détaillées.
Vous pouvez également utiliser une variable pur sélectionner un périphérique spécifique. Pour plus de détails, voir Définition d'une variable pour l'exécution d'un test à l'aide d'un périphérique mobile sélectionné.
Tous les scripts de test sont liés à une version spécifique de l'application à tester. Si vous téléchargez une nouvelle version de l'application à tester, vous devez toujours exécuter le test sur la version la plus récente. Pour plus de détails, voir Définition d'une variable dans un test pour l'exécution de la dernière version d'une application.