Ortam değişkenleri oluşturma

  • Makale

Önemli

Visual Studio App Center 31 Mart 2025'te kullanımdan kaldırılıyor. Tamamen kullanımdan kaldırılana kadar Visual Studio App Center'ı kullanmaya devam edebilirsiniz ancak geçiş yapmayı düşünebileceğiniz birkaç önerilen alternatif vardır.

Destek zaman çizelgeleri ve alternatifleri hakkında daha fazla bilgi edinin.

Ortam değişkenleri , derleme betiği görevlerinizi yönetmenize yardımcı olur. Önceden tanımlanmış değişkenleri çağırabilir veya kendi değişkenlerinizi oluşturabilirsiniz.

Önceden Tanımlanmış değişkenler

Genel değişkenler Açıklama
APPCENTER_BUILD_ID Geçerli derlemenin benzersiz tanımlayıcısı
APPCENTER_BRANCH Oluşturulmakta olan dalın adı
APPCENTER_SOURCE_DIRECTORY Derleme makinesindeki kaynak kodun konumu
APPCENTER_OUTPUT_DIRECTORY Derleme sonuçlarının depolandığı konum
APPCENTER_TRIGGER Derlemeyi tetikleyen, veya continuous göndererek olan manual

iOS'a özgü
APPCENTER_XCODE_PROJECT Seçili Xcode projesi
APPCENTER_XCODE_SCHEME Seçili Xcode düzeni

Android'e özgü
APPCENTER_ANDROID_VARIANT Seçili Android varyantı
APPCENTER_ANDROID_MODULE Seçili Android modülü

UWP'ye özgü
APPCENTER_UWP_SOLUTION Seçili çözüm
APPCENTER_UWP_CONFIGURATION Seçili yapılandırma

Xamarin'e özgü
APPCENTER_XAMARIN_PROJECT Seçili proje
APPCENTER_XAMARIN_CONFIGURATION Seçili yapılandırma

Belirli React Native
APPCENTER_REACTNATIVE_PACKAGE Seçili paket

Derleme Yapılandırması'nda bildirilen değişkenler

Özel ortam değişkenleri, deponuzda denetlemeden derlemeniz için gerekli olan hassas bilgileri tanımlamanıza olanak tanır. Ortam değişkenlerinizi derleme yapılandırmasında oluşturabilir ve derlemenizde kullanabilirsiniz. Örneğin, BIR API anahtarına, web kancası belirtecine veya diğer gizli dizilere erişmek için.

Not

'Platform', ortam değişkeni olarak kullanımdan ayrılmıştır.

Farklı durumlardaki özel ortam değişkenlerini gösteren derleme yapılandırması

Değişkenleri şifreleme

Değişkenlerin değerleri kilit simgesine tıklanarak şifrelenir ve bu da bunları derleme yapılandırması & günlüklerinde gizler. Şifrelenmiş değerler kaydedildikten sonra düzenlenemez, ancak yeniden & silinebilir.

Şifrelenmemiş değerler her zaman şifrelenebilir.

Değişkenlere erişme

Önceden ayarlanmış ortam değişkenleri derleme işlemi sırasında kullanılabilir. Kullandığınız araç takımına bağlı olarak söz dizimi farklıdır.

Not

Ortam değişkenlerini kullanmanın doğru yolu, kullanılan araç zincirine bağlıdır.

Betik oluşturma

Derleme betiklerinde, Bash veya PowerShell kullanıp kullanmadığınıza bağlı olarak aşağıdaki söz dizimiyle değişkenlere erişebilirsiniz.

  • Bash

    $ENVIRONMENT_VARIABLE

  • PowerShell

    $env:ENVIRONMENT_VARIABLE

Xamarin veya UWP için NuGet.Config

Xamarin veya UWP uygulaması oluşturuyorsanız, kimlik doğrulaması gerektiren özel bir NuGet akışına bağlanmak isteyebilirsiniz. NuGet.Config dosyasında, tanımladığınız değişkenleri kullanabilirsiniz. Dosyanızdaki NuGet.Config kimlik bilgilerinin kullanımı hakkında daha fazla ayrıntı için başvuru belgelerini okuyun.

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

Android için build.gradle (uygulama düzeyi)

Android uygulamaları için build.gradle (uygulama düzeyi) yapılandırmasında değişkenlerinize erişebilirsiniz. Daha fazla ayrıntı için Gradle İpuçları ve Yemek Tarifleri belgelerini okuyun.

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