Variabili di ambiente nel test
Importante
Visual Studio App Center è pianificato per il ritiro il 31 marzo 2025. Anche se è possibile continuare a usare Visual Studio App Center fino a quando non viene completamente ritirato, esistono diverse alternative consigliate a cui è possibile prendere in considerazione la migrazione.
Altre informazioni sulle sequenze temporali di supporto e sulle alternative.
Durante il test, spesso è utile avviare l'applicazione o lo strumento di esecuzione di test con variabili di ambiente personalizzate impostate. Ad esempio, le variabili di ambiente possono essere usate per controllare il comportamento dell'applicazione o fornire ai test informazioni di accesso.
Per la maggior parte dei framework, le variabili di ambiente utili sono disponibili all'interno del test, dell'applicazione o di entrambi. È possibile impostare variabili di ambiente aggiuntive tramite l'interfaccia della riga di comando di App Center.
Supporto per framework
In App Center alcuni framework e combinazioni di piattaforme supportano l'impostazione e l'uso di variabili di ambiente personalizzate, nonché l'uso di variabili rese disponibili per l'applicazione e i test automaticamente (ad esempio RUNNING_IN_APP_CENTER e APP_CENTER_TEST).
Questa tabella elenca le variabili di ambiente supportate per ogni framework o piattaforma:
| Framework | Testare le variabili di ambiente | Variabili di ambiente dell'applicazione |
|---|---|---|
| Appium | Disponibile | Non disponibile |
| Calabash | Disponibile | Disponibile solo in iOS |
| Espresso | Disponibile | Disponibile |
| Xamarin.UITest | Disponibile | Disponibile solo in iOS |
| XCUITest | Non disponibile | Non disponibile |
Nota
Nei test Espresso e nelle applicazioni Android le variabili sono disponibili in InstrumentationRegistry poiché Android non supporta le variabili di ambiente.
Variabili di ambiente disponibili nell'applicazione
Per i framework supportati, queste variabili di ambiente sono disponibili all'interno dell'applicazione:
| Variabile di ambiente | Descrizione |
|---|---|
RUNNING_IN_APP_CENTER |
Impostare su 1 quando il dispositivo è in esecuzione nel test di App Center |
Variabili di ambiente disponibili nei test
Per i framework supportati, queste variabili di ambiente sono disponibili nei test:
| Variabile di ambiente | Descrizione |
|---|---|
APP_CENTER_TEST |
Impostare su 1 quando i test vengono eseguiti nel test di App Center. |
XTC_APP_ENDPOINT |
Indirizzo di una porta sicura nel dispositivo che consente ad altri servizi di comunicare con l'applicazione. Usato dalle applicazioni che incorporano i propri server HTTP in un'applicazione e devono interagire con l'app all'esterno del framework di test. (Solo Android). Esempio: http://devicehost151.prod:37777/proxy2/token-c059c5c6-37cc-4400-9038-96d1d342ed6e/ |
XTC_DEVICE |
Combina il nome del sistema operativo e il nome del dispositivo. Esempio: Google Pixel 2 XL (8.1.0) |
XTC_DEVICE_INDEX |
Stringa nell'intervallo da 0 a N-1, dove N è il numero di dispositivi in cui viene eseguito il test. Usato in situazioni in cui lo stesso test viene eseguito in parallelo su più dispositivi. XTC_DEVICE_INDEX è univoco per ogni esecuzione di test per ogni dispositivo. Per altre informazioni, vedere Gestione delle modifiche simultanee del database durante i test. |
XTC_DEVICE_NAME |
Nome del dispositivo che esegue il test. Esempio: Google Pixel 2 XL |
XTC_DEVICE_OS |
Nome del sistema operativo per il dispositivo che esegue il test. Esempio: 8.1.0 |
XTC_LANG |
Codice linguistico usato per eseguire il test. Esempio: en |
XTC_PLATFORM |
Piattaforma sottoposta a android test, o ios. |
Impostazione di variabili di ambiente aggiuntive
Quando si caricano i test in App Center con l'interfaccia della riga di comando, è possibile richiedere l'impostazione delle variabili di ambiente usando l'opzione --test-parameter . Le variabili di ambiente possono essere impostate per lo strumento di esecuzione dei test e per l'applicazione (l'applicazione sottoposta a test o AUT).
Nota
Per informazioni dettagliate sui framework che supportano le variabili di test e di applicazione in App Center Test, vedere Supporto per framework .
Variabili di ambiente per i test
$ 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"
Variabili di ambiente per l'applicazione
$ 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 delle variabili di ambiente nei test
Codice di test di Appium di esempio:
Il frammento di codice seguente illustra come accedere alle variabili di ambiente in App Center Test con Appium
String appCenterTest = System.getenv("APP_CENTER_TEST");
Codice di test calabash di esempio:
Il frammento di codice seguente illustra come accedere alle variabili di ambiente nel test di App Center usando Calabash
app_center_test = ENV["APP_CENTER_TEST"]
Codice di test espresso di esempio
Poiché Android non supporta le variabili di ambiente, App Center Test imposta InstrumentationRegistry invece i valori per Espresso. Il frammento di codice seguente illustra come accedere ai InstrumentationRegistry valori.
String appCenterTest = InstrumentationRegistry.getArguments().getString("APP_CENTER_TEST");
Codice di test Xamarin.UITest di esempio
Il frammento di codice seguente illustra come accedere alle variabili di ambiente nel test di App Center usando Xamarin.UITest:
string appCenterTest = Environment.GetEnvironmentVariable("APP_CENTER_TEST");
Uso delle variabili di ambiente nell'applicazione
Codice di applicazione Android nativo di esempio
Nota
Per informazioni dettagliate sui framework che supportano le variabili dell'applicazione in App Center Test, vedere Supporto per framework .
Poiché Android non supporta le variabili di ambiente, App Center Test imposta InstrumentationRegistry invece i valori. Il frammento di codice seguente illustra come accedere ai InstrumentationRegistry valori.
String runningInAppCenter = InstrumentationRegistry.getArguments().getString("RUNNING_IN_APP_CENTER");
Codice di applicazione iOS nativo di esempio
Nota
Per informazioni dettagliate sui framework che supportano le variabili dell'applicazione in App Center Test, vedere Supporto per framework .
Le applicazioni iOS native accedono alle variabili di ambiente tramite l'API NSProcessInfo.
[[NSProcessInfo processInfo] environment]["RUNNING_IN_APP_CENTER"]
ProcessInfo.processInfo.environment["RUNNING_IN_APP_CENTER"]
Risorse della Guida
È possibile contattare il supporto tecnico nel portale di App Center. Nell'angolo in alto a destra della schermata selezionare il menu ?, quindi scegliere "Contatta il supporto". Il nostro team di supporto dedicato risponderà alle tue domande.
Per assistenza con un'esecuzione di test, passare all'esecuzione del test in questione e copiare l'URL dal browser e incollarlo nella conversazione di supporto. Un URL di esecuzione del test è simile a https://appcenter.ms/orgs/OrgName/apps/App-Name/test/runs/77a1c67e-2cfb-4bbd-a75a-eb2b4fd0a747.