Variabili di ambiente di compilazione

Articolo
03/15/2024

Importante

Visual Studio App Center è pianificato per il ritiro il 31 marzo 2025. Anche se è possibile continuare a usare Visual Studio App Center fino a quando non viene completamente ritirato, esistono diverse alternative consigliate a cui è possibile prendere in considerazione la migrazione.

Altre informazioni sulle sequenze temporali di supporto e sulle alternative.

Le variabili di ambiente consentono di gestire le attività di script di compilazione. È possibile chiamare variabili predefinite o crearne di personalizzate.

Variabili predefinite

Variabili generali	Descrizione
`APPCENTER_BUILD_ID`	Identificatore univoco per la compilazione corrente
`APPCENTER_BRANCH`	Nome del ramo da cui viene creato
`APPCENTER_SOURCE_DIRECTORY`	Posizione del codice sorgente nel computer di compilazione
`APPCENTER_OUTPUT_DIRECTORY`	Posizione in cui vengono archiviati i risultati della compilazione
`APPCENTER_TRIGGER`	Che cosa ha attivato la compilazione, è stato `manual` o `continuous` tramite push
Specifico di iOS
`APPCENTER_XCODE_PROJECT`	Progetto Xcode selezionato
`APPCENTER_XCODE_SCHEME`	Schema Xcode selezionato
Android specifico
`APPCENTER_ANDROID_VARIANT`	Variante Android selezionata
`APPCENTER_ANDROID_MODULE`	Modulo Android selezionato
Specifica della piattaforma UWP
`APPCENTER_UWP_SOLUTION`	Soluzione selezionata
`APPCENTER_UWP_CONFIGURATION`	Configurazione selezionata
Specifica di Xamarin
`APPCENTER_XAMARIN_PROJECT`	Progetto selezionato
`APPCENTER_XAMARIN_CONFIGURATION`	Configurazione selezionata
React Native specifico
`APPCENTER_REACTNATIVE_PACKAGE`	Pacchetto selezionato

Variabili dichiarate nella configurazione di compilazione

Le variabili di ambiente personalizzate consentono di definire informazioni riservate necessarie per la compilazione senza controllarle nel repository. È possibile creare le variabili di ambiente nella configurazione di compilazione e usarle nella compilazione. Ad esempio, per accedere a una chiave API, a un token webhook o ad altri segreti.

Nota

'Platform' è riservato dall'uso come variabile di ambiente.

Configurazione di compilazione che mostra variabili di ambiente personalizzate in diversi stati Variabili di

Crittografia delle variabili

I valori delle variabili vengono crittografati facendo clic sull'icona di blocco, che li offusca nella configurazione della compilazione & log. I valori crittografati non sono modificabili dopo il salvataggio, ma possono essere eliminati & ricreazione.

I valori non crittografati possono essere crittografati in qualsiasi momento.

Accedere alle variabili

Le variabili di ambiente preconfigurate possono essere utilizzate durante il processo di compilazione. A seconda del set di strumenti in uso, la sintassi è diversa.

Nota

Il modo corretto per utilizzare le variabili di ambiente dipende dalla toolchain usata.

Script di compilazione

Negli script di compilazione è possibile accedere alle variabili con la sintassi seguente a seconda che si usi Bash o PowerShell.

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

NuGet.Config per Xamarin o UWP

Se si sta creando un'app Xamarin o UWP, è possibile connettersi a un feed NuGet privato, che richiede l'autenticazione. NuGet.Config Nel file è possibile usare le variabili definite. Per altre informazioni sull'utilizzo delle credenziali nel NuGet.Config file, vedere la documentazione di riferimento.

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

build.gradle (livello app) per Android

Per le app Android, è possibile accedere alle variabili nella configurazione build.gradle (a livello di app). Per altre informazioni, vedere la documentazione di Gradle Tips and Recipes (Suggerimenti e ricette gradle ).

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

Condividi tramite