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.
Variables d'environnement pour les environnements de test personnalisés
Device Farm configure dynamiquement plusieurs variables d'environnement à utiliser dans le cadre de l'exécution de votre environnement de test personnalisé.
Rubriques
Variables d'environnement personnalisées
Device Farm prend en charge la configuration de paires clé-valeur appliquées en tant que variables d'environnement sur l'hôte de test. Elles peuvent être configurées sur un projet Device Farm ou lors de la création d'une exécution ; toutes les variables configurées lors d'une exécution remplaceront celles qui peuvent être configurées sur son projet parent. Les restrictions suivantes s’appliquent :
-
Les variables d'environnement personnalisées ne sont pas prises en charge sur les anciens hôtes de test iOS. Pour de plus amples informations, veuillez consulter Ancien hôte de test iOS.
-
Les noms de variables commençant par
$DEVICEFARM_sont réservés à un usage interne du service. -
Les variables d'environnement personnalisées ne peuvent pas être utilisées pour configurer la sélection de calcul de l'hôte de test dans votre spécification de test.
Variables d'environnement communes
Cette section décrit les variables d'environnement communes à tous les tests de Device Farm.
-
$DEVICEFARM_DEVICE_NAME -
L'appareil sur lequel vos tests sont exécutés. Il représente l'identifiant unique de l'appareil (UDID).
-
$DEVICEFARM_DEVICE_UDID -
Identifiant unique de l'appareil.
-
$DEVICEFARM_DEVICE_PLATFORM_NAME -
Le nom de la plateforme de l'appareil. C'est l'un
Androidou l'autreiOS. -
$DEVICEFARM_DEVICE_OS_VERSION -
Version du système d'exploitation de l'appareil.
-
$DEVICEFARM_APP_PATH -
(tests d'applications mobiles)
Chemin de l'application mobile sur la machine hôte où les tests sont en cours d'exécution. Cette variable n'est pas disponible lors des tests Web.
-
$DEVICEFARM_LOG_DIR -
Le chemin d'accès au répertoire par défaut dans lequel les journaux des clients, les artefacts et les autres fichiers souhaités seront stockés pour être récupérés ultérieurement. À l'aide d'un exemple de spécification de test, les fichiers de ce répertoire sont archivés dans un fichier ZIP et mis à disposition sous forme d'artefact après votre test.
-
$DEVICEFARM_SCREENSHOT_PATH -
Chemin des captures d'écran, le cas échéant, capturées au cours du test.
-
$DEVICEFARM_PROJECT_ARN -
L'ARN du projet parent de la tâche.
-
$DEVICEFARM_RUN_ARN -
L'ARN de l'exécution parent de la tâche.
-
$DEVICEFARM_DEVICE_ARN -
L'ARN de l'appareil testé.
-
$DEVICEFARM_TOTAL_JOBS -
Le nombre total de tâches associées à l'exécution de son Device Farm parent.
-
$DEVICEFARM_JOB_NUMBER -
Le numéro de ce job se trouve à l'intérieur
$DEVICEFARM_TOTAL_JOBS. Par exemple, une exécution peut contenir 5 tâches, chacune ayant un caractère unique$DEVICEFARM_JOB_NUMBERcompris entre 0 et 4. -
$AWS_REGION -
Région AWS Le service le configurera pour qu'il corresponde à la région dans laquelle se trouve l'appareil testé. Elle peut être remplacée par une variable d'environnement personnalisée si nécessaire.
-
$ANDROID_HOME -
(Android uniquement)
Le chemin d'accès au répertoire d'installation du SDK Android.
Variables d'environnement pour les tests Appium
Cette section décrit les variables d'environnement utilisées par n'importe quel test Appium dans un environnement de test personnalisé dans Device Farm.
-
$DEVICEFARM_CHROMEDRIVER_EXECUTABLE_DIR -
(Android uniquement)
L'emplacement d'un répertoire contenant les ChromeDriver exécutables nécessaires à une utilisation dans les tests Web et hybrides d'Appium.
-
$DEVICEFARM_APPIUM_WDA_DERIVED_DATA_PATH_V<N> -
(iOS uniquement)
Le chemin de données dérivé d'une version de Device Farm WebDriverAgent conçue pour fonctionner sur Device Farm. La numérotation de la variable correspondra à la version principale du WebDriverAgent. À titre d'exemple,
DEVICEFARM_APPIUM_WDA_DERIVED_DATA_PATH_V9indiquera la WebDriverAgent version a de 9.x. Pour de plus amples informations, veuillez consulter Sélection d'une WebDriverAgent version pour les tests iOS.Note
Les variables d'
$DEVICEFARM_APPIUM_WDA_DERIVED_DATA_PATH_V<N>environnement ne sont présentes que sur les hôtes iOS non existants. Pour de plus amples informations, veuillez consulter Ancien hôte de test iOS. -
$DEVICEFARM_WDA_DERIVED_DATA_PATH_V9 -
(iOS uniquement, obsolète)
Le chemin de données dérivé d'une version de Device Farm WebDriverAgent conçue pour fonctionner sur Device Farm. Reportez-vous
$DEVICEFARM_APPIUM_WDA_DERIVED_DATA_PATH_V<N>au schéma de dénomination de remplacement.
Variables d'environnement pour les XCUITest tests
Cette section décrit les variables d'environnement utilisées par le XCUITest test dans un environnement de test personnalisé dans Device Farm.
-
$DEVICEFARM_XCUITESTRUN_FILE -
Le chemin d'accès au
.xctestunfichier Device Farm. Il est généré à partir de vos packages d'application et de test. -
$DEVICEFARM_DERIVED_DATA_PATH -
Chemin attendu de la sortie xcodebuild de Device Farm.
-
$DEVICEFARM_XCTEST_BUILD_DIRECTORY -
Chemin du contenu décompressé du fichier du package de test.
