小鱼精灵开发工具
面向小鱼精灵 Lua 脚本开发的 VS Code 扩展。安装后即可在 VS Code 中编写、补全、运行和打包脚本,并直接使用抓图取色工具。
官方网站与开发文档
功能
- Lua API 补全:输入
find、m.find 等内容即可提示当前公开 API;候选项会显示函数签名、参数、返回值和说明。
- 运行与控制:运行当前 Lua 文件,以及暂停、继续、停止脚本、读取日志。
- 项目打包:根据工作区中的
alpkg.json 生成 .alpkg 脚本包。
- 抓图取色:一键打开内置抓图取色器,支持与 Android 引擎同时连接。
快速开始
- 在 Android 设备上启动小鱼精灵。
- 在扩展设置中填写设备地址,例如局域网连接使用
192.168.1.100:18380,ADB 转发使用 127.0.0.1:18380。
- 打开 Lua 文件,通过命令面板或底部状态栏运行、控制和打包。
使用 ADB 转发时,在高级连接设置中启用“通过 ADB 转发连接”,并按需填写 ADB 路径和设备序列号。
常用命令
小鱼精灵:连接设置
小鱼精灵:检查连接
小鱼精灵:运行当前 Lua 文件
小鱼精灵:暂停脚本
小鱼精灵:继续脚本
小鱼精灵:停止脚本
小鱼精灵:读取日志
小鱼精灵:打包当前项目
小鱼精灵:打开抓图取色器
项目打包
在脚本项目根目录新建 alpkg.json:
{
"entry": "main.lua",
"include": ["main.lua", "*.lua", "scripts/", "images/"],
"exclude": [".git/", ".vscode/", "dist/", "test*", "dev*", "*.bak"]
}
include 是必填白名单。执行“打包当前项目”即可生成脚本包;没有该文件时,打包器会生成
默认配置后继续打包。完整配置与匹配规则见官方开发文档。
文档
| |