初期セットアップ

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 のインストールディレクトリを検出し、プロパティを設定します。

プロジェクトで最小限の設定を行った場合、次のコマンドで解析を実行します。

gradle jtest -D jtest.home=PATH/TO/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 jtest

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」を参照してください。