Freigeben über

Umgebungsvariablen im Test

  • Artikel

Wichtig

Visual Studio App Center wird am 31. März 2025 eingestellt. Sie können Visual Studio App Center zwar weiterhin verwenden, bis es vollständig eingestellt ist, es gibt jedoch mehrere empfohlene Alternativen, zu denen Sie eine Migration in Betracht ziehen können.

Erfahren Sie mehr über Supportzeitpläne und Alternativen.

Beim Testen ist es häufig hilfreich, Ihre Anwendung oder Ihren Testrunner mit festgelegten benutzerdefinierten Umgebungsvariablen zu starten. Beispielsweise können Umgebungsvariablen verwendet werden, um das Verhalten Ihrer Anwendung zu steuern oder Tests mit Anmeldeinformationen bereitzustellen.

Für die meisten Frameworks sind nützliche Umgebungsvariablen innerhalb des Tests, der Anwendung oder beides verfügbar. Sie können zusätzliche Umgebungsvariablen über die App Center-CLI festlegen.

Unterstützung durch Framework

In App Center unterstützen einige Frameworks und Plattformkombinationen das Festlegen und Verwenden benutzerdefinierter Umgebungsvariablen sowie die Verwendung von Variablen, die ihrer Anwendung zur Verfügung gestellt und automatisch getestet werden (z. B RUNNING_IN_APP_CENTER . und APP_CENTER_TEST).

In dieser Tabelle werden Umgebungsvariablen aufgeführt, die für jedes Framework oder jede Plattform unterstützt werden:

Framework Testumgebungsvariablen Anwendungsumgebungsvariablen
Appium Verfügbar Nicht verfügbar.
Kalebasse Verfügbar Nur in iOS verfügbar
Espresso Verfügbar Verfügbar
Xamarin.UITest Verfügbar Nur in iOS verfügbar
XCUITest Nicht verfügbar. Nicht verfügbar.

Hinweis

In Espresso-Tests und Android-Anwendungen sind Variablen in InstrumentationRegistry verfügbar, da Android keine Umgebungsvariablen unterstützt.

In Ihrer Anwendung verfügbare Umgebungsvariablen

Für unterstützte Frameworks sind diese Umgebungsvariablen in der Anwendung verfügbar:

Umgebungsvariable BESCHREIBUNG
RUNNING_IN_APP_CENTER Wird auf 1 festgelegt, wenn das Gerät in App Center Test ausgeführt wird

In Ihren Tests verfügbare Umgebungsvariablen

Für unterstützte Frameworks sind diese Umgebungsvariablen innerhalb der Tests verfügbar:

Umgebungsvariable BESCHREIBUNG
APP_CENTER_TEST Legen Sie auf fest 1 , wenn Ihre Tests in App Center Test ausgeführt werden.
XTC_APP_ENDPOINT Adresse eines sicheren Ports auf dem Gerät, der es anderen Diensten ermöglicht, mit der Anwendung zu kommunizieren. Wird von Anwendungen verwendet, die ihre eigenen HTTP-Server in eine Anwendung einbetten und mit der App außerhalb des Testframeworks interagieren müssen. (Nur Android).

Beispiel: http://devicehost151.prod:37777/proxy2/token-c059c5c6-37cc-4400-9038-96d1d342ed6e/
XTC_DEVICE Kombiniert den Betriebssystemnamen und den Gerätenamen.

Beispiel: Google Pixel 2 XL (8.1.0)
XTC_DEVICE_INDEX Eine Zeichenfolge im Bereich von 0 bis N-1, wobei N die Anzahl der Geräte ist, auf denen der Test ausgeführt wird. Wird in Situationen verwendet, in denen derselbe Test parallel auf mehreren Geräten ausgeführt wird. XTC_DEVICE_INDEX ist für jeden Testlauf für jedes Gerät eindeutig. Weitere Informationen finden Sie unter Behandeln gleichzeitiger Datenbankänderungen während Tests.
XTC_DEVICE_NAME Name des Geräts, auf dem der Test ausgeführt wird.

