生成环境变量
环境变量有助于管理生成 脚本任务。 可以调用预定义的变量或创建自己的变量。
预定义的变量
| 常规变量 | 说明 |
|---|---|
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_VARIABLEPowerShell
$env:ENVIRONMENT_VARIABLE
NuGet.Config Xamarin 或 UWP
如果要生成 Xamarin 或 UWP 应用,可能需要连接到需要身份验证的专用 NuGet 源。 在 NuGet.Config 文件中,可以使用已定义的变量。 有关文件中凭据用法的更多详细信息, NuGet.Config 请阅读 参考文档。
<packageSourceCredentials>
<MyAuthNuget>
<add key="Username" value="%USER_VARIABLE%" />
<add key="ClearTextPassword" value="%PASSWORD_VARIABLE%" />
</MyAuthNuget>
</packageSourceCredentials>
适用于 Android ( 应用) build.gradle
对于 Android 应用,可以在 build.gradle 中访问变量 (应用) 配置。有关更多详细信息,请阅读 Gradle 提示和配方文档。
buildConfigField("String", "API_KEY", "\"${System.env.API_KEY}\"")