Compilar variables de entorno

Artigo
03/15/2024

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.

La configuración de compilación que muestra variables de entorno personalizadas en diferentes estados

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

Compartir por