Compilar variables de entorno

Importante

Visual Studio App Center está programado para retirarse el 31 de marzo de 2025. Aunque puede seguir usando Visual Studio App Center hasta que se retire por completo, hay varias alternativas recomendadas a las que puede considerar la posibilidad de migrar.

Obtenga más información sobre las escalas de tiempo y las alternativas de soporte técnico.

Las variables de entorno ayudan a administrar las tareas de script de compilación. Puede llamar a variables predefinidas o crear las suyas propias.

Variables predefinidas

Variables generales	Descripción
APPCENTER_BUILD_ID	Identificador único de la compilación actual
APPCENTER_BRANCH	Nombre de la rama a partir de la que se va a crear
APPCENTER_SOURCE_DIRECTORY	Ubicación del código fuente en la máquina de compilación
APPCENTER_OUTPUT_DIRECTORY	Ubicación en la que se almacenan los resultados de la compilación
APPCENTER_TRIGGER	Lo que desencadenó la compilación, fue o manualcontinuous mediante inserción
Específico de iOS
APPCENTER_XCODE_PROJECT	Proyecto Xcode seleccionado
APPCENTER_XCODE_SCHEME	Esquema Xcode seleccionado
Específico de Android
APPCENTER_ANDROID_VARIANT	Variante de Android seleccionada
APPCENTER_ANDROID_MODULE	Módulo android seleccionado
Específico de UWP
APPCENTER_UWP_SOLUTION	Solución seleccionada
APPCENTER_UWP_CONFIGURATION	Configuración seleccionada
Específico de Xamarin
APPCENTER_XAMARIN_PROJECT	Proyecto seleccionado
APPCENTER_XAMARIN_CONFIGURATION	Configuración seleccionada
React Native específico
APPCENTER_REACTNATIVE_PACKAGE	Paquete seleccionado

Variables declaradas en Configuración de compilación

Las variables de entorno personalizadas permiten definir información confidencial necesaria para la compilación sin comprobarlas en el repositorio. Puede crear las variables de entorno en la configuración de compilación y usarlas en la compilación. Por ejemplo, para acceder a una clave de API, un token de webhook u otros secretos.

Nota

'Platform' está reservado para usarse como una variable de entorno.

Cifrado de variables

Los valores de las variables se cifran haciendo clic en el icono de bloqueo, que los ofusca en la configuración de compilación & registros. Los valores cifrados no se pueden editar una vez guardados, pero se pueden eliminar & volver a crear.

Los valores no cifrados se pueden cifrar en cualquier momento.

Acceso a las variables

Las variables de entorno preconfigradas se pueden consumir durante el proceso de compilación. Según el conjunto de herramientas que use, la sintaxis es diferente.

Nota

La manera correcta de consumir variables de entorno depende de la cadena de herramientas usada.

Scripts de compilación

En los scripts de compilación, puede acceder a las variables con la siguiente sintaxis en función de si usa Bash o PowerShell.

• Bash

  $ENVIRONMENT_VARIABLE
  

• PowerShell

  $env:ENVIRONMENT_VARIABLE
  

NuGet.Config para Xamarin o UWP

Si vas a compilar una aplicación de Xamarin o UWP, es posible que quieras conectarte a una fuente NuGet privada, que requiere autenticación. En el NuGet.Config archivo, puede consumir las variables que ha definido. Para más información sobre el uso de credenciales en el NuGet.Config archivo, lea la documentación de referencia.

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

build.gradle (nivel de aplicación) para Android

En el caso de las aplicaciones android, puede acceder a las variables en la configuración build.gradle (nivel de aplicación). Para obtener más información, lea la documentación de Sugerencias y recetas de Gradle .

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