Mirai Console - Configuring Projects

配置 Mirai Console 项目。

模块说明

console 由后端和前端一起工作. 使用时必须选择一个前端.

mirai-console: Mirai Console 后端。
mirai-console-terminal: 终端前端，适用于 JVM。
MiraiAndroid: Android 应用前端。

选择版本

有关各类版本的区别，参考版本规范

版本类型	版本号
稳定	2.0.0
预览	-
开发

配置项目

请选择以下三种方法之一。

使用模板项目

Mirai 鼓励插件开发者将自己的作品开源，并为此提供了模板项目。

注意，模板项目依赖的 Mirai Console 不一定是最新的。请检查

访问 mirai-console-plugin-template
点击绿色按钮 "Use this template"，创建项目
克隆项目，检查并修改生成的属性

使用 Gradle 插件配置项目

VERSION: 选择版本

若使用 build.gradle.kts:

plugins {
    id("net.mamoe.mirai-console") version "VERSION"
}

若使用 build.gradle:

plugins {
    id 'net.mamoe.mirai-console' version 'VERSION'
}

完成。Mirai Console Gradle 插件会为你配置依赖等所有编译环境。

可以在 README 获取详细的 Gradle 插件使用方法，如配置 mirai-core 版本。

现在你已经配置好了项目，返回开发文档索引

手动配置项目

添加依赖： build.gradle.kts：

repositories {
  jcenter()
}

dependencies {
  compileOnly("net.mamoe:mirai-core:$CORE_VERSION") // mirai-core 的 API
  compileOnly("net.mamoe:mirai-console:$CONSOLE_VERSION") // 后端
  
  testImplementation("net.mamoe:mirai-console-terminal:$CONSOLE_VERSION") // 前端, 用于启动测试
}

之后还需要配置 Kotlin jvm-default 编译参数，Kotlin 和 Java 的编译目标等。
在打包插件时必须将依赖一并打包进插件 JAR，且排除 mirai-core，mirai-console 和它们的间接依赖，否则插件不会被加载。