Démarrer avec appium

Installation ou configuration

Pré-requis

Vérifiez la configuration requise pour chaque type d’appareil que vous souhaitez automatiser et assurez-vous qu’ils sont installés avant d’essayer d’utiliser Appium !

Exigences iOS

  • Mac OS X 10.10 ou supérieur, 10.11.1 recommandé
  • XCode >= 6.0, 7.1.1 recommandé
  • Outils de développement Apple (SDK du simulateur iPhone, outils de ligne de commande)
  • [Assurez-vous de lire la documentation sur la configuration pour les tests iOS !] [1]

Exigences Android

  • [Android SDK][2] API >= 17 (les fonctionnalités supplémentaires nécessitent 18/19)

  • Appium prend en charge Android sur OS X, Linux et Windows. Assurez-vous de suivre les instructions de configuration correcte de votre environnement pour effectuer des tests sur différents systèmes d’exploitation :

  • [linux] [3]

  • [osx][1]

  • [fenêtres][4]

Exigences FirefoxOS

  • [Simulateur de système d’exploitation Firefox] [5]

Installation d’Appium

Installation globale à l’aide de Node.js

$ npm install -g appium
$ appium

Installation locale depuis la branche principale de Github

$ git clone [email protected]:appium/appium.git
$ cd appium
$ npm install
$ node .

Utilisation de l’application pour Mac ou Windows

  • [Télécharger l’application Appium][6]
  • Exécuter!

Rédaction de tests pour Appium

La version formatée de l’Appium [docs] [7] peut être trouvée [ici] [8] avec la possibilité de choisir la langue de l’exemple de code dans le coin supérieur droit.

[1] : https://github.com/appium/appium/blob/master/docs/en/appium-setup/running-on-osx.md [2] : http://developer.android.com/ [3] : https://github.com/appium/appium/blob/master/docs/en/appium-setup/running-on-linux.md [4] : https://github.com/appium/appium/blob/master/docs/en/appium-setup/running-on-windows.md [5] : https://developer.mozilla.org/en/docs/Tools/Firefox_OS_Simulator [6] : https://bitbucket.org/appium/appium.app/downloads/ [7] : https://github.com/appium/appium/tree/master/docs/en [8] : http://appium.io/slate/en/master/?java#about-appium

Lancement d’Appium pour la plate-forme Android et création d’un exemple de test

