View a markdown version of this page

Exécutez automatiquement des tests Appium dans Device Farm - AWS Device Farm
Sélection d'une version d'AppiumSélection d'une WebDriverAgent version pour les tests iOS

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Exécutez automatiquement des tests Appium dans Device Farm

Note

Cette page couvre l'exécution de tests Appium dans l'environnement d'exécution géré côté serveur de Device Farm. Pour exécuter des tests Appium depuis votre environnement client local lors d'une session d'accès à distance, consultez la section Tests Appium côté client.

Cette section décrit comment configurer, empaqueter et télécharger vos tests Appium pour les exécuter dans l'environnement géré côté serveur de Device Farm. Appium est un outil open source permettant d'automatiser les applications Web natives et mobiles. Pour plus d'informations, consultez la page de présentation d'Appium sur le site web Appium.

Pour un exemple d'application et des liens vers des tests fonctionnels, consultez Device Farm Sample App pour Android et Device Farm Sample App pour iOS sur GitHub.

Pour plus d'informations sur les tests dans Device Farm et sur le fonctionnement côté serveur, consultez. Frameworks de test et tests intégrés dans AWS Device Farm

Sélection d'une version d'Appium

Note

La prise en charge de versions spécifiques d'Appium, de pilotes Appium ou de kits de développement SDK de programmation dépend du périphérique et de l'hôte de test sélectionnés pour le test.

Les hôtes de test Device Farm sont préinstallés avec Appium afin de permettre une configuration plus rapide des tests pour des cas d'utilisation plus simples. Cependant, l'utilisation du fichier de spécifications de test vous permet d'installer différentes versions d'Appium si nécessaire.

Device Farm est préconfiguré avec différentes versions de serveur Appium en fonction de l'hôte de test. L'hôte est livré avec des outils qui activent la version préconfigurée avec le pilote par défaut de la plate-forme de l'appareil (UiAutomator2 pour Android et XCUItest pour iOS). Par exemple, sur l'hôte de macos_tahoe test, Appium 3 est la version par défaut et est préinstallé avec un pilote XCUItest compatible pour iOS. 

phases:
  install:
    commands:
      - export APPIUM_VERSION=3
      - devicefarm-cli use appium $APPIUM_VERSION

Pour consulter la liste des logiciels pris en charge, consultez la rubrique surLogiciels pris en charge dans des environnements de test personnalisés.

Pour sélectionner une version personnalisée d'Appium, utilisez la npm commande pour l'installer. L'exemple suivant montre comment installer la dernière version d'Appium 2. 

phases:
  install:
    commands:
      - export APPIUM_VERSION=2
      - npm install -g appium@$APPIUM_VERSION

Sur leHôte de test iOS Legacy, vous pouvez choisir des versions spécifiques d'Appium avec. avm Par exemple, pour utiliser la avm commande pour définir la version du serveur Appium2.1.2, ajoutez ces commandes à votre fichier YAML de spécification de test. 

phases:
  install:
    commands:
      - export APPIUM_VERSION=2.1.2
      - avm $APPIUM_VERSION

Sélection d'une WebDriverAgent version pour les tests iOS

Pour exécuter les tests Appium sur les appareils iOS, l'utilisation de WebDriverAgent est requise. Cette application doit être signée pour pouvoir être installée sur les appareils iOS. Device Farm fournit des versions pré-signées WebDriverAgent qui sont disponibles lors des exécutions de l'environnement de test personnalisé.

L'extrait de code suivant peut être utilisé pour sélectionner une WebDriverAgent version de Device Farm dans votre fichier de spécifications de test qui est compatible avec la version de votre pilote XCTestUI. 

phases:
  pre_test:
    commands:
      - |-
        APPIUM_DRIVER_VERSION=$(appium driver list --installed --json | jq -r ".xcuitest.version" | cut -d "." -f 1);
        CORRESPONDING_APPIUM_WDA=$(env | grep "DEVICEFARM_APPIUM_WDA_DERIVED_DATA_PATH_V${APPIUM_DRIVER_VERSION}")
        if [[ ! -z "$APPIUM_DRIVER_VERSION" ]] && [[ ! -z "$CORRESPONDING_APPIUM_WDA" ]]; then
          echo "Using a prebuilt version of the WDA app corresponding with your XCUITest driver version ${APPIUM_DRIVER_VERSION}";
          DEVICEFARM_APPIUM_WDA_DERIVED_DATA_PATH=$(echo $CORRESPONDING_APPIUM_WDA | cut -d "=" -f2)
        else
          LATEST_SUPPORTED_WDA_VERSION=$(env | grep "DEVICEFARM_APPIUM_WDA_DERIVED_DATA_PATH_V" | sort -V -r | head -n 1)
          echo "Unknown driver version $APPIUM_DRIVER_VERSION; falling back to the Device Farm default version of $LATEST_SUPPORTED_WDA_VERSION";
          DEVICEFARM_APPIUM_WDA_DERIVED_DATA_PATH=$(echo $LATEST_SUPPORTED_WDA_VERSION | cut -d "=" -f2)
        fi;

Pour plus d'informations à ce sujet WebDriverAgent, consultez la documentation d'Appium. https://appium.github.io/appium-xcuitest-driver/9.10/guides/run-prebuilt-wda/