Beispiel: Google Pixel 2 XL
XTC_DEVICE_OS Name des Betriebssystems für das Gerät, auf dem der Test ausgeführt wird.

Beispiel: 8.1.0
XTC_LANG Sprachcode, der zum Ausführen des Tests verwendet wird.

Beispiel: en
XTC_PLATFORM Getestete Plattform, entweder android oder ios.

Festlegen zusätzlicher Umgebungsvariablen

Wenn Sie Ihre Tests mit der CLI in App Center hochladen, können Sie anfordern, dass Umgebungsvariablen mit der --test-parameter Option festgelegt werden. Umgebungsvariablen können für test Runner und für Ihre Anwendung (die zu test befindliche Anwendung oder AUT) festgelegt werden.

Hinweis

Ausführliche Informationen dazu, welche Frameworks Test- und Anwendungsvariablen in App Center Test unterstützen, finden Sie unter Unterstützung nach Framework .

Umgebungsvariablen für Ihre 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"

Umgebungsvariablen für Ihre Anwendung

$ 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"

Verwenden von Umgebungsvariablen in Ihren Tests

Beispiel-Appium-Testcode:

Der folgende Codeausschnitt zeigt, wie Sie mithilfe von Appium auf Umgebungsvariablen im App Center-Test zugreifen.


String appCenterTest = System.getenv("APP_CENTER_TEST");

Beispiel für Calabash-Testcode:

Der folgende Codeausschnitt zeigt, wie Sie mithilfe von Calabash in App Center Test auf Umgebungsvariablen zugreifen.


app_center_test = ENV["APP_CENTER_TEST"]

Beispieltestcode für Espresso

Da Android keine Umgebungsvariablen unterstützt, legt App Center Test stattdessen Werte für Espresso fest InstrumentationRegistry . Der folgende Codeausschnitt zeigt den Zugriff auf die InstrumentationRegistry Werte.


String appCenterTest = InstrumentationRegistry.getArguments().getString("APP_CENTER_TEST");

Xamarin.UITest-Beispieltestcode

Der folgende Codeausschnitt zeigt, wie Sie mithilfe von Xamarin.UITest in App Center Test auf Umgebungsvariablen zugreifen:

string appCenterTest = Environment.GetEnvironmentVariable("APP_CENTER_TEST");

Verwenden von Umgebungsvariablen in Ihrer Anwendung

Beispiel für nativen Android-Anwendungscode

Hinweis

Ausführliche Informationen dazu, welche Frameworks Anwendungsvariablen im App Center-Test unterstützen, finden Sie unter Unterstützung nach Framework .

Da Android keine Umgebungsvariablen unterstützt, legt App Center Test stattdessen Werte fest InstrumentationRegistry . Der folgende Codeausschnitt zeigt den Zugriff auf die InstrumentationRegistry Werte.


String runningInAppCenter = InstrumentationRegistry.getArguments().getString("RUNNING_IN_APP_CENTER");

Beispiel für nativen iOS-Anwendungscode

Hinweis

Ausführliche Informationen dazu, welche Frameworks Anwendungsvariablen im App Center-Test unterstützen, finden Sie unter Unterstützung nach Framework .

Native iOS-Anwendungen greifen über die NSProcessInfo-API auf Umgebungsvariablen zu.

[[NSProcessInfo processInfo] environment]["RUNNING_IN_APP_CENTER"]

ProcessInfo.processInfo.environment["RUNNING_IN_APP_CENTER"]

Hilfe

Sie können den Support im App Center-Portal kontaktieren. Wählen Sie in der oberen rechten Bildschirmecke das Menü Hilfe (?) und dann "Support kontaktieren" aus. Unser dediziertes Supportteam beantwortet Ihre Fragen.

Wenn Sie Hilfe bei einem Testlauf benötigen, navigieren Sie zum betreffenden Testlauf, kopieren Sie die URL aus Ihrem Browser, und fügen Sie sie in die Supportunterhaltung ein. Eine Testlauf-URL sieht etwa wie https://appcenter.ms/orgs/OrgName/apps/App-Name/test/runs/77a1c67e-2cfb-4bbd-a75a-eb2b4fd0a747folgt aus.