ボットの構成
Xcode サーバ環境変数
Xcode サーバは、統合の一部として実行される実行スクリプトのビルドフェーズ、統合前のトリガー、および統合後のトリガーで使用できるいくつかの組み込み環境変数を定義します。これらの変数のいくつかによって提供される情報は、Xcode サーバ API 要求を行うときに役立ちます。詳細については、Xcode サーバ API リファレンス を参照してください。
組み込みの Xcode サーバ環境変数に加えて、ボットを作成する とき、または ボットを編集する ときに [Arguments(引数)] ペインでカスタム環境変数を定義することもできます。
| 変数 | 説明 | |
| XCS | この変数の値は常に 1 です。スクリプトはこの値をチェックして、Xcode サーバのコンテキストで実行されているかどうかを判断できます。 Xcode 7 以降で使用できます。 | |
| XCS_BOT_NAME | 実行されているボットの名前。 Xcode 7 以降で使用できます。 | |
| XCS_BOT_ID | ボットの ID。ボット ID は、Xcode サーバ API の要求で使用できます。 Xcode 7 以降で使用できます。 | |
| XCS_BOT_TINY_ID | ボット ID の短いバージョン。一部の Xcode サーバ API の要求は、この情報を使用します。 Xcode 7 以降で使用できます。 | |
| XCS_INTEGRATION_ID | 統合の ID。ボット ID は、Xcode サーバ API の要求で使用できます。 Xcode 7 以降で使用できます。 | |
| XCS_INTEGRATION_TINY_ID | 統合 ID の短いバージョン。一部の Xcode サーバ API の要求は、この情報を使用します。 Xcode 7 以降で使用できます。 | |
| XCS_INTEGRATION_NUMBER | 統合が実行された回数。 Xcode 7 以降で使用できます。 | |
| XCS_INTEGRATION_RESULT | 警告、アナライザの警告、成功、テスト失敗、ビルドエラー、キャンセルなど、統合の結果を示す文字列。この変数は、統合後のトリガースクリプトで使用することを目的としています。 Xcode 7 以降で使用できます。 | |
| XCS_SOURCE_DIR | Xcode サーバのソースコードリポジトリを含む最上位ディレクトリ。リポジトリ自体へのパスについては、XCS_PRIMARY_REPO_DIR を参照してください。 Xcode 7 以降で使用できます。 | |
| XCS_OUTPUT_DIR | 統合中にログや製品などを含むリソースが保存される最上位のディレクトリ。 Xcode 7 以降で使用できます。 | |
| XCS_DERIVED_DATA_DIR | 派生データディレクトリ。Xcode サーバは標準以外の場所にビルドするため、このディレクトリはボット固有です。 Xcode 7 以降で使用できます。 | |
| XCS_XCODEBUILD_LOG | 統合中に実行された、xcodebuild コマンドによって生成された出力ファイルへのパス。 Xcode 7 以降で使用できます。 | |
| XCS_ARCHIVE | 統合中にアーカイブが発生した場合の.xarchive ファイルへのパス。 Xcode 7 以降で使用できます。 | |
| XCS_PRODUCT | 統合中に製品がアーカイブからエクスポートされた場合の .app,.ipa, または .package ファイルへのパス。 Xcode 7 以降で使用できます。 | |
| XCS_ERROR_COUNT | 統合中に発生したエラーの総数。 Xcode 7 以降で使用できます。 | |
| XCS_ERROR_CHANGE | 前回の統合以降のエラー数の変化。この値は負になることがあります。 Xcode 7 以降で使用できます。 | |
| XCS_WARNING_COUNT | 統合中に発生した警告の総数。 Xcode 7 以降で使用できます。 | |
| XCS_WARNING_CHANGE | 前回の統合以降の警告数の変化。この値は負の値になることがあります。 Xcode 7 以降で使用できます。 | |
| XCS_ANALYZER_WARNING_COUNT | 統合中に発生した静的アナライザー警告の総数。 Xcode 7 以降で使用できます。 | |
| XCS_ANALYZER_WARNING_CHANGE | 前回の統合以降の静的アナライザー警告数の変化。この値は負の値になることがあります。 Xcode 7 以降で使用できます。 | |
| XCS_TEST_FAILURE_COUNT | 統合中に発生したテスト失敗の総数。 Xcode 7 以降で使用できます。 | |
| XCS_TEST_FAILURE_CHANGE | 前回の統合以降のテスト失敗数の変化。この値は負の値になることがあります。 Xcode 7 以降で使用できます。 | |
| XCS_TESTS_COUNT | 統合によって実行されたテストの総数。 Xcode 7 以降で使用できます。 | |
| XCS_TESTS_CHANGE | 前回の統合以降のテスト数の変化。この値は負の値になることがあります。 Xcode 7 以降で使用できます。 | |
| XCS_THINNED_PRODUCTS_PLIST | エクスポートされた、軽量化された .ipa ファイルとそれに対応するバリアントを記述したプロパティリストファイル (.plist) へのパス。このプロパティリストファイルは、軽量化が実行された場合にのみ存在します。 Xcode 8 以降で使用できます。 | |
| XCS_THINNED_PRODUCTS_PATH | 統合中にエクスポートされた、軽量化された .ipa ファイルを含むディレクトリ。 Xcode 8 以降で使用できます。 | |
| XCS_PRIMARY_REPO_DIR | 統合される Xcode プロジェクトまたはワークスペースのソースコードリポジトリへのパス。Xcode サーバのソースコードリポジトリを含む親ディレクトリについては、XCS_SOURCE_DIR を参照してください。 Xcode 8 以降で使用できます。 | |
| XCS_PRIMARY_REPO_BRANCH | 統合されているプロジェクトまたはワークスペースをチェックアウトするために使用されるプライマリソースコードリポジトリの分岐。分岐をチェックアウトするときにのみ使用されます。 Xcode 8 以降で使用できます。 | |
| XCS_PRIMARY_REPO_TAG | 統合されているプロジェクトまたはワークスペースをチェックアウトするために使用されるプライマリソースコードリポジトリのタグ。タグをチェックアウトするときにのみ使用されます。 Xcode 8 以降で使用できます。 | |
| XCS_PRIMARY_REPO_REVISION | プライマリソースコードリポジトリから統合されているプロジェクトまたはワークスペースをチェックアウトするために使用されるコミットのリモートソース制御リビジョン番号。分岐またはタグをチェックアウトしない場合にのみ使用されます。 Xcode 8 以降で使用できます。 |
以下も見よ