ソフトウェアエンジニアリング

JUnit5をテストに使うGradleビルド定義のデフォルト（ gradle init で生成されるもの）は次の様に記述される。

repositories {
    jcenter()
}
dependencies {
    testImplementation 'org.junit.jupiter:junit-jupiter-api:5.6.0'
    testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.6.0'
}
test {
    useJUnitPlatform()
}

gradle testを実行すると、gradleキャッシュに次のJUnit関係ライブラリファイルをダウンロードし実行する。

apiguardian-api-1.1.0.jar
junit-jupiter-api-5.6.0.jar
junit-jupiter-engine-5.6.0.jar
junit-platform-commons-1.6.0.jar
junit-platform-engine-1.6.0.jar
opentest4j-1.2.0.jar

テストは正常に実行された。

警告:不明な列挙型定数ですStatus.STABLE の対処¶

build.gradleに次を追記

  dependencies {
      testImplementation 'org.junit.jupiter:junit-jupiter-api:5.6.2'
+     testCompileOnly 'org.apiguardian:apiguardian-api:1.1.0'
      testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.6.2'
  }

clean して test を実行すると警告は消えた。

テストの実行で ClassNotFoundException(HierarchicalTestEngine)エラーの対処（その１）¶

flatDir で指定したパスにJARファイルを置く場合、依存関係の自動解決はしないので、使用するライブラリをすべてdependenciesに列挙しなくてはならない。

• build.gradleの修正
  

    dependencies {
        testImplementation 'org.junit.jupiter:junit-jupiter-api:5.6.2'
        testCompileOnly 'org.apiguardian:apiguardian-api:1.1.0'
        testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.6.2'
  +     testRuntimeOnly 'org.junit.platform:junit-platform-engine:1.6.2'
  +     testRuntimeOnly 'org.junit.platform:junit-platform-commons:1.6.2'
  +     testRuntimeOnly 'org.opentest4j:opentest4j:1.2.0'
    }
  

テストの実行で ClassNotFoundException(HierarchicalTestEngine)エラーの対処（その２）¶

JUnit5の各ライブラリを1つにまとめたライブラリ junit-platform-console-standalone が提供されている。
使用するライブラリをこれ1つにすればよい。

• build.gradleの修正
  

    dependencies {
  -     testImplementation 'org.junit.jupiter:junit-jupiter-api:5.6.2'
  -     testCompileOnly 'org.apiguardian:apiguardian-api:1.1.0'
  -     testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.6.2'
  +     testImplementation 'org.junit.platform:junit-platform-console-standalone:1.6.2'
    }
  

開発マシンのローカルにJUnit5を配置し、Gradleでユニットテストを実行¶

JUnit5 の配置は、依存関係の記述をシンプルにしたく、JARファイル1つだけ指定すればよいjunit-platform-console-standaloneを使用する。mavenリポジトリの ここから バージョン番号のディレクトリを辿ってJARファイルを入手。

開発マシン（Windows）では、次のフォルダにJARファイルを配置する。
C:\Program Files\Java\junit5\lib\

build.gradle の記述から開発マシン固有の設定を排除するため、gradle プロパティを使う。build.gradle にはプロパティ名を記述、プロパティ名と値（ここでは上述のJARファイル配置パス情報）は開発マシンのユーザーホームディレクトリ下の.gradle/gradle.propertiesに記述する。

• C:\Users\<ユーザー>\.gradle\gradle.properties
  

  library.junit5.dir = C:/Program Files/Java/junit5/lib
  

• build.gradleの記述（リポジトリ定義と依存関係定義箇所）
  

  repositories {
      flatDir {
          dirs "${property('library.junit5.dir')}" 
      }
  }
  
  dependencies {
      testImplementation 'org.junit.platform:junit-platform-console-standalone:1.6.2'
  }
  

プロパティ名の途中にピリオドを使うと、build.gradleの中でプロパティを指定する際、通常の${library.junit5.dir}とすると文字列ではなくメソッド呼び出し式と解釈され意図した通りには展開されない。そこで、上述のflatDirの記述ではpropertyメソッドを明示的に呼びプロパティ名を文字列として渡す。

JUnitを使うときは、gradleのビルド定義に次も記述

test {
    useJUnitPlatform()
}

あとは、gradle test などのタスクを実行する。