Appium Tutoriel pour les débutants

Qu'est-ce que le Appium?

Appium est une interface utilisateur d'application mobile open source distribuée gratuitement vers les tests cadre. Appium Permet de tester les applications natives, hybrides et web, et prend en charge l'automatisation sur des appareils physiques ainsi que sur des émulateurs et des simulateurs. Il offre des tests d'applications multiplateformes : une seule API fonctionne pour les deux. Android et les scripts de test iOS.

Appium a aucune dépendance au système d'exploitation de l'appareil mobile. Le framework encapsule et traduit Selenium Commandes WebDriver dans UIAutomation (iOS) ou UIAutomator (Android) les commandes dépendent du type de périphérique, et non de la version du système d'exploitation sous-jacent.

Appium prend en charge toutes les langues qui ont Selenium bibliothèques clientes — Java, Objectif c, Javascénario avec Node.js, PHP, Ruby, Python, C#et plus encore.

Comment La Appium Travail?

• Appium est un serveur HTTP écrit sur le Node.js plateforme qui pilote iOS et Android sessions utilisant le protocole WebDriver JSON. Node.js doit être préinstallé sur le système avant de démarrer la session. Appium serveur.
• Lorsque vous Appium Une fois téléchargé et installé, un serveur est configuré sur la machine locale et expose une API REST.
• Le serveur accepte les demandes de connexion et de commandes du client et exécute les commandes sur un appareil mobile (Android ou iOS).
• Il répond par des réponses HTTP. Pour exécuter des requêtes, Appium font appel à des frameworks d'automatisation mobile natifs pour piloter l'interface utilisateur de l'application :
  • Apple Instruments pour iOS (les instruments sont disponibles uniquement dans Xcode 3.0 ou version ultérieure avec OS X v10.5 et versions ultérieures).
  • Google UIAutomator pour Android Niveau d'API 16 ou supérieur.
  • Selendroid pour Android Niveau d'API 15 ou inférieur.

Prérequis d'utilisation Appium

1. Installer Android SDK (Studio) [Lien].
2. Installer JDK (Java Kit de développement) [Lien].
3. Installer Eclipse [Lien].
4. Installer TestNG pour Eclipse [Lien].
5. Installer Selenium JAR du serveur [Lien].
6. Appium Bibliothèque cliente [Lien].
7. Informations sur l'application APK on Google Jouer [Lien].
8. Node.js (non strictement requis — lorsque Appium Le serveur est installé, Node.exe et NPM sont inclus dans la version actuelle. Appium version).
9. Installer Appium Bureau.

Installer Appium Bureau

Appium Desktop est une application GUI open-source qui installe et exécute le Appium Serveur. Il est fourni avec tous les prérequis nécessaires à son utilisation. Appium Le serveur est livré avec un inspecteur permettant de faire apparaître des informations de base sur vos applications et un enregistreur pour générer du code standard qui automatise les applications mobiles.

Étape 1) Allez dans http://appium.io/ et cliquez sur Télécharger Appium.

Étape 2) Pour WindowsSélectionnez le fichier .exe et téléchargez-le. Le fichier pèse environ 162 Mo et le téléchargement peut prendre du temps selon votre connexion internet.

Étape 3) Cliquez sur le fichier .exe téléchargé.

Étape 4) Sur un Windows machine, il n'y a pas d'assistant d'installation — Appium Le programme s'exécute directement depuis le fichier .exe. Après avoir cliqué sur le fichier .exe, l'écran de démarrage suivant s'affiche pendant quelques minutes.

Pour macOS, vous devez installer le fichier .dmg.

Étape 5) La fenêtre de démarrage du serveur s'ouvre. Elle renseigne l'hôte et le port par défaut (que vous pouvez modifier) ​​et affiche les informations suivantes : Appium version utilisée.

Étape 6) Cliquez à nouveau Démarrer le serveurUn nouveau serveur est lancé sur l'hôte et le port spécifiés, et les journaux du serveur s'affichent dans la console.

Étape 7) Cliquez à nouveau Nouvelle fenêtre de session.

Étape 8) Saisissez les fonctionnalités souhaitées et démarrez une session.

Appium inspecteur

Semblable à la Selenium Outil d'enregistrement et de lecture IDE, Appium a un inspecteur pour l'enregistrement et la lecture de tests. Il enregistre et reproduit le comportement natif de l'application en inspectant le DOM et génère des scripts de test dans n'importe quel langage pris en charge. Notez que Appium Inspector n'est pas pris en charge sur Microsoft Windows: sur Windows il lance le Appium Le serveur échoue à inspecter les éléments. UIAutomator Viewer est la solution de repli recommandée pour inspecter les éléments sur le serveur. Windows.

Étapes pour commencer Appium Inspecteur sur un Mac :

Étape 1) Téléchargez et démarrez votre Appium serveur utilisant l'adresse IP par défaut 0.0.0.0 et le port 4725.

1. Sélectionnez le fichier source ou le fichier .app sur votre disque local pour effectuer les tests.
2. Cochez la case « Chemin de l'application » pour activer le bouton « Choisir ».

Étape 2) Cliquez sur le bouton « Choisir » pour parcourir et sélectionner le fichier de test sur votre disque local.

Étape 3) Démarrez le simulateur iOS sur votre Mac.

Étape 4) Cliquez sur Lancement bouton en haut à droite. Cela active une icône bleue ; cliquez sur cette icône pour ouvrir Appium Inspecteur et simulateur avec l'application présélectionnée.

