生成环境变量

环境变量有助于管理生成 脚本任务。 可以调用预定义的变量或创建自己的变量。

预定义的变量

常规变量 说明
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
    

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