Variáveis de ambiente em teste
Importante
O Visual Studio App Center está programado para ser desativado em 31 de março de 2025. Embora você possa continuar a usar o Visual Studio App Center até que ele seja totalmente desativado, há várias alternativas recomendadas para as quais você pode considerar a migração.
Ao testar, geralmente é útil iniciar seu aplicativo ou executor de teste com variáveis de ambiente personalizadas definidas. Por exemplo, variáveis de ambiente podem ser usadas para controlar o comportamento do aplicativo ou fornecer testes com informações de entrada.
Para a maioria das estruturas, variáveis de ambiente úteis estão disponíveis no teste, aplicativo ou ambos. Você pode definir variáveis de ambiente adicionais por meio da CLI do App Center.
Suporte por estrutura
No App Center, algumas estruturas e combinações de plataforma dão suporte à configuração e ao uso de variáveis de ambiente personalizadas, bem como ao uso de variáveis que são disponibilizadas para seu aplicativo e testes automaticamente (por exemplo RUNNING_IN_APP_CENTER , e APP_CENTER_TEST).
Esta tabela lista as variáveis de ambiente com suporte para cada estrutura ou plataforma:
| Estrutura | Testar variáveis de ambiente | Variáveis de ambiente de aplicativo |
|---|---|---|
| Appium | Disponível | Não disponível |
| Cabaça | Disponível | Disponível apenas no iOS |
| Expresso | Disponível | Disponível |
| Xamarin.UITest | Disponível | Disponível apenas no iOS |
| XCUITest | Não disponível | Não disponível |
Observação
Em testes do Espresso e aplicativos Android, as variáveis estão disponíveis no, pois o Android não dá suporte a InstrumentationRegistry variáveis de ambiente.
Variáveis de ambiente disponíveis em seu aplicativo
Para estruturas com suporte, essas variáveis de ambiente estão disponíveis no aplicativo:
| Variável de ambiente | Descrição |
|---|---|
RUNNING_IN_APP_CENTER |
Defina como 1 quando o dispositivo está em execução no Teste do App Center |
Variáveis de ambiente disponíveis em seus testes
Para estruturas com suporte, essas variáveis de ambiente estão disponíveis nos testes:
| Variável de ambiente | Descrição |
|---|---|
APP_CENTER_TEST |
Defina como 1 quando os testes forem executados no Teste do App Center. |
XTC_APP_ENDPOINT |
Endereço de uma porta segura no dispositivo que permite que outros serviços se comuniquem com o aplicativo. Usado por aplicativos que inserem seus próprios servidores HTTP em um aplicativo e precisam interagir com o aplicativo fora da estrutura de teste. (Somente Android). Exemplo: http://devicehost151.prod:37777/proxy2/token-c059c5c6-37cc-4400-9038-96d1d342ed6e/ |
XTC_DEVICE |
Combina o nome do sistema operacional e o nome do dispositivo. Exemplo: Google Pixel 2 XL (8.1.0) |
XTC_DEVICE_INDEX |
Uma cadeia de caracteres no intervalo de 0 a N-1, em que N é o número de dispositivos em que o teste é executado. Usado em situações em que o mesmo teste está sendo executado em paralelo em vários dispositivos. XTC_DEVICE_INDEX é exclusivo para cada execução de teste para cada dispositivo. Para obter discussões adicionais, consulte: Tratamento de alterações simultâneas de banco de dados durante testes. |
XTC_DEVICE_NAME |
Nome do dispositivo que executa o teste. Exemplo: Google Pixel 2 XL |
XTC_DEVICE_OS |
Nome do sistema operacional para o dispositivo que executa o teste. Exemplo: 8.1.0 |
XTC_LANG |
Código de linguagem usado para executar o teste. Exemplo: en |
XTC_PLATFORM |
Plataforma em teste, ou androidios. |
Definindo variáveis de ambiente adicionais
Ao carregar seus testes no App Center com a CLI, você pode solicitar que variáveis de ambiente sejam definidas usando a opção --test-parameter . As variáveis de ambiente podem ser definidas para o executor de teste e para o aplicativo (o aplicativo em teste ou AUT).
Observação
Consulte Suporte por estrutura para obter detalhes de quais estruturas dão suporte a variáveis de teste e aplicativo no Teste do App Center.
Variáveis de ambiente para seus testes
$ 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"
Variáveis de ambiente para seu aplicativo
$ 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"
Usando variáveis de ambiente em seus testes
Exemplo de código de teste do Appium:
O snippet de código a seguir mostra como acessar variáveis de ambiente no Teste do App Center usando Appium
String appCenterTest = System.getenv("APP_CENTER_TEST");
Exemplo de código de teste calabash:
O snippet de código a seguir mostra como acessar variáveis de ambiente no Teste do App Center usando Calabash
app_center_test = ENV["APP_CENTER_TEST"]
Exemplo de código de teste do Espresso
Como o Android não dá suporte a variáveis de ambiente, o Teste do App Center define InstrumentationRegistry valores em vez de Espresso. O snippet de código a seguir mostra como acessar os InstrumentationRegistry valores.
String appCenterTest = InstrumentationRegistry.getArguments().getString("APP_CENTER_TEST");
Exemplo de código de teste do Xamarin.UITest
O snippet de código a seguir mostra como acessar variáveis de ambiente no Teste do App Center usando Xamarin.UITest:
string appCenterTest = Environment.GetEnvironmentVariable("APP_CENTER_TEST");
Usando variáveis de ambiente em seu aplicativo
Exemplo de código de aplicativo Android nativo
Observação
Consulte Suporte por estrutura para obter detalhes de quais estruturas dão suporte a variáveis de aplicativo no Teste do App Center.
Como o Android não dá suporte a variáveis de ambiente, o Teste do App Center define InstrumentationRegistry valores. O snippet de código a seguir mostra como acessar os InstrumentationRegistry valores.
String runningInAppCenter = InstrumentationRegistry.getArguments().getString("RUNNING_IN_APP_CENTER");
Exemplo de código de aplicativo iOS nativo
Observação
Consulte Suporte por estrutura para obter detalhes de quais estruturas dão suporte a variáveis de aplicativo no Teste do App Center.
Aplicativos iOS nativos acessam variáveis de ambiente por meio da API NSProcessInfo.
[[NSProcessInfo processInfo] environment]["RUNNING_IN_APP_CENTER"]
ProcessInfo.processInfo.environment["RUNNING_IN_APP_CENTER"]
Obtendo ajuda
Você pode entrar em contato com o suporte no portal do App Center. No canto superior direito da tela, selecione o menu Ajuda (?) e escolha "Contate o suporte". Nossa equipe de suporte dedicada responderá às suas perguntas.
Se você quiser ajuda com uma execução de teste, navegue até a execução do teste em questão e copie a URL do navegador e cole-a na conversa de suporte. Uma URL de execução de teste se parece com algo como https://appcenter.ms/orgs/OrgName/apps/App-Name/test/runs/77a1c67e-2cfb-4bbd-a75a-eb2b4fd0a747.