Переменные среды сборки

Статья
07/19/2023

Важно!

Прекращение поддержки Центра приложений Visual Studio запланировано на 31 марта 2025 г. Хотя вы можете продолжать использовать Центр приложений Visual Studio до полного прекращения его использования, существует несколько рекомендуемых вариантов, на которые можно перейти.

Узнайте больше о сроках поддержки и альтернативных вариантах.

Переменные среды помогают управлять задачами скрипта сборки. Можно вызвать предварительно определенные переменные или создать собственные.

Предопределенные переменные

Общие переменные	Описание
`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, маркеру веб-перехватчика или другим секретам.

Примечание

"Платформа" зарезервирована от использования в качестве переменной среды.

Конфигурация сборки, показывающая пользовательские переменные среды в разных состояниях

Шифрование переменных

Значения переменных шифруются, щелкнув значок блокировки, который скрывает их в & журналах конфигурации сборки. Зашифрованные значения нельзя изменить после сохранения, но их можно удалить & повторного создания.

Незашифрованные значения могут быть зашифрованы в любое время.

Доступ к переменным

Предварительно заданные переменные среды можно использовать в процессе сборки. В зависимости от используемого набора инструментов синтаксис отличается.

Примечание

Правильный способ использования переменных среды зависит от используемой цепочки инструментов.

Скрипты сборки

В скриптах сборки можно получить доступ к переменным с помощью следующего синтаксиса в зависимости от того, используете ли вы 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>

build.gradle (уровень приложения) для Android

Для приложений Android доступ к переменным можно получить в конфигурации build.gradle (уровень приложения). Дополнительные сведения см. в документации по советам и рецептам Gradle .

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

Поделиться через