Script AddAndroidApp.jar

Utilisez AddAndroidApp.jar à partir de la ligne de commande pour instrumenter l'application à tester et l'ajouter dans le Test Workbench.

Si AddAndroidApp.jar est correctement exécuté, il renvoie le code de sortie 0. Dans le cas contraire, il renvoie le code de sortie 1.

Entrez la commande ci-dessous pour en savoir plus sur les paramètres obligatoires et facultatifs de l'outil de ligne de commande AddAndroidApp.jar.

java -jar AddAndroidApp.jar options
Tableau 1. Options de ligne de commande
Arguments et option de ligne de commande Description
-w URL Workbench, qui comprend l'adresse IP et le port, par exemple http://127.0.0.1:7878
Application Android(.apk) Nom de l'application Android, par exemple Calculator.apk. Vous pouvez inclure plusieurs fichiers .apk sur la ligne de commande.
-c

Ferme le Test Workbench une fois que toutes les applications ont été ajoutées au plan de travail, par exemple eclipse -launcher.appendVmargs -vmargs -Dcom.ibm.rational.test.lt.services.server.moeb.CLI=true. Cette option nécessite le lancement du plan de travail à l'aide de la propriété système com.ibm.rational.test.lt.services.server.moeb.CLI paramétrée sur true.

Pour fermer automatiquement le plan de travail, utilisez la préférence Eclipse Général > Démarrage et arrêt, puis cochez la case Confirmer la sortie lors de la fermeture de la dernière fenêtre.

-d Description. Texte de la description de cette application. Le texte s'affiche dans l'éditeur Applications d'interface web et mobile du plan de travail.
-f Permet de forcer la régénération. Si la même version exacte de l'application Android a déjà été ajoutée au plan de travail, la régénération de l'application est forcée la prochaine fois.
-m Fichier .ma. Dossier d'espace de travail dans lequel la ressource .ma de cette application est créée. Cette option est ignorée si le dossier d'espace de travail est introuvable.
-o Dossier de sortie. Dossier local dans lequel les applications instrumentées sont téléchargées.
-v Version. Affiche la version de l'outil AddAndroidApp.jar.
-alias Alias du fichier de clés à utiliser pour signer toutes les applications générées.
-keepdata Permet de conserver les données d'application pendant l'installation sur l'appareil. Utilisez cette option avec des options de signature car elle nécessite la même signature que l'application d'origine.
-keystore fichier_de_clés Chemin local du fichier de clés contenant la clé privée à utiliser pour signer toutes les applications générées.
-aliaspassword motdepasse_alias Mot de passe de l'alias.
-keystorepassword motdepasse_fichier_de_clés Mot de passe du fichier de clés.

Exemples

Exécutez la commande suivante pour instrumenter une application à tester, par exemple Calculator.apk puis l'ajouter au plan de travail :

java -jar AddAndroidApp.jar -w http://192.0.2.24:7878 Calculator.apk

Exécutez la commande ci-dessous pour instrumenter plusieurs applications et les ajouter au plan de travail. Il suffit d'inclure les noms des fichiers .apk sur la ligne de commande, en procédant comme suit :

java -jar AddAndroidApp.jar -w http://192.0.2.24:7878 Calculator.apk MySimpleApp.apk MySecondApp.apk

Exécutez les commandes suivantes pour démarrer le plan de travail, instrumenter l'application à tester et ferme le plan de travail :

eclipse -launcher.appendVmargs -vmargs -Dcom.ibm.rational.test.lt.services.server.moeb.CLI=true
java -jar AddAndroidApp.jar -w http://192.0.2.24:7878 -c Calculator.apk
Remarque : Vous devez fermer le plan de travail après l'exécution de tests à partir de la ligne de commande car le même espace de travail ne peut pas être utilisé par deux instances du plan de travail. Pour plus de détails sur les autres options d'exécution Eclipse, voir http://help.eclipse.org/juno/index.jsp?topic=%2Forg.eclipse.platform.doc.isv%2Freference%2Fmisc%2Fruntime-options.html. Pour empêcher que la fermeture du plan de travail vous invite à confirmer la sortie, utilisez la préférence Eclipse Général > Démarrage et arrêt, puis cochez la case Confirmer la sortie lors de la fermeture de la dernière fenêtre.

Exécutez la commande suivante pour instrumenter l'application à tester et pour télécharger l'application générée vers un dossier local :

java -jar AddAndroidApp.jar -w http://192.0.2.24:7878 -o localdir Calculator.apk

Retour d'informations