Étape 5) Une fois lancé, Appium L'inspecteur affiche la hiérarchie des éléments sous forme de colonnes. L'utilisateur peut également effectuer des actions telles que toucher, glisser et autres gestes similaires.

Étape 6) Cliquez à nouveau Arrêter Pour terminer l'enregistrement.

Joindre un Android Émulateur pour Appium

Étape 1) Installer Android SDK sur votre système.

Ouvrez le Panneau de configuration > Système et sécurité > Système. Dans le panneau de gauche, cliquez sur Paramètres système avancésDans la fenêtre contextuelle Propriétés système, cliquez sur Avancé onglet, puis Variables d'environnement.

Étape 2) Dans la fenêtre contextuelle Variables d'environnement, double-cliquez Chemin et définissez le ANDROID_HOME Indiquez la variable pointant vers votre répertoire SDK. Ajoutez le chemin complet du dossier SDK. Par exemple :

C:\User\ABC\Desktop\adt-bundled-windows-x86_64-20140321\sdk

Étape 3) Commencer un Android émulateur, ou connectez un Android Connectez l'appareil à votre système. Assurez-vous que le débogage USB est activé sur le Android appareil : accédez à Paramètres de l’appareil > Options pour les développeurs > activez « Débogage USB ».

Étape 4) Ouvrez l'invite de commandes et accédez à Android SDK \platform-tools\ répertoire (par exemple, D:\adt-bundle-windows-x86_64-20130514\sdk\platform-tools).

Étape 5) Exécutez le adb devices La commande affichera votre périphérique connecté dans la fenêtre d'invite de commandes. La syntaxe complète est : adb -s emulator-5554 install <Location of .apk file>.

Étape 6) Exécutez le adb start-server commande. Le serveur ADB démarre, et Appium l'utilisera pour envoyer des commandes à votre Android appareil.

Étape 7) Accédez à la Appium répertoire sur votre système et démarrer Appium en cliquant sur le Appiumfichier .exe.

Étape 8) Ne modifiez pas l'adresse IP ni le numéro de port par défaut. Cliquez Lancement. Votre Appium La console démarre à l'adresse 127.0.0.1:4723 comme indiqué ci-dessous.

Étape 9) Cliquez à nouveau CommencerL’ Appium Le serveur est maintenant en cours d'exécution sur votre système.

Appium Cas de test pour un natif Android Application (Calculatrice)

Étape 1) Téléchargez l'ADT Eclipse Installez le plugin ou téléchargez le pack ADT séparément depuis ici.

Étape 2) Ouvrez Eclipse et créez un nouveau projet > package > classe.

Étape 3) Importer le Selenium bibliothèque et TestNG dans le nouveau projet.

Étape 4) Créez un petit programme de test pour Application Calculatrice qui additionne deux nombres.

package src_Appium;

import java.net.MalformedURLException;
import java.net.URL;
import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.remote.DesiredCapabilities;
import org.openqa.selenium.remote.RemoteWebDriver;
import org.testng.annotations.*;

public class Calculator {
    WebDriver driver;

    @BeforeClass
    public void setUp() throws MalformedURLException {
        // Set up desired capabilities and pass the Android app activity and package to Appium
        DesiredCapabilities capabilities = new DesiredCapabilities();
        capabilities.setCapability("BROWSER_NAME", "Android");
        capabilities.setCapability("VERSION", "4.4.2");
        capabilities.setCapability("deviceName", "Emulator");
        capabilities.setCapability("platformName", "Android");

        capabilities.setCapability("appPackage", "com.android.calculator2");
        // Package name of the app (get it from an APK info app)
        capabilities.setCapability("appActivity", "com.android.calculator2.Calculator");
        // Launcher activity of the app (get it from an APK info app)

        // Create a RemoteWebDriver instance and connect to the Appium server
        // Launches the Calculator app on the Android device using the capabilities above
        driver = new RemoteWebDriver(new URL("http://127.0.0.1:4723/wd/hub"), capabilities);
    }

    @Test
    public void testCal() throws Exception {
        // Locate the keys on the calculator by name
        WebElement two = driver.findElement(By.name("2"));
        two.click();
        WebElement plus = driver.findElement(By.name("+"));
        plus.click();
        WebElement four = driver.findElement(By.name("4"));
        four.click();
        WebElement equalTo = driver.findElement(By.name("="));
        equalTo.click();
        // Locate the calculator output by tag name
        WebElement results = driver.findElement(By.tagName("EditText"));
        // Check the calculated value on the edit box
        assert results.getText().equals("6") :
            "Actual value is : " + results.getText() + " did not match with expected value: 6";
    }

    @AfterClass
    public void teardown() {
        // Close the app
        driver.quit();
    }
}

Commencer le Appium Serveur et le Android Sélectionnez l'émulateur dans le Gestionnaire AVD, puis cliquez sur Exécuter > TestNGLe programme exécute l'application Calculatrice sur l'émulateur sélectionné et le résultat s'affiche dans l'interface. Eclipse console utilisant la TestNG cadre.

Limitations de Appium

1. Appium ne prend pas en charge les tests sur Android versions inférieures à 4.2.
2. Prise en charge limitée des tests d'applications hybrides — par exemple, il n'est pas possible de tester le basculement entre une vue Web et une vue native dans les deux sens.
3. Aucune prise en charge de la course Appium Inspecteur sur Microsoft Windows.

Erreurs courantes et étapes de dépannage Appium

FAQ