Variables de entorno en prueba
Importante
Visual Studio App Center está programado para la retirada el 31 de marzo de 2025. Aunque puede seguir usando Visual Studio App Center hasta que se retire por completo, hay varias alternativas recomendadas a las que puede considerar la posibilidad de migrar.
Obtenga más información sobre las escalas de tiempo de soporte técnico y las alternativas.
Al realizar pruebas, a menudo resulta útil iniciar la aplicación o el ejecutor de pruebas con variables de entorno personalizadas establecidas. Por ejemplo, las variables de entorno se pueden usar para controlar el comportamiento de la aplicación o proporcionar pruebas con información de inicio de sesión.
Para la mayoría de los marcos, las variables de entorno útiles están disponibles dentro de la prueba, la aplicación o ambas. Puede establecer variables de entorno adicionales a través de la CLI de App Center.
Compatibilidad con el marco
En App Center, algunas combinaciones de plataformas y marcos admiten la configuración y el uso de variables de entorno personalizadas, así como el uso de variables que están disponibles para la aplicación y las pruebas automáticamente (por ejemplo RUNNING_IN_APP_CENTER , y APP_CENTER_TEST).
En esta tabla se enumeran las variables de entorno admitidas para cada plataforma o marco:
| marco | Probar variables de entorno | Variables de entorno de aplicación |
|---|---|---|
| Appium | Disponible | No disponible |
| Calabash | Disponible | Solo disponible en iOS |
| Espresso | Disponible | Disponible |
| Xamarin.UITest | Disponible | Solo disponible en iOS |
| XCUITest | No disponible | No disponible |
Nota
En las pruebas de Espresso y las aplicaciones android, las variables están disponibles en , InstrumentationRegistry ya que Android no admite variables de entorno.
Variables de entorno disponibles en la aplicación
En el caso de los marcos admitidos, estas variables de entorno están disponibles en la aplicación:
| Variable de entorno | Descripción |
|---|---|
RUNNING_IN_APP_CENTER |
1 Se establece en cuando el dispositivo se ejecuta en la prueba de App Center |
Variables de entorno disponibles en las pruebas
En el caso de los marcos admitidos, estas variables de entorno están disponibles en las pruebas:
| Variable de entorno | Descripción |
|---|---|
APP_CENTER_TEST |
Establézcalo 1 en cuando las pruebas se ejecuten en App Center Test. |
XTC_APP_ENDPOINT |
Dirección de un puerto seguro en el dispositivo que permite que otros servicios se comuniquen con la aplicación. Las aplicaciones que insertan sus propios servidores HTTP en una aplicación y necesitan interactuar con la aplicación fuera del marco de pruebas. (Solo Android). Ejemplo: http://devicehost151.prod:37777/proxy2/token-c059c5c6-37cc-4400-9038-96d1d342ed6e/ |
XTC_DEVICE |
Combina el nombre del sistema operativo y el nombre del dispositivo. Ejemplo: Google Pixel 2 XL (8.1.0) |
XTC_DEVICE_INDEX |
Cadena del intervalo de 0 a N-1, donde N es el número de dispositivos en los que se ejecuta la prueba. Se usa en situaciones en las que se ejecuta la misma prueba en paralelo en varios dispositivos. XTC_DEVICE_INDEX es único para cada ejecución de prueba para cada dispositivo. Para obtener más información, consulte: Control de cambios simultáneos en la base de datos durante las pruebas. |
XTC_DEVICE_NAME |
Nombre del dispositivo que ejecuta la prueba. Ejemplo: Google Pixel 2 XL |
XTC_DEVICE_OS |
Nombre del sistema operativo para el dispositivo que ejecuta la prueba. Ejemplo: 8.1.0 |
XTC_LANG |
Código de lenguaje usado para ejecutar la prueba. Ejemplo: en |
XTC_PLATFORM |
Plataforma en prueba, ya sea android o ios. |
Establecimiento de variables de entorno adicionales
Al cargar las pruebas en App Center con la CLI, puede solicitar que se establezcan variables de entorno mediante la --test-parameter opción . Las variables de entorno se pueden establecer para el ejecutor de pruebas y para la aplicación (la aplicación en pruebas o AUT).
Nota
Consulte Compatibilidad por marco para obtener más información sobre qué marcos admiten variables de aplicación y pruebas en App Center Test.
Variables de entorno para las pruebas
$ 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 de entorno para la aplicación
$ 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"
Uso de variables de entorno en las pruebas
Código de prueba de Appium de ejemplo:
El siguiente fragmento de código muestra cómo acceder a variables de entorno en App Center Test mediante Appium
String appCenterTest = System.getenv("APP_CENTER_TEST");
Código de prueba de Calabash de ejemplo:
El siguiente fragmento de código muestra cómo acceder a variables de entorno en App Center Test mediante Calabash
app_center_test = ENV["APP_CENTER_TEST"]
Código de prueba de Espresso de ejemplo
Dado que Android no admite variables de entorno, App Center Test establece InstrumentationRegistry los valores en su lugar para Espresso. El siguiente fragmento de código muestra cómo obtener acceso a los InstrumentationRegistry valores.
String appCenterTest = InstrumentationRegistry.getArguments().getString("APP_CENTER_TEST");
Código de prueba de Xamarin.UITest de ejemplo
En el fragmento de código siguiente se muestra cómo acceder a variables de entorno en App Center Test mediante Xamarin.UITest:
string appCenterTest = Environment.GetEnvironmentVariable("APP_CENTER_TEST");
Uso de variables de entorno en la aplicación
Código de aplicación de Android nativo de ejemplo
Nota
Consulte Compatibilidad por marco para obtener más información sobre qué marcos admiten variables de aplicación en App Center Test.
Dado que Android no admite variables de entorno, App Center Test establece InstrumentationRegistry valores en su lugar. El siguiente fragmento de código muestra cómo obtener acceso a los InstrumentationRegistry valores.
String runningInAppCenter = InstrumentationRegistry.getArguments().getString("RUNNING_IN_APP_CENTER");
Código de aplicación nativo de iOS de ejemplo
Nota
Consulte Compatibilidad por marco para obtener más información sobre qué marcos admiten variables de aplicación en App Center Test.
Las aplicaciones nativas de iOS acceden a variables de entorno a través de la API NSProcessInfo.
[[NSProcessInfo processInfo] environment]["RUNNING_IN_APP_CENTER"]
ProcessInfo.processInfo.environment["RUNNING_IN_APP_CENTER"]
Ayuda
Puede ponerse en contacto con el soporte técnico en el portal de App Center. En la esquina superior derecha de la pantalla, seleccione el menú Ayuda (?) y elija "Ponerse en contacto con el soporte técnico". Nuestro equipo de soporte técnico dedicado responderá a sus preguntas.
Si desea ayuda con una ejecución de prueba, vaya a la ejecución de pruebas en cuestión y copie la dirección URL del explorador y péguela en la conversación de soporte técnico. Una dirección URL de ejecución de prueba tiene un aspecto similar a https://appcenter.ms/orgs/OrgName/apps/App-Name/test/runs/77a1c67e-2cfb-4bbd-a75a-eb2b4fd0a747.