本文介绍如何在一个 JVM 项目中使用 mirai。
有关各类版本的区别,参考 版本规范
版本类型 | 版本号 |
---|---|
稳定 | 2.1.0 |
预览 | - |
开发 |
- 如果你熟悉 Gradle,只需要添加
jcenter
仓库和依赖net.mamoe:mirai-core:VERSION
即可而不需要继续阅读。下文将详细解释其他方法。 - 如果你熟悉 Maven,只需要添加
jcenter
仓库和依赖net.mamoe:mirai-core-jvm:VERSION
即可而不需要继续阅读。下文将详细解释其他方法。
本文提供如下三种配置方法,但推荐使用 Gradle 构建。
在 build.gradle.kts
添加:
plugins {
kotlin("jvm") version "1.4.21" // 请确保添加 Kotlin,至少使用 1.4.0 版本
}
repositories {
jcenter()
}
dependencies {
api("net.mamoe", "mirai-core", "2.1.0") // 替换为你需要的版本号
}
注意,必须添加 Kotlin 插件才能正确获取 mirai 软件包。
依赖配置完成,请选择:
在 build.gradle
添加
plugins {
id 'org.jetbrains.kotlin.jvm' version '1.4.21' // 请确保添加 Kotlin,至少使用 1.4.0 版本
}
repositories {
jcenter()
}
dependencies {
api('net.mamoe', 'mirai-core', '2.1.0') // 替换为你需要的版本号
}
依赖配置完成,请选择:
mirai 在开发时需要 net.mamoe:mirai-core-api
, 在运行时需要 net.mamoe:mirai-core
。可以在开发和编译时只依赖 mirai-core-api
,会减轻对 IDE 的负担。
dependencies {
val miraiVersion = "2.1.0" // 替换为你需要的版本号
api("net.mamoe", "mirai-core-api", miraiVersion) // 编译代码使用
runtimeOnly("net.mamoe", "mirai-core", miraiVersion) // 运行时使用
}
在 pom.xml
中:
<repositories>
<repository>
<id>jcenter</id>
<url>https://jcenter.bintray.com/</url>
</repository>
</repositories>
<dependencies>
<dependency>
<groupId>net.mamoe</groupId>
<artifactId>mirai-core-jvm</artifactId>
<version>2.1.0</version> <!-- 替换版本为你需要的版本 -->
</dependency>
</dependencies>
通常 mirai 可以直接使用。但 mirai 使用的 Kotlin 1.4 可能与你的项目使用的其他库依赖的 Kotlin 版本冲突,Maven 无法正确处理这种冲突。此时请手动添加 Kotlin 标准库依赖。
<properties>
<kotlin.version>1.4.20</kotlin.version>
</properties>
<dependencies>
<dependency>
<groupId>org.jetbrains.kotlin</groupId>
<artifactId>kotlin-stdlib-jdk8</artifactId>
<version>${kotlin.version}</version>
</dependency>
</dependencies>
可以在 Kotlin 官方文档 获取更多有关配置 Kotlin 的信息。
依赖配置完成,回到 Mirai 文档索引
非常不推荐这种方法,请尽可能使用构建工具。
在 Jcenter 或 阿里云代理仓库 下载指定版本的 -all.jar
文件,即包含 mirai-core
,mirai-core-api
,mirai-core-utils
和其他依赖。