Erstellen von Umgebungsvariablen

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 möglicherweise eine Migration in Erwägung ziehen.

Erfahren Sie mehr über Supportzeitpläne und Alternativen.

Umgebungsvariablen helfen beim Verwalten Ihrer Buildskriptaufgaben. Sie können vordefinierte Variablen aufrufen oder eigene Variablen erstellen.

Vordefinierte Variablen

Allgemeine Variablen	Beschreibung
APPCENTER_BUILD_ID	Der eindeutige Bezeichner für den aktuellen Build
APPCENTER_BRANCH	Name des Branchs, aus dem erstellt wird
APPCENTER_SOURCE_DIRECTORY	Speicherort des Quellcodes auf dem Buildcomputer
APPCENTER_OUTPUT_DIRECTORY	Speicherort der Buildergebnisse
APPCENTER_TRIGGER	Was hat den Build ausgelöst, war es manual oder continuous per Push
iOS-spezifisch
APPCENTER_XCODE_PROJECT	Ausgewähltes Xcode-Projekt
APPCENTER_XCODE_SCHEME	Ausgewähltes Xcode-Schema
Android-spezifisch
APPCENTER_ANDROID_VARIANT	Ausgewählte Android-Variante
APPCENTER_ANDROID_MODULE	Ausgewähltes Android-Modul
UWP-spezifisch
APPCENTER_UWP_SOLUTION	Ausgewählte Lösung
APPCENTER_UWP_CONFIGURATION	Ausgewählte Konfiguration
Xamarin-spezifisch
APPCENTER_XAMARIN_PROJECT	Ausgewähltes Projekt
APPCENTER_XAMARIN_CONFIGURATION	Ausgewählte Konfiguration
React Native spezifisch
APPCENTER_REACTNATIVE_PACKAGE	Ausgewähltes Paket

In Buildkonfiguration deklarierte Variablen

Mit benutzerdefinierten Umgebungsvariablen können Sie vertrauliche Informationen definieren, die für Ihren Build erforderlich sind, ohne sie in Ihr Repository zu überprüfen. Sie können Ihre Umgebungsvariablen in der Buildkonfiguration erstellen und in Ihrem Build verwenden. Beispielsweise, um auf einen API-Schlüssel, ein Webhooktoken oder andere Geheimnisse zuzugreifen.

Hinweis

"Platform" ist für die Verwendung als Umgebungsvariable reserviert.

Verschlüsseln von Variablen

Werte von Variablen werden verschlüsselt, indem Sie auf das Sperrsymbol klicken, das sie in der Buildkonfiguration & Protokollen verschleiert. Verschlüsselte Werte können nach dem Speichern nicht mehr bearbeitet werden, sie können jedoch gelöscht & neu erstellt werden.

Unverschlüsselte Werte können jederzeit verschlüsselt werden.

Zugriff auf die Variablen

Vordefinierte Umgebungsvariablen können während des Buildvorgangs verwendet werden. Je nach dem verwendeten Toolset unterscheidet sich die Syntax.

Hinweis

Die richtige Verwendung von Umgebungsvariablen hängt von der verwendeten Toolkette ab.

Buildskripts

In den Buildskripts können Sie mit der folgenden Syntax auf die Variablen zugreifen, je nachdem, ob Sie Bash oder PowerShell verwenden.

• Bash

  $ENVIRONMENT_VARIABLE
  

• PowerShell

  $env:ENVIRONMENT_VARIABLE
  

NuGet.Config für Xamarin oder UWP

Wenn Sie eine Xamarin- oder UWP-App erstellen, sollten Sie eine Verbindung mit einem privaten NuGet-Feed herstellen, der eine Authentifizierung erfordert. In der NuGet.Config Datei können Sie die von Ihnen definierten Variablen nutzen. Weitere Informationen zur Verwendung von Anmeldeinformationen in Ihrer NuGet.Config Datei finden Sie in der Referenzdokumentation.

<packageSourceCredentials>
  <MyAuthNuget>
    <add key="Username" value="%USER_VARIABLE%" />
    <add key="ClearTextPassword" value="%PASSWORD_VARIABLE%" />
  </MyAuthNuget>
</packageSourceCredentials>

build.gradle (App-Ebene) für Android

Für Android-Apps können Sie in der Konfiguration build.gradle (App-Ebene) auf Ihre Variablen zugreifen. Weitere Informationen finden Sie in der Dokumentation zu Tipps und Rezepten von Gradle .

buildConfigField("String", "API_KEY", "\"${System.env.API_KEY}\"")