Udostępnij za pośrednictwem

Kompilowanie zmiennych środowiskowych

  • Artykuł

Ważne

Program Visual Studio App Center ma zostać wycofany 31 marca 2025 r. Mimo że możesz nadal używać programu Visual Studio App Center do momentu jej pełnego wycofania, istnieje kilka zalecanych alternatyw, do których można rozważyć migrację.

Dowiedz się więcej o osiach czasu pomocy technicznej i alternatywach.

Zmienne środowiskowe ułatwiają zarządzanie zadaniami skryptów kompilacji. Możesz wywołać wstępnie zdefiniowane zmienne lub utworzyć własne.

Zmienne wstępnie zdefiniowane

Zmienne ogólne Opis
APPCENTER_BUILD_ID Unikatowy identyfikator bieżącej kompilacji
APPCENTER_BRANCH Nazwa gałęzi tworzonej na podstawie
APPCENTER_SOURCE_DIRECTORY Lokalizacja kodu źródłowego na maszynie kompilacji
APPCENTER_OUTPUT_DIRECTORY Lokalizacja, w której są przechowywane wyniki kompilacji
APPCENTER_TRIGGER Co wyzwoliło kompilację, było to manual lub continuous przez wypchnięcie

Specyficzny dla systemu iOS
APPCENTER_XCODE_PROJECT Wybrany projekt Xcode
APPCENTER_XCODE_SCHEME Wybrany schemat Xcode

Specyficzny dla systemu Android
APPCENTER_ANDROID_VARIANT Wybrany wariant systemu Android
APPCENTER_ANDROID_MODULE Wybrany moduł systemu Android

Specyficzny dla platformy UWP
APPCENTER_UWP_SOLUTION Wybrane rozwiązanie
APPCENTER_UWP_CONFIGURATION Wybrana konfiguracja

Specyficzne dla platformy Xamarin
APPCENTER_XAMARIN_PROJECT Wybrany projekt
APPCENTER_XAMARIN_CONFIGURATION Wybrana konfiguracja

React Native specyficzny
APPCENTER_REACTNATIVE_PACKAGE Wybrany pakiet

Zmienne zadeklarowane w konfiguracji kompilacji

Niestandardowe zmienne środowiskowe umożliwiają definiowanie poufnych informacji wymaganych do kompilacji bez ich sprawdzania w repozytorium. Zmienne środowiskowe można utworzyć w konfiguracji kompilacji i użyć ich w kompilacji. Aby na przykład uzyskać dostęp do klucza interfejsu API, tokenu elementu webhook lub innych wpisów tajnych.

Uwaga

"Platforma" jest zarezerwowana z użycia jako zmienna środowiskowa.

Konfiguracja kompilacji przedstawiająca niestandardowe zmienne środowiskowe w różnych stanach

Szyfrowanie zmiennych

Wartości zmiennych są szyfrowane, klikając ikonę blokady, która zaciemnia je w konfiguracji kompilacji & dzienników. Zaszyfrowane wartości nie są edytowalne po ich zapisaniu, ale można je usunąć & ponownie utworzone.

Wartości nieszyfrowane można szyfrować w dowolnym momencie.

Uzyskiwanie dostępu do zmiennych

Wstępnie ustawione zmienne środowiskowe można używać podczas procesu kompilacji. W zależności od używanego zestawu narzędzi składnia jest inna.

Uwaga

Prawidłowy sposób korzystania ze zmiennych środowiskowych zależy od używanego łańcucha narzędzi.

Skrypty kompilacji

W skryptach kompilacji możesz uzyskać dostęp do zmiennych przy użyciu następującej składni w zależności od tego, czy używasz powłoki Bash, czy programu PowerShell.

  • Bash

    $ENVIRONMENT_VARIABLE

  • Program PowerShell

    $env:ENVIRONMENT_VARIABLE

NuGet.Config dla platformy Xamarin lub platformy UWP

Jeśli tworzysz aplikację platformy Xamarin lub platformy UWP, możesz nawiązać połączenie z prywatnym źródłem danych NuGet, które wymaga uwierzytelniania. NuGet.Config W pliku możesz użyć zdefiniowanych zmiennych. Aby uzyskać więcej informacji na temat użycia poświadczeń w NuGet.Config pliku, zapoznaj się z dokumentacją referencyjną.

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

build.gradle (poziom aplikacji) dla systemu Android

W przypadku aplikacji systemu Android możesz uzyskać dostęp do zmiennych w konfiguracji build.gradle (poziom aplikacji). Aby uzyskać więcej informacji, zapoznaj się z dokumentacją Gradle Tips and Recipes .

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