初期セットアップ
Gradle をサポートするために以下が提供されています。
- Jtest Plugin for Gradle –
[INSTALL_DIR]\integration\maven ディレクトリにあるローカルな Maven のリポジトリとともに提供されています。
[INSTALL_DIR]\integration\gradle
ディレクトリにあるスクリプト (jtest.gradle スクリプトおよび init.gradle 初期化スクリプト)
Jtest の場所の設定
jtest.gradle
and init.gradle
スクリプトは、スクリプトの場所を基準として Jtest のインストール ディレクトリを検出し、その場所を jtest.home プロパティに設定します。Jtest Plugin for Gradle は、このプロパティを使用して home パラメーターを設定します。 スクリプトを使用しない場合、またはスクリプトの場所が Jtest のインストール ディレクトリではない場合 (たとえば別の場所にコピーしたり、または別の場所で Jtest を使用する必要がある場合)、次のいずれかの方法で Jtest の場所を設定する必要があります。
- jtest.home プロパティ:次のどちらかのファイルで Jtest インストールディレクトリの場所を指定します。
- $HOME/.gradle/gradle.properties ファイル
- PROJECT_DIR/gradle.properties ファイル
- JTEST_HOME 環境変数: Gradle 2.0 以前 の初期化スクリプトは、initscript コード ブロック内の Java システム プロパティを解決できません。初期化スクリプト
[INSTALL_DIR]
/integration/gradle/init.gradle
は、JTEST_HOME が環境変数として設定されている場合にだけ、事前に構成された Jtest の場所を検出します。
詳細については「Gradle プロパティのタイプ」を参照してください。
Jtest の実行の設定
Jtest Plugin for Gradle を使用する前に、以下のいずれかの .properties ファイルで Jtest のライセンスを設定します。
[INSTALL_DIR]/jtestcli.properties
$HOME/jtestcli.properties
$HOME/.gradle/gradle.properties
[PROJECT_DIR]/gradle.properties
詳細については「ライセンスの設定」および「設定」を参照してください。
コマンドラインでの解析の設定
Jtest に付属の init.gradle
スクリプトを使用すると、既存の Gradle ビルド スクリプトを変更せずに Gradle と統合できます。
-I
オプションを使用してスクリプトの場所を指定し、Gradle で jtest
タスクを実行します。
gradle jtest -I PATH/TO/JTEST/integration/gradle/init.gradle
jtest.home プロパティが指定されていない場合、init.gradle スクリプトはスクリプト自体のディレクトリに基づいて Jtest のインストール ディレクトリを検出し、プロパティを設定します。
ビルドスクリプトでの解析の設定
Gradle と統合するようビルド スクリプトを変更するには、jtest.gradle
スクリプトをビルド スクリプトに適用するか (最小限の設定)、ビルド スクリプトに Jtest タスクを設定すると (拡張設定) します。Jtest による解析の実行は、ビルド スクリプトの設定方法によって異なります。
最小限の設定
Gralde ビルド スクリプトで Jtest Plugin for Gradle を適用するには、ルート プロジェクトのビルド スクリプトに直接 jtest.gradle
スクリプトへのパスを追加します。
//build script blocks apply from: System.properties['jtest.home'] + '/integration/gradle/jtest.gradle' //other build script blocks
jtest.home
プロパティが設定されていない場合、スクリプトはスクリプト自体の場所に基づいて自動的に Jtest のインストールディレクトリを検出し、プロパティを設定します。
拡張設定
[PROJECT_DIR]/gradle.properties
or$HOME/.gradle/gradle.properties
ファイルに jtest.home プロパティを設定します。例:# Java system property 'jtest.home systemProp.jtest.home=PATH/TO/JTEST # project property 'jtest.settings' (could be Java system property as well) jtest.settings=PATH/TO/SETTINGS/FILE
結果として、コマンド ラインでは Jtest のインストール ディレクトリへのパスを指定する必要はありません。
PROJECT_DIR/build.gradle
ビルド スクリプトで Jtest タスクを設定します。例://build script blocks apply from: System.properties['jtest.home'] + '/integration/gradle/jtest.gradle' jtest { config = "builtin://Recommended Rules" showSettings = true resources = [ "**/*.java", "my_project_name/src/**/*.xml" ] compilation { id = "main" //default value override = false //default value encoding = "MacRoman" } } // other build script blocks
Gradle プロパティのタイプ
Gradle は以下の 2 種類のプロパティをサポートします。
Java システム プロパティ
システム プロパティは以下の方法で設定できます。
- コマンド ラインで
-D
パラメーターを使用します(-DmyProperty
) gradle.properties
ファイルでsystemProp
(systemProp.MY_PROPERTY=MY_VALUE
) を使用します
システム プロパティは、System.properties['myProperty']
という形式を使用して Gradle のビルド スクリプトからアクセスできます。
Gradle プロジェクト プロパティ
Gradle プロパティは以下の方法で設定できます。
- コマンドラインで
-P
または -Dorg.gradle.project パラメーターを使用します (-PmyProperty
または-Dorg.gradle.project.myProperty
) gradle.properties
ファイルで
Gradle プロパティは、Gradle ビルド スクリプトで直接名前を使用するか、 property('myProperty')
関数を使用してアクセスできます。
プロパティ キーに文字 "." が含まれている場合、ビルド スクリプトで直接名前を使用するのではなく、
property('myProperty')
を使用してアクセスするべきです。
詳細については Gradle User Manual を参照してください (「System Properties」セクションおよび「Gradle Properties」セクション)。
コンパイル データの手動カスタマイズ
すべてのプロジェクトでコンパイル データを変更する必要がある場合、-Djtest.dataUpdate
コマンド ライン オプションを使用します。
Jtest プラグインが自動的に検出したコンパイル データをカスタマイズする方法については、「Compilation Data Model」を参照してください。