Générer des variables d’environnement

Article
03/15/2024

Important

Visual Studio App Center doit être mis hors service le 31 mars 2025. Bien que vous puissiez continuer à utiliser Visual Studio App Center jusqu’à ce qu’il soit entièrement mis hors service, il existe plusieurs alternatives recommandées vers lesquelles vous pouvez envisager de migrer.

En savoir plus sur les chronologies et les alternatives de support.

Les variables d’environnement vous aident à gérer vos tâches de script de build. Vous pouvez appeler des variables prédéfinies ou créer les vôtres.

Variables prédéfinies

Variables générales	Description
`APPCENTER_BUILD_ID`	Identificateur unique de la build actuelle
`APPCENTER_BRANCH`	Nom de la branche créée à partir de
`APPCENTER_SOURCE_DIRECTORY`	Emplacement du code source sur l’ordinateur de build
`APPCENTER_OUTPUT_DIRECTORY`	Emplacement où les résultats de la build sont stockés dans
`APPCENTER_TRIGGER`	Ce qui a déclenché la build, était-ce `manual` ou `continuous` par push
Spécifique à iOS
`APPCENTER_XCODE_PROJECT`	Projet Xcode sélectionné
`APPCENTER_XCODE_SCHEME`	Schéma Xcode sélectionné
Spécifique à Android
`APPCENTER_ANDROID_VARIANT`	Variante Android sélectionnée
`APPCENTER_ANDROID_MODULE`	Module Android sélectionné
Spécifique à UWP
`APPCENTER_UWP_SOLUTION`	Solution sélectionnée
`APPCENTER_UWP_CONFIGURATION`	Configuration sélectionnée
Spécifique à Xamarin
`APPCENTER_XAMARIN_PROJECT`	Projet sélectionné
`APPCENTER_XAMARIN_CONFIGURATION`	Configuration sélectionnée
React Native spécifique
`APPCENTER_REACTNATIVE_PACKAGE`	Package sélectionné

Variables déclarées dans Build Configuration

Les variables d’environnement personnalisées vous permettent de définir les informations sensibles requises pour votre build sans les vérifier dans votre dépôt. Vous pouvez créer vos variables d’environnement dans la configuration de build et les utiliser dans votre build. Par exemple, pour accéder à une clé API, à un jeton webhook ou à d’autres secrets.

Notes

'Platform' est réservé à l’utilisation en tant que variable d’environnement.

Configuration de build montrant des variables d’environnement personnalisées dans différents états

Chiffrement des variables

Les valeurs des variables sont chiffrées en cliquant sur l’icône de verrou, qui les obfusque dans la configuration de build & journaux. Les valeurs chiffrées ne peuvent pas être modifiées une fois enregistrées, mais elles peuvent être supprimées & recréées.

Les valeurs non chiffrées peuvent être chiffrées à tout moment.

Accéder aux variables

Les variables d’environnement prédéfinies peuvent être consommées pendant le processus de génération. Selon l’ensemble d’outils que vous utilisez, la syntaxe est différente.

Notes

La façon correcte d’utiliser les variables d’environnement dépend de la chaîne d’outils utilisée.

Scripts de génération

Dans les scripts de build, vous pouvez accéder aux variables avec la syntaxe suivante, selon que vous utilisez Bash ou PowerShell.

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

NuGet.Config pour Xamarin ou UWP

Si vous créez une application Xamarin ou UWP, vous pouvez vous connecter à un flux NuGet privé, qui nécessite une authentification. Dans le NuGet.Config fichier, vous pouvez utiliser les variables que vous avez définies. Pour plus d’informations sur l’utilisation des informations d’identification dans votre NuGet.Config fichier, consultez la documentation de référence.

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

build.gradle (niveau application) pour Android

Pour les applications Android, vous pouvez accéder à vos variables dans la configuration build.gradle (au niveau de l’application). Pour plus d’informations, consultez la documentation Conseils et recettes Gradle .

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

Partager via