Criar variáveis de ambiente

Artigo
03/15/2024

Importante

O Visual Studio App Center está programado para ser desativado em 31 de março de 2025. Embora você possa continuar a usar o Visual Studio App Center até que ele seja totalmente desativado, há várias alternativas recomendadas para as quais você pode considerar migrar.

Saiba mais sobre linhas do tempo e alternativas de suporte.

As variáveis de ambiente ajudam a gerenciar suas tarefas de script de build. Você pode chamar variáveis predefinidas ou criar suas próprias.

Variáveis predefinidas

Variáveis gerais	Descrição
`APPCENTER_BUILD_ID`	O identificador exclusivo para o build atual
`APPCENTER_BRANCH`	Nome do branch que está sendo criado com base em
`APPCENTER_SOURCE_DIRECTORY`	Local do código-fonte no computador de build
`APPCENTER_OUTPUT_DIRECTORY`	Local em que os resultados do build são armazenados
`APPCENTER_TRIGGER`	O que disparou o build, foi ele `manual` ou `continuous` por push
Específico do iOS
`APPCENTER_XCODE_PROJECT`	Projeto Xcode selecionado
`APPCENTER_XCODE_SCHEME`	Esquema Xcode selecionado
Específico do Android
`APPCENTER_ANDROID_VARIANT`	Variante do Android selecionada
`APPCENTER_ANDROID_MODULE`	Módulo Android selecionado
Específico da UWP
`APPCENTER_UWP_SOLUTION`	Solução selecionada
`APPCENTER_UWP_CONFIGURATION`	Configuração selecionada
Específico do Xamarin
`APPCENTER_XAMARIN_PROJECT`	Projeto selecionado
`APPCENTER_XAMARIN_CONFIGURATION`	Configuração selecionada
React Native específico
`APPCENTER_REACTNATIVE_PACKAGE`	Pacote selecionado

Variáveis declaradas na configuração de build

As variáveis de ambiente personalizadas permitem que você defina informações confidenciais necessárias para seu build sem fazer check-in no repositório. Você pode criar suas variáveis de ambiente na configuração de build e usá-las em seu build. Por exemplo, para acessar uma chave de API, um token de webhook ou outros segredos.

Observação

'Platform' é reservado para uso como uma variável de ambiente.

A configuração de build mostrando variáveis de ambiente personalizadas em diferentes estados

Criptografando variáveis

Os valores das variáveis são criptografados clicando no ícone de bloqueio, o que os ofusca na configuração de build & logs. Os valores criptografados não são editáveis depois de salvos, mas podem ser excluídos & recriados.

Valores não criptografados podem ser criptografados a qualquer momento.

Acessar as variáveis

Variáveis de ambiente predefinidas podem ser consumidas durante o processo de build. Dependendo do conjunto de ferramentas que você está usando, a sintaxe é diferente.

Observação

A maneira correta de consumir variáveis de ambiente depende da cadeia de ferramentas usada.

Scripts de build

Nos scripts de build, você pode acessar as variáveis com a sintaxe a seguir, dependendo se você estiver usando o Bash ou o PowerShell.

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

NuGet.Config para Xamarin ou UWP

Se você estiver criando um aplicativo Xamarin ou UWP, convém se conectar a um feed nuget privado, que requer autenticação. NuGet.Config No arquivo , você pode consumir as variáveis que definiu. Para obter mais detalhes sobre o uso de credenciais em seu NuGet.Config arquivo, leia a documentação de referência.

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

build.gradle (nível do aplicativo) para Android

Para aplicativos Android, você pode acessar suas variáveis na configuração build.gradle (nível do aplicativo ). Para obter mais detalhes, leia a documentação Dicas e Receitas do Gradle .

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

Compartilhar via