Kotlin Multiplatform 中如何使用 Java 库？-java教程-PHP中文网

Kotlin Multiplatform 中如何使用 Java 库？

kotlin multiplatform 支持大部分标准 java 库（如 junit、mockito、guava），但受限于目标平台（尤其是 ios/native 和 js）及 jvm 特性（如反射），部分 java api 无法跨平台使用；需参考官方兼容性指南并优先采用 kotlin 原生替代方案。

kotlin multiplatform 支持大部分标准 java 库（如 junit、mockito、guava），但受限于目标平台（尤其是 ios/native 和 js）及 jvm 特性（如反射），部分 java api 无法跨平台使用；需参考官方兼容性指南并优先采用 kotlin 原生替代方案。

在 Kotlin Multiplatform（KMP）项目中，能否复用现有 Java 库是许多从 JVM 迁移的开发者关心的核心问题。答案是：可以，但有明确边界。

✅ 支持的场景：

在 JVM 依赖项（jvmMain） 中，可直接引入绝大多数 Maven 上发布的 Java 库（如 com.google.guava:guava、org.junit.jupiter:junit-jupiter），语法与纯 Kotlin/JVM 项目完全一致：
```
// build.gradle.kts (in jvmMain source set)
dependencies {
  implementation("com.google.guava:guava:33.2.1-jre")
}
```
部分库（如 Mockito）还提供了 KMP 兼容的封装版本（如 mockito-kotlin），推荐优先选用以保障多平台一致性。

❌ 不支持或受限的场景：

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

跨平台共享代码（commonMain）中不可直接使用 Java 类：Java 是 JVM 专属语言，其字节码无法被 Kotlin/Native（iOS/macOS）或 Kotlin/JS 编译器识别。
JVM 特有机制失效：例如 java.lang.reflect.*、java.beans.*、javax.*（除少数 Jakarta EE 适配模块外）在非 JVM 目标上不可用。
*Android 专用类（如 `android.）或 Swing/AWT 等 GUI 库**：仅限androidMain或jvmMain，无法出现在commonMain` 中。

? 最佳实践建议：

分层隔离：将 Java 依赖严格限定在 jvmMain 或 androidMain 中，commonMain 仅暴露抽象接口（如 interface NetworkClient），由各平台提供具体实现。
查阅兼容性清单：Kotlin 官方维护了 Multiplatform 兼容性指南，明确标注了已弃用的旧模式（Legacy Mode）及受支持的库范围。
优先 Kotlin 原生替代：对新功能开发，选用 KMP 友好库（如 kotlinx.coroutines 替代 java.util.concurrent 扩展、kotlinx.serialization 替代 Jackson/Gson）。