Sestavení proměnných prostředí

Článek
03/15/2024

Důležité

31. března 2025 je naplánované vyřazení z provozu. I když můžete dál používat Visual Studio App Center, dokud ho úplně vyřadíte, existuje několik doporučených alternativ, na které můžete zvážit migraci.

Přečtěte si další informace o časových osách a alternativách podpory.

Proměnné prostředí pomáhají spravovat úlohy skriptů sestavení. Můžete volat předdefinované proměnné nebo vytvořit vlastní.

Předdefinované proměnné

Obecné proměnné	Popis
`APPCENTER_BUILD_ID`	Jedinečný identifikátor aktuálního sestavení
`APPCENTER_BRANCH`	Název větve, ze které se sestavuje
`APPCENTER_SOURCE_DIRECTORY`	Umístění zdrojového kódu na počítači sestavení
`APPCENTER_OUTPUT_DIRECTORY`	Umístění, ve kterém jsou uloženy výsledky sestavení
`APPCENTER_TRIGGER`	Co aktivovalo sestavení, bylo to `manual` , nebo `continuous` nasdílení změn
Specifické pro iOS
`APPCENTER_XCODE_PROJECT`	Vybraný projekt Xcode
`APPCENTER_XCODE_SCHEME`	Vybrané schéma Xcode
Specifické pro Android
`APPCENTER_ANDROID_VARIANT`	Vybraná varianta Androidu
`APPCENTER_ANDROID_MODULE`	Vybraný modul pro Android
Specifické pro UPW
`APPCENTER_UWP_SOLUTION`	Vybrané řešení
`APPCENTER_UWP_CONFIGURATION`	Vybraná konfigurace
Specifické pro Xamarin
`APPCENTER_XAMARIN_PROJECT`	Vybraný projekt
`APPCENTER_XAMARIN_CONFIGURATION`	Vybraná konfigurace
React Native specifické
`APPCENTER_REACTNATIVE_PACKAGE`	Vybraný balíček

Proměnné deklarované v konfiguraci sestavení

Vlastní proměnné prostředí umožňují definovat citlivé informace, které jsou potřeba pro sestavení, aniž byste je museli sestavovat v úložišti. Proměnné prostředí můžete vytvořit v konfiguraci sestavení a použít je v sestavení. Například pro přístup ke klíči rozhraní API, tokenu webhooku nebo jiným tajným kódům.

Poznámka

Platforma je vyhrazena pro použití jako proměnnou prostředí.

Konfigurace sestavení zobrazující vlastní proměnné prostředí v různých stavech

Šifrování proměnných

Hodnoty proměnných se šifrují kliknutím na ikonu zámku, která je zamění v konfiguraci sestavení & protokolech. Šifrované hodnoty se po uložení nedají upravit, ale dají se odstranit & znovu vytvořit.

Nešifrované hodnoty je možné kdykoli zašifrovat.

Přístup k proměnným

Během procesu sestavení je možné využívat předem nastavené proměnné prostředí. V závislosti na používané sadě nástrojů se syntaxe liší.

Poznámka

Správný způsob využívání proměnných prostředí závisí na použité sadě nástrojů.

Sestavení skriptů

Ve skriptech sestavení můžete přistupovat k proměnným s následující syntaxí v závislosti na tom, jestli používáte Bash nebo PowerShell.

Bash
```
$ENVIRONMENT_VARIABLE
```
PowerShell
```
$env:ENVIRONMENT_VARIABLE
```

NuGet.Config pro Xamarin nebo UPW

Pokud vytváříte aplikaci pro Xamarin nebo UPW, můžete se chtít připojit k privátnímu informačnímu kanálu NuGet, který vyžaduje ověření. NuGet.Config V souboru můžete využívat proměnné, které jste definovali. Další podrobnosti o používání přihlašovacích údajů v souboru najdete v NuGet.Configreferenční dokumentaci.

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

build.gradle (úroveň aplikace) pro Android

U aplikací pro Android máte přístup k proměnným v konfiguraci build.gradle (úroveň aplikace). Další podrobnosti najdete v dokumentaci Gradle Tipy a recepty .

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

Sdílet prostřednictvím