建置環境變數

發行項
03/17/2024

重要

Visual Studio App Center 已排定於 2025 年 3 月 31 日淘汰。雖然您可以繼續使用 Visual Studio App Center，直到它完全淘汰為止，但有數個建議您考慮移轉至的建議替代方案。

環境變數可協助您管理組建腳本工作。您可以呼叫預先定義的變數，或建立您自己的變數。

預先定義的變數

一般變數	描述
`APPCENTER_BUILD_ID`	目前組建的唯一標識碼
`APPCENTER_BRANCH`	從中建置的分支名稱
`APPCENTER_SOURCE_DIRECTORY`	建置電腦上的原始碼位置
`APPCENTER_OUTPUT_DIRECTORY`	建置結果儲存所在的位置
`APPCENTER_TRIGGER`	觸發建置、推送 `manual` 或 `continuous` 推送的專案
iOS 特定
`APPCENTER_XCODE_PROJECT`	選取的 Xcode 專案
`APPCENTER_XCODE_SCHEME`	選取的 Xcode 設定
Android 特定
`APPCENTER_ANDROID_VARIANT`	選取的Android變體
`APPCENTER_ANDROID_MODULE`	選取的Android模組
UWP 特定
`APPCENTER_UWP_SOLUTION`	選取的解決方案
`APPCENTER_UWP_CONFIGURATION`	選取的組態
Xamarin 特定
`APPCENTER_XAMARIN_PROJECT`	選取的專案
`APPCENTER_XAMARIN_CONFIGURATION`	選取的組態
特定 React Native
`APPCENTER_REACTNATIVE_PACKAGE`	選取的套件

建置組態中宣告的變數

自定義環境變數可讓您定義組建所需的敏感性資訊，而不需將它們簽入您的存放庫。您可以在組建組態中建立環境變數，並在您的組建中使用它們。例如，若要存取 API 金鑰、Webhook 令牌或其他秘密。

注意

'Platform' 會保留為環境變數使用。

顯示不同狀態自定義環境變數的組建組態

加密變數

藉由單擊鎖定圖示來加密變數的值，這會在建置組態 & 記錄中混淆這些變數。一旦儲存加密值，就無法編輯這些值，但可以在重新建立 & 刪除這些值。

非加密的值可以隨時加密。

存取變數

預先設定的環境變數可以在建置程式期間取用。根據您使用的工具組而定，語法會有所不同。

注意

取用環境變數的正確方式取決於所使用的工具鏈。

組建指令碼

在建置腳本中，您可以根據您使用Bash或PowerShell來存取具有下列語法的變數。

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

適用於 Xamarin 或 UWP 的 NuGet.Config

如果您要建置 Xamarin 或 UWP 應用程式，您可能想要連線到需要驗證的私人 NuGet 摘要。在檔案中 NuGet.Config ，您可以取用您已定義的變數。如需檔案中 NuGet.Config 認證使用方式的詳細資訊，請參閱參考檔。

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

build.gradle (Android 應用程式層級)

針對 Android 應用程式，您可以在 build.gradle (應用程式層級) 組態中存取變數。如需詳細資訊，請參閱 Gradle 秘訣和配方檔。

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

共用方式為