在 Maven 项目中设置仓库与依赖项

对于您的 Kotlin Maven 项目，您可以配置 Maven 在默认的 Maven Central 仓库之外搜索构件的位置，并定义项目所依赖的库。

声明仓库

默认情况下，mavenCentral 仓库对所有 Maven 项目可用。要访问其他仓库中的构件，请在 <repositories> 部分为仓库名称及其 URL 指定自定义 ID：

<repositories>
    <repository>
        <id>spring-repo</id>
        <url>https://repo.spring.io/release</url>
    </repository>
</repositories>

如果您在 Gradle 项目中将 mavenLocal() 声明为仓库，那么在 Gradle 和 Maven 项目之间切换时可能会遇到问题。有关详细信息，请参阅声明仓库。

通常，要添加对库的依赖项，您应该在 <dependencies> 部分声明一个新的 <dependency> 条目：

<dependencies>
    <dependency>
        <groupId>org.jetbrains.kotlinx</groupId>
        <artifactId>kotlinx-serialization-json</artifactId>
        <version>1.9.0</version>
    </dependency>
</dependencies>

设置依赖项

对标准库的依赖

Kotlin 拥有广泛的标准库，供您在应用程序中使用。您可以手动添加标准库依赖项，也可以启用 <extensions> 选项以便在缺失时自动设置。

自动设置

您可以使用 Kotlin Maven 插件提供的 <extensions> 选项来避免手动配置。如果项目中未定义 kotlin-stdlib 依赖项，它会自动添加。例如，当您创建新的 Kotlin Maven 项目或在现有 Java Maven 项目中引入 Kotlin 时。

如果您已经声明了 kotlin-stdlib 依赖项（例如使用了不同的版本），带有 <extensions> 的 Kotlin Maven 插件将不会覆盖它。

您也可以选择退出标准库的自动添加。为此，请在 <properties> 部分添加以下内容：

<project>
    <properties>
        <kotlin.smart.defaults.enabled>false</kotlin.smart.defaults.enabled>         
    </properties>
</project>

此属性不仅会禁用标准库的自动添加，还会禁用源根路径的注册。其他 <extensions> 功能不受影响。

手动配置

要手动将 Kotlin 的标准库添加到您的项目，请使用以下内容更新 pom.xml 文件中的 dependencies 部分：

<dependencies>
    <dependency>
        <groupId>org.jetbrains.kotlin</groupId>
        <artifactId>kotlin-stdlib</artifactId>
        <!-- 使用 <properties/> 中指定的 kotlin.version： --> 
        <version>${kotlin.version}</version>
    </dependency>
</dependencies>

如果您的目标平台是 JDK 7 或 8，且使用的 Kotlin 版本早于：

• 1.8，请分别使用 kotlin-stdlib-jdk7 或 kotlin-stdlib-jdk8。
• 1.2，请分别使用 kotlin-stdlib-jre7 或 kotlin-stdlib-jre8。

对测试库的依赖

如果您的项目使用 Kotlin 反射或测试框架，请添加相关的依赖项。反射库使用 kotlin-reflect，测试库使用 kotlin-test 和 kotlin-test-junit5：

<dependencies>
    <dependency>
        <groupId>org.jetbrains.kotlin</groupId>
        <artifactId>kotlin-reflect</artifactId>
        <version>${kotlin.version}</version>
    </dependency>
    <dependency>
        <groupId>org.jetbrains.kotlin</groupId>
        <artifactId>kotlin-test-junit5</artifactId>
        <scope>test</scope>
    </dependency>
</dependencies>

对 kotlinx 库的依赖

对于 kotlinx 库，您可以添加基础构件名称，也可以添加带有 -jvm 后缀的名称。请参考 klibs.io 上的库 README 文件。

例如，要添加对 kotlinx.coroutines 库的依赖项：

<dependencies>
    <dependency>
        <groupId>org.jetbrains.kotlinx</groupId>
        <artifactId>kotlinx-coroutines-core</artifactId>
        <version>1.10.2</version>
    </dependency>
</dependencies>

要添加对 kotlinx-datetime 库的依赖项：

<dependencies>
    <dependency>
        <groupId>org.jetbrains.kotlinx</groupId>
        <artifactId>kotlinx-datetime-jvm</artifactId>
        <version>0.7.1</version>
    </dependency>
</dependencies>

使用 BOM 依赖机制

要使用 Kotlin 物料清单 (BOM)，请添加对 kotlin-bom 的依赖项：

<dependencyManagement>
    <dependencies>  
        <dependency>
            <groupId>org.jetbrains.kotlin</groupId>
            <artifactId>kotlin-bom</artifactId>
            <version>2.3.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

下一步？

配置 Kotlin 编译器