2020-02-29 00:31:36 +08:00
# 如何开发Mirai-console插件
2020-02-29 00:18:44 +08:00
####
首先, 你需要一些基础的编程知识<br>
开发插件的下限很低, 仅仅了解开发用的语言即可<br>
当然, 插件开发的上限也很高, Mirai-Console的插件的控制层下至简单的回复逻辑, 上至修改与QQ通讯的协议<br>
目前, Java与Kotlin均可用来开发, 仅需了解任意一门语言, 都可以进行插件开发<br>
2020-02-29 00:31:36 +08:00
### 我没有学习过任何与编程相关的知识或我没有学过这两种语言
2020-02-29 00:18:44 +08:00
你有两个选择，
2020-02-29 13:23:56 +08:00
学习Java/Kotlin的好处: 学习速度相对较快, 学习资料多<br>
2020-02-29 00:31:36 +08:00
学习Kotlin的好处: mirai源开发语言为kotlin, 学习了kotlin可以顺便读懂mirai及其分支项目, 更容易写出更高质量的插件<br>
2020-02-29 00:18:44 +08:00
2020-02-29 00:31:36 +08:00
方法1: 认真读书<br>
[30分钟精通JAVA](https://www.runoob.com/java/java-tutorial.html) 最低只需要学完Java 教程, Java 面向对象两章<br>
[30分钟精通Kotlin](https://www.kotlincn.net/docs/reference/) 最低只需要学完类与对象<br>
2020-02-29 00:18:44 +08:00
2020-02-29 00:31:36 +08:00
方法2: 通过例子边学插件边学语言<br>
需要较高悟性, 不推荐完全没有接触编程的人尝试<br>
## 我需要什么?
### Java环境
2020-02-29 00:36:43 +08:00
JDK是Java语言的软件开发工具包，
推荐安装JDK 11, 最低推荐使用JDK 8来开发Mirai-Console插件。<br>
2020-02-29 00:31:36 +08:00
打开控制台（ ， ； ） ， ：
```$xslt
javac -version
```
返回的应该类似于以下的结果：
```$xslt
javac 1.8.0_60-ea
```
2020-02-29 00:36:43 +08:00
如果类似于以上的结果，
2020-02-29 00:31:36 +08:00
如果返回的版本是1.7.0或者更旧的版本，或者返回的类似于“'javac' 不是内部或外部命令， ，
2020-02-29 00:36:43 +08:00
#### 安装最新版JDK
请打开以下链接下载JDK, 推荐使用稳定的11：
2020-02-29 00:31:36 +08:00
安装过程因系统而异，这里就不详细讲解了。<br>
另外， ，
在windows系统安装jdk后，
2020-02-29 00:36:43 +08:00
#### windows系统中旧版JDK的配置
大部分JDK在安装时已经可以自己配置, 请直接检查是否成功, 如不成功在阅读本块<br>
2020-02-29 00:37:48 +08:00
检查是否配置成功: 点击windows徽标键+R， ， ， ， ，
2020-02-29 00:38:23 +08:00
如果没有, 以下只写了简单流程, 如需要图文帮助可以搜索"windows系统中JDK的配置"<br>
2020-02-29 00:31:36 +08:00
- 右键“计算机”，点击“属性”，<br>
- 在弹出的窗口中点击“高级系统设置”，“环境变量”，<br>
- 点击“系统变量”下面的“新建”， （ ） ， ， （ ） ，
- 在“系统变量”中寻找“Path”（ ） ， ， （ ， ） ：
```$xslt
%JAVA_HOME%\bin;%JAVA_HOME%\jre\bin;
```
这里要注意原来Path的变量值末尾有没有;号，如果没有，先输入;号再输入上面的代码。<br>
点击“系统变量”下面的“新建”， （ ） ， （ ，
```$xslt
.;%JAVA_HOME%\lib;%JAVA_HOME%\lib\tools.jar
```
2020-02-29 00:36:43 +08:00
- 检查是否配置成功。
2020-02-29 00:31:36 +08:00
#### IDE
2020-03-08 23:40:28 +08:00
IDE， ， ， ， ， （ ） ，
强烈推荐IDEA，
2020-02-29 00:36:43 +08:00
<br>
2020-02-29 00:39:24 +08:00
打开[IntelliJ IDEA的官方网站]( http://www.jetbrains.com/idea/)，
<br>
IDEA分付费的Ultimate版和免费的Community版， ， ，
<br>
2020-02-29 00:41:13 +08:00
2020-02-29 00:18:44 +08:00
### 我要如何开始
2020-03-08 23:40:28 +08:00
**此处使用IDEA作为演示IDE**<br>
新手只推荐使用IDEA, 如执着于不使用idea, 可以阅读[PluginStructure](PluginStructure.MD)手动构建插件环境<br>
2020-02-29 00:18:44 +08:00
2020-03-08 23:40:28 +08:00
#### IDE准备
安装idea插件[mirai-console-intellij](https://github.com/mamoe/mirai-console-intellij), 这是一个用于快速创建Mirai Console插件的IDE插件 <br>
1: 自动安装<br>
打开IDEA, 点击Preferences, 点击插件[Plugins], 市场[Market place], 搜索Mirai, 安装Mirai-Console<br>
预计2020/3/11号后才可以在market里搜索到<br>
<br>
2: 手动安装<br>
前往[这里](https://github.com/mamoe/mirai-console-intellij/releases)下载最新的插件[.jar]<BR>
打开IDEA, 点击Preferences, 按下图操作, 选择下载的jar 然后重启IDE<br>
<br>
#### 启动项目
1：
2：
3：
4: 点击[next]<br>
5: 根据下图辅助继续填写信息<br>
6: 点击[next]<br>
7: 最后一页与本地储存位置有关, 如不懂使用默认即可<br>
8: 点击[Finish]稍作等待<br>
9: 等待这个页面加载出来<br>
10: 点击右下↘的Import gradle project或Import Maven Project<br>
11: 等待进度条结束<br>
12: 等待这个页面加载出来(这是第一页选的Java语言, kotlin类似)<br>
13: 插件环境正式完成<br>
#### 如何打包插件
1: 根据下图帮助打开gradle window[maven同理]<br>
2: 根据下图帮助点击JAR<br>
3: 在这里找到成品, 完成<br>
PS: 如果要打包有依赖lib的插件, 请继续向后读<br>
2020-02-29 00:18:44 +08:00
2020-03-08 23:40:28 +08:00
2020-02-29 00:18:44 +08:00
2020-02-29 00:41:13 +08:00
<i>本章部分章节引用自[搭建环境 - Nukkit插件从0开始](https://www.cnblogs.com/xtypr/p/nukkit_plugin_start_from_0_build_environment.html),</i>
2020-02-29 00:31:36 +08:00
