Mavenプロジェクトの設定
既存のJava MavenプロジェクトにKotlinを導入する場合、または新しいKotlin Mavenプロジェクトを作成する場合、KotlinのソースとモジュールをコンパイルするKotlin Mavenプラグインを追加する必要があります。
現在、Maven v3のみがサポートされています。
自動設定
JavaとKotlinの混合プロジェクトおよび純粋なKotlinプロジェクトの両方で、<extensions>オプションを使用してMavenの設定を簡略化できます。このアプローチでは、Mavenコンパイラプラグイン（Maven compiler plugin）を設定する必要がないため、時間を節約できます。
<extensions>を使用してKotlin Mavenプラグインを適用するには、pom.xmlビルドファイルを次のように更新します。
<properties>セクションで、使用するKotlinのバージョンをkotlin.versionプロパティに定義します。xml<properties> <kotlin.version>2.3.0</kotlin.version> </properties><build><plugins>セクションで、<extensions>オプションを有効にしたKotlin Mavenプラグインを追加します。xml<build> <plugins> <!-- Kotlinコンパイラプラグインの設定 --> <plugin> <groupId>org.jetbrains.kotlin</groupId> <artifactId>kotlin-maven-plugin</artifactId> <version>${kotlin.version}</version> <extensions>true</extensions> <!-- 拡張機能を有効化 --> </plugin> <!-- extensionsを使用する場合、Mavenコンパイラプラグインの設定は不要 --> </plugins> </build>
<extensions>オプションは以下を行います：
src/main/kotlinおよびsrc/test/kotlinディレクトリが存在し、プラグイン設定で指定されていない場合に、それらをソースルートとして登録します。- プロジェクトで
kotlin-stdlibへの依存関係がまだ定義されていない場合に、それを追加します。 compile、test-compile、kapt、test-kaptの実行（execution）をビルドに追加し、適切なライフサイクルフェーズにバインドします。そのため、<id>や<goals>を含む<executions>セクションを手動で設定する必要はありません。
JavaとKotlinの混合プロジェクトの場合、この設定により以下が保証されます：
- Kotlinコードが最初にコンパイルされます。
- JavaコードはKotlinの後にコンパイルされ、Kotlinクラスを参照できます。
- デフォルトのMavenの挙動によってプラグインの順序が上書きされることはありません。
拡張機能の設定は<executions>セクション全体を置き換えます。実行（execution）を設定する必要がある場合は、KotlinとJavaソースのコンパイルの例を参照してください。
複数のビルドプラグインがデフォルトのライフサイクルを上書きしており、かつ
<extensions>オプションも有効にしている場合、<build>セクション内の最後のプラグインがライフサイクル設定の優先権を持ちます。それ以前のライフサイクル設定への変更はすべて無視されます。
Mavenコンパイラのバージョンの変更
現在、<extensions>で使用されるMavenコンパイラプラグインのデフォルトバージョンは %mavenExtensionsVersion% です。別のバージョンを個別に設定することもできます：
<build>
<plugins>
<!-- Kotlinコンパイラプラグインの設定 -->
<plugin>
<groupId>org.jetbrains.kotlin</groupId>
<artifactId>kotlin-maven-plugin</artifactId>
<version>${kotlin.version}</version>
<extensions>true</extensions>
</plugin>
<!-- Javaクラス用のMavenコンパイラプラグインの設定 -->
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>%mavenPluginVersion%</version>
</plugin>
</plugins>
</build>手動設定
Kotlin Mavenプラグインで<extensions>を有効にしない場合は、ソースコードが正しくコンパイルされるようにプロジェクトを手動で設定する必要があります。
Mavenプロジェクトを、JavaとKotlinソースの組み合わせまたはKotlinのみのソースをコンパイルするように設定できます。
KotlinとJavaソースのコンパイル
KotlinとJavaの両方のソースファイルがあるプロジェクトをコンパイルするには、Javaコンパイラの前にKotlinコンパイラが実行されるようにする必要があります。
Javaコンパイラは、Kotlinの宣言が.classファイルにコンパイルされるまでそれらを認識できません。JavaコードでKotlinクラスを使用する場合、cannot find symbolエラーを避けるために、それらのクラスを先にコンパイルする必要があります。
Mavenは、主に次の2つの要因に基づいてプラグインの実行順序を決定します：
pom.xmlファイル内でのプラグイン宣言の順序。default-compileやdefault-testCompileなどの組み込みのデフォルト実行。これらは、pom.xmlファイル内での位置に関係なく、常にユーザー定義の実行よりも前に実行されます。
実行順序を制御するには：
maven-compiler-pluginの前にkotlin-maven-pluginを宣言します。- Javaコンパイラプラグインのデフォルトの実行を無効にします。
- コンパイルフェーズを明示的に制御するためにカスタム実行を追加します。
デフォルトの実行を無効にするには、Mavenの特別なフェーズである
noneを使用できます。
Kotlin Mavenプラグインを適用するには、pom.xmlビルドファイルを次のように更新します。
<build>
<plugins>
<!-- Kotlinコンパイラプラグインの設定 -->
<plugin>
<groupId>org.jetbrains.kotlin</groupId>
<artifactId>kotlin-maven-plugin</artifactId>
<version>${kotlin.version}</version>
<executions>
<execution>
<id>kotlin-compile</id>
<phase>compile</phase>
<goals>
<goal>compile</goal>
</goals>
<configuration>
<sourceDirs>
<sourceDir>src/main/kotlin</sourceDir>
<!-- KotlinコードがJavaコードを参照できるようにする -->
<sourceDir>src/main/java</sourceDir>
</sourceDirs>
</configuration>
</execution>
<execution>
<id>kotlin-test-compile</id>
<phase>test-compile</phase>
<goals>
<goal>test-compile</goal>
</goals>
<configuration>
<sourceDirs>
<sourceDir>src/test/kotlin</sourceDir>
<sourceDir>src/test/java</sourceDir>
</sourceDirs>
</configuration>
</execution>
</executions>
</plugin>
<!-- Mavenコンパイラプラグインの設定 -->
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.15.0</version>
<executions>
<!-- デフォルトの実行を無効化 -->
<execution>
<id>default-compile</id>
<phase>none</phase>
</execution>
<execution>
<id>default-testCompile</id>
<phase>none</phase>
</execution>
<!-- カスタム実行を定義 -->
<execution>
<id>java-compile</id>
<phase>compile</phase>
<goals>
<goal>compile</goal>
</goals>
</execution>
<execution>
<id>java-test-compile</id>
<phase>test-compile</phase>
<goals>
<goal>testCompile</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>この設定により、以下が保証されます：
- Kotlinコードが最初にコンパイルされます。
- JavaコードはKotlinの後にコンパイルされ、Kotlinクラスを参照できます。
- デフォルトのMavenの挙動によってプラグインの順序が上書きされることはありません。
Mavenがプラグインの実行をどのように処理するかについての詳細は、Maven公式ドキュメントのGuide to default plugin execution IDsを参照してください。
Kotlinのみのソースのコンパイル
Kotlinソースファイルのみのプロジェクトをコンパイルするには、ソースルートを宣言し、Kotlin Mavenプラグインを設定します。
<build>セクションでソースディレクトリを指定します。xml<build> <sourceDirectory>src/main/kotlin</sourceDirectory> <testSourceDirectory>src/test/kotlin</testSourceDirectory> </build>Kotlin Mavenプラグインが適用されていることを確認します。
xml<build> <plugins> <plugin> <groupId>org.jetbrains.kotlin</groupId> <artifactId>kotlin-maven-plugin</artifactId> <version>${kotlin.version}</version> <executions> <execution> <id>compile</id> <goals> <goal>compile</goal> </goals> </execution> <execution> <id>test-compile</id> <goals> <goal>test-compile</goal> </goals> </execution> </executions> </plugin> </plugins> </build>
JDK 17の使用
JDK 17を使用するには、.mvn/jvm.configファイルに以下を追加します。
--add-opens=java.base/java.lang=ALL-UNNAMED
--add-opens=java.base/java.io=ALL-UNNAMED