Miru 扩展开发环境搭建
前置条件
开发 Mirv 扩展不需要搭建 Mirv 主程序的构建环境(Flutter SDK 那些可以不管)。你只需要:
| 组件 | 用途 |
|---|---|
| Mirv Windows 客户端 | 推荐的开发和测试目标(官方明确说明原因,见下) |
| VSCode 或任意 JS 编辑器 | 写扩展代码,语法高亮 |
| JavaScript 基础 | Mirv 扩展是纯 JS,会写简单的 async/await 就行 |
VSCode 不是必须的——任何能编辑文本的编辑器都能写 Mirv 扩展。但 VSCode 有丰富的 JS 语法支持和插件生态,推荐使用。
为什么官方推荐 Windows 客户端
Mirv 官方开发者文档里明确说明:
在开发 Mirv 的扩展时只需要安装有 Mirv 的 Windows 客户端,但其实 Android 端也是可以开发的,只是不能看到扩展输出的日志不好进行调试。
Windows 客户端做开发的优势:
- 有扩展调试日志:扩展里用
console.log()输出的调试信息,Windows 客户端能直接看到; - 方便定位扩展目录:右上角导入按钮直接打开文件系统目录;
- 跨端通用:扩展是纯 JS,在 Windows 上写好后能直接拿到 Android 或 Web 端跑,不需要改动。
Android 端不是不能写扩展,只是调试体验差一些——要配合 adb logcat 才能看到日志。Web 端不推荐做开发目标(跨域限制 + 调试最麻烦)。
步骤
- 下载并安装 Mirv Windows 客户端(参考 Windows 安装);
- 安装 VSCode(或用你习惯的编辑器);
- 确认扩展加载目录能正常访问(
%LOCALAPPDATA%\miru\extensions\); - 在这个目录里创建一个
.js文件开始写第一个扩展。
辅助知识
写 Mirv 扩展前建议了解:
- JavaScript async / await:扩展方法大多是异步的,
async/await是基础; - 正则表达式:Mirv 官方开发文档推荐扩展开发者先补一下正则——很多媒体源页面是 HTML,解析时需要正则;
- this.request:扩展的网络请求统一走这个代理,不要直接用
fetch。
推荐的正则入门资源(官方开发者文档引用的):
- javascript.info 的正则表达式章节;
- 30 分钟正则入门教程。