Freigeben über


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.

Die Buildkonfiguration mit benutzerdefinierten Umgebungsvariablen in verschiedenen Zuständen

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}\"")