Variables d’environnement dans le test
Important
La mise hors service de Visual Studio App Center est prévue pour le 31 mars 2025. Bien que vous puissiez continuer à utiliser Visual Studio App Center jusqu’à sa mise hors service complète, il existe plusieurs alternatives recommandées vers lesquelles vous pouvez envisager la migration.
En savoir plus sur les chronologies et les alternatives de support.
Lors du test, il est souvent utile de lancer votre application ou exécuteur de test avec des variables d’environnement personnalisées définies. Par exemple, les variables d’environnement peuvent être utilisées pour contrôler le comportement de votre application ou fournir des tests avec des informations de connexion.
Pour la plupart des frameworks, des variables d’environnement utiles sont disponibles dans le test, l’application ou les deux. Vous pouvez définir des variables d’environnement supplémentaires via l’interface CLI App Center.
Prise en charge par framework
Dans App Center, certaines infrastructures et combinaisons de plateformes prennent en charge la définition et l’utilisation de variables d’environnement personnalisées, ainsi que l’utilisation de variables qui sont mises automatiquement à la disposition de votre application et des tests (par exemple RUNNING_IN_APP_CENTER et APP_CENTER_TEST).
Ce tableau répertorie les variables d’environnement prises en charge pour chaque infrastructure ou plateforme :
| Infrastructure | Variables d’environnement de test | Variables d’environnement d’application |
|---|---|---|
| Appium | Disponible | Non disponible |
| Calebasse | Disponible | Disponible dans iOS uniquement |
| Espresso | Disponible | Disponible |
| Xamarin.UITest | Disponible | Disponible dans iOS uniquement |
| XCUITest | Non disponible | Non disponible |
Notes
Dans les tests Espresso et les applications Android, des variables sont disponibles dans la InstrumentationRegistry mesure où Android ne prend pas en charge les variables d’environnement.
Variables d’environnement disponibles dans votre application
Pour les frameworks pris en charge, ces variables d’environnement sont disponibles dans l’application :
| Variable d’environnement | Description |
|---|---|
RUNNING_IN_APP_CENTER |
Défini sur 1 lorsque l’appareil s’exécute dans App Center Test |
Variables d’environnement disponibles dans vos tests
Pour les frameworks pris en charge, ces variables d’environnement sont disponibles dans les tests :
| Variable d’environnement | Description |
|---|---|
APP_CENTER_TEST |
Définissez sur 1 quand vos tests s’exécutent dans App Center Test. |
XTC_APP_ENDPOINT |
Adresse d’un port sécurisé sur l’appareil qui permet à d’autres services de communiquer avec l’application. Utilisé par les applications qui incorporent leurs propres serveurs HTTP dans une application et qui doivent interagir avec l’application en dehors de l’infrastructure de test. (Android uniquement). Exemple : http://devicehost151.prod:37777/proxy2/token-c059c5c6-37cc-4400-9038-96d1d342ed6e/ |
XTC_DEVICE |
Combine le nom du système d’exploitation et le nom de l’appareil. Exemple : Google Pixel 2 XL (8.1.0) |
XTC_DEVICE_INDEX |
Chaîne comprise entre 0 et N-1, où N est le nombre d’appareils sur lesquels le test est exécuté. Utilisé dans les situations où le même test est exécuté en parallèle sur plusieurs appareils. XTC_DEVICE_INDEX est unique pour chaque série de tests pour chaque appareil. Pour plus d’informations, consultez : Gestion des modifications de base de données simultanées pendant les tests. |
XTC_DEVICE_NAME |
Nom de l’appareil exécutant le test. Exemple : Google Pixel 2 XL |
XTC_DEVICE_OS |
Nom du système d’exploitation de l’appareil exécutant le test. Exemple : 8.1.0 |
XTC_LANG |
Code de langue utilisé pour exécuter le test. Exemple : en |
XTC_PLATFORM |
Plateforme testée, ou androidios. |
Définition de variables d’environnement supplémentaires
Lorsque vous chargez vos tests dans App Center avec l’interface CLI, vous pouvez demander la définition de variables d’environnement à l’aide de l’option --test-parameter . Les variables d’environnement peuvent être définies pour l’exécuteur de test et pour votre application (l’application testée ou AUT).
Notes
Pour plus d’informations sur les infrastructures qui prennent en charge les variables de test et d’application dans App Center Test, consultez Prise en charge par infrastructure .
Variables d’environnement pour vos tests
$ appcenter test run < > \
< args > \
--test-parameter "test_env=USERNAME=clever_user@example.com" \
--test-parameter "test_env=PASSWORD=pa$$w0rd" \
--test-parameter "test_env=TWO_FACTOR_URL=https://staging.example.com/test-2FA" \
--test-parameter "test_env=UPGRADE_PURCHASED=0"
Variables d’environnement pour votre application
$ appcenter test run < > \
< args > \
--test-parameter "app_env=VERBOSE_LOGGING=1" \
--test-parameter "app_env=CONTENT_SERVER=staging.example.com \
--test-parameter "app_env=API_LEVEL=3.2" \
--test-parameter "app_env=UPGRADE_PURCHASED=0"
Utilisation de variables d’environnement dans vos tests
Exemple de code de test Appium :
L’extrait de code suivant montre comment accéder aux variables d’environnement dans App Center Test à l’aide d’Appium
String appCenterTest = System.getenv("APP_CENTER_TEST");
Exemple de code de test Calabash :
L’extrait de code suivant montre comment accéder aux variables d’environnement dans App Center Test à l’aide de Calabash
app_center_test = ENV["APP_CENTER_TEST"]
Exemple de code de test Espresso
Étant donné qu’Android ne prend pas en charge les variables d’environnement, App Center Test définit InstrumentationRegistry des valeurs pour Espresso. L’extrait de code suivant montre comment accéder aux InstrumentationRegistry valeurs.
String appCenterTest = InstrumentationRegistry.getArguments().getString("APP_CENTER_TEST");
Exemple de code de test Xamarin.UITest
L’extrait de code suivant montre comment accéder aux variables d’environnement dans App Center Test à l’aide de Xamarin.UITest :
string appCenterTest = Environment.GetEnvironmentVariable("APP_CENTER_TEST");
Utilisation de variables d’environnement dans votre application
Exemple de code d’application Android native
Notes
Pour plus d’informations sur les infrastructures qui prennent en charge les variables d’application dans App Center Test, consultez Prise en charge par infrastructure.
Étant donné qu’Android ne prend pas en charge les variables d’environnement, App Center Test définit InstrumentationRegistry les valeurs à la place. L’extrait de code suivant montre comment accéder aux InstrumentationRegistry valeurs.
String runningInAppCenter = InstrumentationRegistry.getArguments().getString("RUNNING_IN_APP_CENTER");
Exemple de code d’application iOS native
Notes
Pour plus d’informations sur les infrastructures qui prennent en charge les variables d’application dans App Center Test, consultez Prise en charge par infrastructure.
Les applications iOS natives accèdent aux variables d’environnement via l’API NSProcessInfo.
[[NSProcessInfo processInfo] environment]["RUNNING_IN_APP_CENTER"]
ProcessInfo.processInfo.environment["RUNNING_IN_APP_CENTER"]
Obtenir de l’aide
Vous pouvez contacter le support technique dans le portail App Center. Dans le coin supérieur droit de l’écran, sélectionnez le menu Aide ( ?), puis choisissez « Contacter le support ». Notre équipe de support dédiée répondra à vos questions.
Si vous souhaitez obtenir de l’aide sur une série de tests, accédez à la série de tests en question et copiez l’URL à partir de votre navigateur et collez-la dans la conversation de support. L’URL d’une série de tests ressemble https://appcenter.ms/orgs/OrgName/apps/App-Name/test/runs/77a1c67e-2cfb-4bbd-a75a-eb2b4fd0a747à .