Membangun variabel Lingkungan

Artikel
03/15/2024

Penting

Visual Studio App Center dijadwalkan untuk dihentikan pada 31 Maret 2025. Meskipun Anda dapat terus menggunakan Visual Studio App Center hingga sepenuhnya dihentikan, ada beberapa alternatif yang direkomendasikan yang dapat Anda pertimbangkan untuk bermigrasi.

Pelajari selengkapnya tentang garis waktu dukungan dan alternatif.

Variabel lingkungan membantu mengelola tugas skrip build Anda. Anda dapat memanggil variabel yang telah ditentukan sebelumnya atau membuat variabel Anda sendiri.

Variabel yang Telah Ditentukan Sebelumnya

Variabel umum	Deskripsi
`APPCENTER_BUILD_ID`	Pengidentifikasi unik untuk build saat ini
`APPCENTER_BRANCH`	Nama cabang yang sedang dibangun
`APPCENTER_SOURCE_DIRECTORY`	Lokasi kode sumber pada komputer build
`APPCENTER_OUTPUT_DIRECTORY`	Lokasi tempat hasil build disimpan di
`APPCENTER_TRIGGER`	Apa yang memicu build, apakah itu `manual` atau `continuous` dengan mendorong
Spesifik iOS
`APPCENTER_XCODE_PROJECT`	Proyek Xcode yang dipilih
`APPCENTER_XCODE_SCHEME`	Skema Xcode terpilih
Spesifik Android
`APPCENTER_ANDROID_VARIANT`	Varian Android yang dipilih
`APPCENTER_ANDROID_MODULE`	Modul Android yang dipilih
Khusus UWP
`APPCENTER_UWP_SOLUTION`	Solusi yang dipilih
`APPCENTER_UWP_CONFIGURATION`	Konfigurasi yang dipilih
Xamarin spesifik
`APPCENTER_XAMARIN_PROJECT`	Proyek yang dipilih
`APPCENTER_XAMARIN_CONFIGURATION`	Konfigurasi yang dipilih
React Native spesifik
`APPCENTER_REACTNATIVE_PACKAGE`	Paket yang dipilih

Variabel yang dideklarasikan dalam Konfigurasi Build

Variabel lingkungan kustom memungkinkan Anda menentukan informasi sensitif yang diperlukan untuk build Anda tanpa memeriksanya ke repositori Anda. Anda dapat membuat variabel lingkungan dalam konfigurasi build dan menggunakannya di build Anda. Misalnya, untuk mengakses kunci API, token webhook, atau rahasia lainnya.

Catatan

'Platform' dicadangkan dari penggunaan sebagai variabel lingkungan.

Konfigurasi build memperlihatkan variabel lingkungan kustom di berbagai status

Mengenkripsi variabel

Nilai variabel dienkripsi dengan mengklik ikon kunci, yang mengaburkannya dalam konfigurasi build & log. Nilai terenkripsi tidak dapat diedit setelah disimpan, tetapi dapat dihapus & dibuat ulang.

Nilai yang tidak dienkripsi dapat dienkripsi kapan saja.

Mengakses variabel

Variabel lingkungan yang telah ditetapkan sebelumnya dapat dikonsumsi selama proses build. Bergantung pada toolset yang Anda gunakan, sintaksnya berbeda.

Catatan

Cara yang benar untuk mengonsumsi variabel lingkungan tergantung pada toolchain yang digunakan.

Membangun skrip

Dalam skrip build, Anda dapat mengakses variabel dengan sintaks berikut tergantung pada apakah Anda menggunakan Bash atau PowerShell.

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

NuGet.Config untuk Xamarin atau UWP

Jika Anda membangun aplikasi Xamarin atau UWP, Anda mungkin ingin terhubung ke umpan NuGet privat, yang memerlukan autentikasi. NuGet.Config Dalam file , Anda dapat menggunakan variabel yang telah Anda tentukan. Untuk detail selengkapnya tentang penggunaan kredensial dalam file Anda NuGet.Config , baca dokumentasi referensi.

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

build.gradle (tingkat aplikasi) untuk Android

Untuk aplikasi Android, Anda dapat mengakses variabel di konfigurasi build.gradle (tingkat aplikasi ). Untuk detail selengkapnya, baca dokumentasi Tips dan Resep Gradle .

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

Bagikan melalui