教程 - 向 Java 项目添加 Kotlin

Maven

要在 Maven 项目中同时使用 Kotlin 和 Java, 请在 pom.xml 文件中应用 Kotlin Maven plugin, 并添加 Kotlin 依赖项:

1. 在 <properties> 部分, 添加 Kotlin 版本属性:

   <properties> <kotlin.version>2.4.0</kotlin.version> </properties>

2. 在 <dependencies> 部分, 向 <plugins> 部分添加所需的依赖项:

   <dependencies> <!-- 向 test 运行期, 添加 JUnit Jupiter 引擎 --> <dependency> <groupId>org.junit.jupiter</groupId> <artifactId>junit-jupiter-engine</artifactId> <scope>test</scope> </dependency> <dependency> <groupId>org.junit.jupiter</groupId> <artifactId>junit-jupiter-params</artifactId> <scope>test</scope> </dependency> </dependencies>

3. 在 <build><plugins> 部分, 添加 Kotlin plugin:

   <build> <pluginManagement><!-- 锁定 plugin 版本, 避免使用 Maven 的默认值 (可以移动到父 pom 文件) --> <!-- 使用 Kotlin 扩展时, 不需要 maven-compiler-plugin --> </plugins> <!-- 对 main 和 test 代码, 启用 Kotlin Maven plugin --> <plugin> <groupId>org.jetbrains.kotlin</groupId> <artifactId>kotlin-maven-plugin</artifactId> <version>${kotlin.version}</version> <extensions>true</extensions> </plugin> </plugins> </build>

   在 Kotlin Maven plugin 中启用 <extensions>true</extensions> 有助于:

   • 向项目自动添加 kotlin-stdlib 依赖项.

   • 配置执行阶段, 先编译 Kotlin, 然后编译 Java.

   • 在 Java 代码中引用 Kotlin 代码, 或者相反.

   • 自动将 JVM 目标版本与 Java 编译器版本对齐.

   使用带有 extensions 的 Kotlin Maven plugin 时, 不需要在 <build><pluginManagement> 部分单独配置 maven-compiler-plugin.

4. 在 IDE 中重新加载 Maven 项目.

5. 运行测试, 验证配置:

   ./mvnw clean test

Gradle

要在 Gradle 项目中同时使用 Kotlin 和 Java, 请在 build.gradle.kts 文件中应用 Kotlin JVM plugin, 并添加 Kotlin 依赖项:

1. 在 plugins {} 代码块中, 添加 Kotlin JVM plugin:

   plugins { // 其他 plugin kotlin("jvm") version "2.4.0" }

2. 设置 JVM 工具链版本, 与你的 Java 版本匹配:

   kotlin { jvmToolchain(17) }

   这个设置会确保 Kotlin 使用与 Java 代码相同的 JDK 版本.

3. 在 dependencies {} 代码块中, 添加 kotlin("test") 库, 这个库提供 Kotlin 测试工具并与 JUnit 集成:

   dependencies { // 其他依赖项 testImplementation(kotlin("test")) // 其他测试依赖项 }

4. 在 IDE 中重新加载 Gradle 项目.

5. 运行测试, 验证配置:

   ./gradlew clean test

参见

• Kotlin 与 Java 互操作的详细文档

• Maven 构建配置参考