易语言Note:酷Q插件开发起航
1、酷Q Air下载
官方提供了两个版本,Pro版、Air版,这跟电脑出版是一个道理,你可以自行在官网下载需要的版本,我下载的酷Q Air版本,因为这个版本是免费的,当然,这就可以肯定了官方会限制你使用的API函数,不过Air提供的我们是够用的,这里还是提供下载网站。
2、酷Q Air目录介绍
- app:插件目录
- bin:酷Q允许的主要目录(不要动这里面的文件就可以了)
- conf:配置文件(不要动这里面的文件就可以了)
- data:你的用户信息以及log(可以根据自己需要做清理)
- dev:打开了开发者模式,才会出现的目录
- CQA.exe:这个是运行文件
3、开启开发者模式
登录酷Q后,点击“应用”->“应用管理”,再就看图行事了!!!
配图羽:
注意:
登录酷Q,你需要一个QQ号,这个QQ而且没有任何安全保护的,如没有绑定手机、没有安全锁等;
4、开发文件准备
做为开发者你需要准备好这两个文件app.json与app.dll,而且这两个文件是对应的,下面介绍下如何得到这两个文件:
- 下载官网提供的SDK文件,这里我就直接提供下载链接给你,解压如下:
目录介绍
- com.~:这类文件是官方提供Demo文件
- CQPAppSdk .ec:是官方提供的模板文件,该文件中包含你能操作的API函数。
- 打开com.~文件可以找我们需要的第一个文件app.json文件,我们以com.example.demo下的app.json为例。
// 酷Q 的Json文件支持以 // 开头的注释。
// 开发模式下,应用的 app.dll, app.json 的文件须放在 dev/[appid]/ 目录下,应用 AppInfo 函数返回的内容须改为 appid
// 如 appid=com.example.demo, 则dll及json文件需分别放在 dev/com.example.demo/app.dll、dev/com.example.demo/app.json
{"ret":1, // 返回码,固定为1"apiver":9, // Api版本,本SDK为9"name":"酷Q样例应用", // 应用名称"version":"1.0.0", // 应用版本"version_id":1, // 应用顺序版本(每次发布时至少+1)"author":"Example", // 应用作者"description":"酷Q样例应用(V9应用机制)","event":[ // 事件列表,同一事件类型可重复定义(发布前请删除无用事件){"id":1, // 事件ID"type":21, // 事件类型"name":"私聊消息处理", // 事件名称"function":"_eventPrivateMsg", // 事件对应函数"priority":30000 // 事件优先级(参见 cq.im/deveventpriority)},....{"id":1001,"type":1001,"name":"酷Q启动事件","priority":30000,"function":"_eventStartup"},....{"id":1004,"type":1004,"name":"应用将被停用","priority":30000,"function":"_eventDisable"}],"menu":[ // 设置菜单(发布前请删除无用菜单,如果无需设置菜单请全部删除){"name":"设置A", //菜单名称"function":"_menuA" //菜单对应函数},{"name":"设置B","function":"_menuB"}],"status":[ // 悬浮窗状态(见 com.example.status 样例)],"auth":[ // 应用权限(发布前请删除无用权限)//20, //[敏感]取Cookies getCookies / getCsrfToken//30, //接收语音 getRecord101, //发送群消息 sendGroupMsg........180 //撤回消息 deleteMsg]
}
- 代码要点讲解:
- 至于第二个文件dll文件,你需要采用易语言静态编译产生。
- 打开com.~文件可以找我们需要的第一个文件app.e文件,我们以com.example.demo下的app.e为例。
下面介绍app.e的CQ的基本结构
- 点击静态编译,便可以打包成dll插件文件。
5、cpk打包
由上我们已经生成了我开发最重要的两个文件app.dll与app.json文件,下面我们要来学习使用酷Q打包这个两个文件,从而生成cpk用户文件;
- 第一步:参考上面内容,开启开发模式;
- 第二步:开启开发模式后,我们可以在酷Q根目录下看到dev文件夹,在这个文件夹下新建文件夹,命名为com.example.demo,细心的你会发现,在你的app.e文件中存在AppID = “com.example.demo”这段代码,没错,你的命名必须跟这个AppID一致;
- 第三步:将我们辛苦得到的app.dll与app.json文件放在第二步新建目录中去;
- 第四步:接下来就简单了,点击打包应用即可,再根据提示找到打包的cpk文件即可;
配图羽:
到此,你就已经会生成cpk文件了!
总结:
易语言中文语言、酷Q,了解下!插件之路还很漫长,多多加油吧!!!