Configuration de l’environnement : • Téléchargez le SDK Android de niveau API 17 ou plus • Node.js (https://nodejs.org/) • Logiciel Appium (http://appium.io/) • Pots de sélénium (http://www.seleniumhq.org/download/) • Pot d’Appium (https://search.maven.org/#search%7Cga%7C1%7Cg%3Aio.appium%20a%3Ajava-client) • Fichier .apk de l’application à tester

Conditions préalables : • assurez-vous qu’Eclipse est téléchargé depuis www.eclipse.org/downloads/ • java est installé (à la fois jdk et jre) • le SDK Android est installé • Assurez-vous que votre variable d’environnement (Path) pour Java, Android SDK, Platform et platform-tools est définie.

Étapes pour définir le chemin sur le système d’exploitation Windows :  Faites un clic droit sur “Poste de travail”.  “Propriétés”  Sur le panneau de gauche “Paramètres système avancés”  Sélectionnez les variables d’environnement  Variables système-> Type Path-> “Path” double-clic  Entrez le chemin vers JAVA jdk dans votre système suivi de (;) puis le chemin vers votre sdk Android (;) le chemin vers votre plate-forme Android (;) le chemin vers les outils de votre plate-forme Android-> Cliquez sur OK.

• Assurez-vous que le plug-in Eclipse est installé

Étapes pour installer le plug-in Eclipse pour Android :  Démarrez Eclipse, puis sélectionnez Aide > Installer un nouveau logiciel.  Cliquez sur Ajouter, dans le coin supérieur droit.  Dans la boîte de dialogue Ajouter un référentiel qui s’affiche, saisissez “ADT Plugin” pour le nom et l’URL suivante pour l’emplacement : https://dl-ssl.google.com/android/eclipse/  Cliquez sur OK (si vous rencontrez des difficultés pour acquérir le plugin, essayez d’utiliser “http” dans l’URL de localisation, au lieu de “https” (https est préféré pour des raisons de sécurité).

• Assurez-vous que la variable ANDROID_HOME est définie.

Étapes pour définir la variable ANDROID_HOME :  Allez dans Eclipse-> Fenêtre sur le panneau supérieur-> Préférences-> Double-cliquez sur Android dans le panneau de gauche  Dans les préférences Android, copiez l’emplacement du SDK  Faites un clic droit sur “Poste de travail”.  “Propriétés”  Sur le panneau de gauche “Paramètres système avancés”  Sélectionnez les variables d’environnement  En haut Variables utilisateur-> Sélectionnez nouveau-> Nom de la variable, entrez ANDROID_HOME, Chemin de la variable-> Entrez l’emplacement du SDK copié à partir d’Eclipse-> Cliquez sur OK  Puis Variables système-> Sélectionnez nouveau-> Nom de la variable, Entrez ANDROID_HOME, Chemin de la variable-> Entrez l’emplacement du SDK copié à partir d’Eclipse-> Cliquez sur OK  Quitter

• Assurez-vous que Android Virtual Device Manager peut être lancé. Eclipse-> Fenêtre sur le panneau supérieur-> Gestionnaire de périphériques virtuels Android-> Cliquez sur le périphérique virtuel existant s’il existe/Créez-en un nouveau avec des configurations personnalisées.-> Cliquez sur “Démarrer” dans le panneau droit de la fenêtre.-> Lancement

Lancement d’Appium : • Installez node.js (“http://nodejs.org/”). • Lancez Appium à partir de la ligne de commande à partir de l’emplacement ci-dessous : Aller au dossier Appium node_modules appiumbinshift+clic droitouvrir l’invite de commandetype node appiumenter

Les éléments suivants doivent être affichés : info : Bienvenue dans Appium v1.3.4 (REV c8c79a85fbd6870cd6fc3d66d038a115ebe22efe) info : l’écouteur de l’interface Appium REST http a démarré le 0.0.0.0:4723 info : Console LogLevel : débogage info : L’écouteur de l’interface http REST d’Appium a démarré le 0.0.0.0:4723info : Console LogLevel : debug

Écrivez un programme pour lancer Appium dans Eclipse : package appium.com ;

import java.net.MalformedURLException ; importer java.net.URL ;

importer org.openqa.selenium.remote.CapabilityType ; importer org.openqa.selenium.remote.DesiredCapabilities ; importer org.openqa.selenium.remote.RemoteWebDriver ;

classe publique AppiumLaunch { public static void main(String args[]) throws MalformedURLException { RemoteWebDriver driver; DesiredCapabilities capabilities =new DesiredCapabilities();

capabilities.setCapability("platformName", "Android");
capabilities.setCapability("deviceName","");

capabilities.setCapability("version","4.4.2");
capabilities.setCapability("device ID","");
capabilities.setCapability("app-package","");
capabilities.setCapability(CapabilityType.BROWSER_NAME, "");                                                
capabilities.setCapability("app-activity","");
capabilities.setCapability("takesScreenshot",true);

capabilities.setCapability("app","C:/Users/.......apk");

driver=new RemoteWebDriver( new URL("http://127.0.0.1:4723/wd/hub"), capabilities);
System.out.println("app is launched on the device");
 


}

}

• Assurez-vous que le chemin du fichier apk dans le système est correct • Assurez-vous que le chemin d’accès au fichier apk de votre système est correct dans le programme. Utilisez le package et l’activité corrects qui peuvent être trouvés en décompilant le fichier apk. Pour décompiler le fichier apk, rendez-vous sur http://www.decompileandroid.com.

Étapes pour lancer appium pour Android :

  1. Démarrez d’abord le serveur appium à l’invite de commande ou en exécutant le fichier appium.exe.
  2. Vérifiez si l’appareil est connecté et affiché dans adb : appareils adb
  3. Exécutez le programme sur l’Eclipse. Le programme sera exécuté et le fichier .apk installé sur l’appareil lancera l’application.
Client Java →