環境変数をビルドする

  • [アーティクル]

重要

Visual Studio App Center は、2025 年 3 月 31 日に廃止される予定です。 完全に廃止されるまで Visual Studio App Center を引き続き使用できますが、移行を検討できる推奨される代替手段がいくつかあります。

詳細については、サポートタイムラインと代替手段に関するページを参照してください。

環境変数は 、ビルド スクリプト タスクの管理に役立ちます。 定義済みの変数を呼び出すか、独自の変数を作成できます。

定義済みの変数

一般的な変数 説明
APPCENTER_BUILD_ID 現在のビルドの一意識別子
APPCENTER_BRANCH ビルド元のブランチの名前
APPCENTER_SOURCE_DIRECTORY ビルド マシン上のソース コードの場所
APPCENTER_OUTPUT_DIRECTORY ビルド結果が格納される場所
APPCENTER_TRIGGER ビルドをトリガーしたのは何か、それともmanualcontinuousプッシュによってトリガーされたか

iOS 固有
APPCENTER_XCODE_PROJECT 選択した Xcode プロジェクト
APPCENTER_XCODE_SCHEME 選択した Xcode スキーム

Android 固有
APPCENTER_ANDROID_VARIANT 選択した Android バリアント
APPCENTER_ANDROID_MODULE 選択した Android モジュール

UWP 固有
APPCENTER_UWP_SOLUTION 選択したソリューション
APPCENTER_UWP_CONFIGURATION 選択した構成

Xamarin 固有
APPCENTER_XAMARIN_PROJECT 選択したプロジェクト
APPCENTER_XAMARIN_CONFIGURATION 選択した構成

React Native固有
APPCENTER_REACTNATIVE_PACKAGE 選択したパッケージ

ビルド構成で宣言された変数

カスタム環境変数を使用すると、リポジトリにチェックインせずに、ビルドに必要な機密情報を定義できます。 ビルド構成で環境変数を作成し、ビルドで使用できます。 たとえば、API キー、Webhook トークン、またはその他のシークレットにアクセスする場合などです。

注意

'Platform' は環境変数として使用することから予約されています。

さまざまな状態のカスタム環境変数を示すビルド構成

変数の暗号化

変数の値は、ロック アイコンをクリックして暗号化され、ビルド構成 & ログに難読化されます。 暗号化された値は保存後は編集できませんが、再作成 & 削除できます。

暗号化されていない値は、いつでも暗号化できます。

変数にアクセスする

事前設定された環境変数は、ビルド プロセス中に使用できます。 使用しているツールセットに応じて、構文が異なります。

注意

環境変数を正しく使用する方法は、使用するツールチェーンによって異なります。

ビルド スクリプト

ビルド スクリプトでは、Bash と PowerShell のどちらを使用しているかに応じて、次の構文を使用して変数にアクセスできます。

  • Bash

    $ENVIRONMENT_VARIABLE

  • PowerShell

    $env:ENVIRONMENT_VARIABLE

Xamarin または UWP の NuGet.Config

Xamarin または UWP アプリを構築する場合は、認証が必要なプライベート NuGet フィードに接続できます。 ファイルでは NuGet.Config 、定義した変数を使用できます。 ファイル内 NuGet.Config の資格情報の使用方法の詳細については、 リファレンス ドキュメントを参照してください。

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

Android 用 build.gradle (アプリ レベル)

Android アプリの場合は、 build.gradle (アプリ レベル) 構成で変数にアクセスできます。詳細については、 Gradle のヒントとレシピに関するドキュメントを 参照してください。

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