Mirai框架qq机器人教程

0.前言
1. 安装Java
2.安装Mirai启动器
3.下载IDEA或其他编译器
4.创建mirai-console插件项目
- 4.1 通过git创建
- 4.2 通过插件创建项目
5.解决代码报错
6. miraiOK结构
7.mirai 旧版kotlin代码例子解析
8.官方开发文档
9. 一个简单的kotlin例子
10. 用gradle生成插件文件（.jar）
11.在mirai中已有的一些插件
一些tips

本教程代码部分已经过时，为2.0-M1版！！！
请阅读新版2.0-M2版的教程
或
官方的框架教程官方启动器教程

0.前言

~~目前mirai项目官方已经停止维护并且好像删库了？~~ 但是由于其开源性质，有很多clone的库在github上
c++版github地址:点我

kotlin版github地址:点我

c++版教程csdn:点我
温馨提示：请勿使用qq机器人做非法的事情

1. 安装Java

最低1.8，推荐15
推荐下载openjdk而不是甲骨文的，不然mirai-console-loader会报错

自行百度(以后如果有时间回来补教程)
记得配置环境变量
如何检测成功安装: 按Win+R>输入cmd 然后回车-> 输入java -version
openjdk15

2.安装Mirai启动器

mirai目前启动器有2个(详情)

MiraiOk是一个安装MiraiOK的一键安装包
最新官方及全版本Github下载地址（里面readme.md里面有下载整合包地址）(最近github下载好像提速了，我就不另外传到国内网盘了，如有需要评论区说）
推荐用mirai-console-loader

本文作者windows版本备份(使用旧框架的miraiok和新框架的mirai-console-loader)

3.下载IDEA或其他编译器

从搜索引擎搜索官网进去下载
或者用其他编辑器也可以

4.创建mirai-console插件项目

该插件可以让你快速生成mirai项目
Step1: 在IDEA中按快捷键ctrl+alt+s或者点击File->Setting
Step2: 找到里面的Plugin
Step3: 在Marketplace里面搜索Mirai和Kotlin 安装

但是，笔者在IDEA 2020.2版本中无法安装插件或新建项目没mirai的项目，如果有这种情况，有3种解决方法

到笔者的库下载生成好的项目，并自己修改信息(旧版的kotlin框架)
感谢网友提醒，这种情况下也可以手动下载插件然后导入插件从而安装
github下载地址
用官方提供的例子(新的kotlin框架)

4.1 通过git创建

如果是用github上的项目创建，那就从github上下载，然后用IDE打开整个文件夹就好了

4.2 通过插件创建项目

Step1 就像正常创建项目一样,File->New->Project

Step2 选mirai-console，这里随便填（不知道的尽量不改，推荐语言kotlin，博主搞了半天的java版还是没用）然后next
创建step2
Step3 两个id随便写，包管理器建议这样配置，然后next
Step3
Step4 随意
step4

5.解决代码报错

如图创建项目好后会呈现这样子

这个时候你们的代码会报错，显示找不到包，这是gradle依赖出问题了
请自行到上方有写的作者储存库里复制build.gradle的内容并忽略以下内容
Step1 打开build.gradle
~~添加和删除如图，其他不变~~

implementation(“net.mamoe:mirai-core-qqandroid:1.1.3”)
compile fileTree(dir:’/jars/’,includes: [’*.jar’])

gradle
Step2 在根目录下创建jars文件夹，如图
jars
Step3 把miraiok下的content下的第一个.jar文件复制到jars文件夹下，如图
.jar
copy

然后就解决了。

6. miraiOK结构

miraiok
从上往下依次是
开发SDK（也就是依赖库）
jre1.8.0_252 也就是java运行环境
不知道干什么的空文件夹
运行日志
插件目录（gradle生成jar后复制到这）
不知道干什么的空文件，应该是控制版本
不知道干什么的xml文件
配置文件
虚拟设备信息（qq协议用）
一个库
主程序（点击运行机器人）

7.mirai 旧版kotlin代码例子解析

reply即为回复方法，如
"HI" reply("X")
与

if(message.toString()=="HI")reply("X")

一个道理

8.官方开发文档

Github点击查看
 码云点击查看

9. 一个简单的kotlin例子

github查看地址
 码云

10. 用gradle生成插件文件（.jar）

Step1 点击侧边栏的gradle

Step2 双击jar任务
jar
Step3 在lib目录下找到.jar文件 jar
Step4 把这个jar文件复制到miraiok的plugins目录下
ps：这个文件夹是运行后生成的
plugins
Step5 运行mirai