AutoJs6 VSCode 开发插件

• 支持 AutoJs6 脚本调试与运行的 VSCode 插件
• 克隆 (Clone) 自 hyb1996/Auto.js-VSCode-Extension

安装 (Install)

• VSCode 菜单 View / 查看 - Extensions / 扩展 [ Ctrl+Shift+X ]
• 搜索 "AutoJs6" 或 "003"
• 选择 "AutoJs6 VSCode Extension" 插件并安装 (或更新)

功能 (Features)

• 在 VSCode 中连接设备并操作 AutoJs6 的脚本或项目 (运行 / 停止 / 保存 等)
• 在 VSCode 中实时显示 AutoJs6 的日志

使用 (Usage)

0. 基本操作

• < 命令面板 >
  • VSCode 菜单 View / 查看 - Command Palette / 命令面板 [ Ctrl+Shift+P ]
• < 开发人员工具 >
  • VSCode 菜单 Help / 帮助 - Toggle Developer Tools / 切换开发人员工具

1. 连接到计算机

• 打开 < 命令面板 > 选择 AutoJs6: 建立设备连接 (Connect) [ Ctrl+Alt+F6 ]
• 使用下述方式之一建立设备连接 (任选其一)
  • AutoJs6 (客户端) > VSCode (服务端) | 局域网
    • AutoJs6 侧拉菜单中开启 "客户端模式"
    • 输入 VSCode 弹窗显示的本机 IP 地址
  • AutoJs6 (服务端) < VSCode (客户端) | 局域网
    • AutoJs6 侧拉菜单中开启 "服务端模式"
    • VSCode 输入 AutoJs6 所在设备的 IP 地址
  • AutoJs6 (服务端) < VSCode (客户端) | ADB (USB)
    • AutoJs6 侧拉菜单中开启 "服务端模式"
    • AutoJs6 所在设备通过 USB 连接到 VSCode 所在计算机
    • AutoJs6 所在设备需启用 USB 调试模式并勾选信任上述计算机
    • 不同设备操作方式可能不同 详见设备厂商手册或相关互联网资料
  • 历史记录 (IP)
    • 连接成功后的设备 IP 地址会记录在列表中方便选择
    • AutoJs6 需启用 "服务端模式"
    • 设备 IP 地址可能发生改变
    • 使用 "清理" 选项清除所有已保存的记录
• VSCode 弹窗显示 AutoJs6 设备接入: ${DEVICE} (${IP_ADDRESS}) 完成设备连接

2. 执行命令

• 打开 < 命令面板 > 查看并执行支持的命令 (快捷键详见下述 "命令" 板块)
• 如 AutoJs6: 运行脚本 (Run) AutoJs6: 停止所有脚本 (Stop All) 等

3. 查看日志

• 采用下述方式之一查看来自 AutoJs6 的日志 (任选其一)
  • 在建立设备连接后弹出的 OUTPUT / 输出 面板 [ F12 ] 查看
  • 打开 < 开发人员工具 > 在 Console 面板查看

4. 断开连接

• 采用下述方式之一断开所有 AutoJs6 与 VSCode 建立的连接 (任选其一)
  • 打开 < 命令面板 > 选择 AutoJs6: 断开所有连接 (Disconnect All) [ Ctrl+Alt+Shift+F6 ]
  • 在 AutoJs6 侧拉菜单关闭对应开关 (客服端 / 服务端)
  • 断开 AutoJs6 的 USB 连接 (仅适用于 ADB (USB) 连接方式)
  • 退出 AutoJs6 应用 / 关闭 VSCode 软件

命令 (Commands)

• 查看在线文档 (View Online Document) [ Alt+Shift+F6 ]
  • 查看 AutoJs6 在线开发文档
• 建立设备连接 (Connect) [ Ctrl+Alt+F6 ]
  • 建立 AutoJs6 与 VSCode 的连接
  • AutoJs6 相关开关可能需要手动开启
• 断开所有连接 (Disconnect All) [ Ctrl+Alt+Shift+F6 ]
  • 断开所有已建立的连接
  • AutoJs6 相关开关状态可能被重置
• 运行脚本 (Run) [ F6 ]
  • 运行当前 VSCode 对应的脚本
  • 对所有已连接的设备有效
• 重新运行脚本 (Rerun)
  • 停止当前 VSCode 对应的脚本并重新运行
  • 对所有已连接的设备有效
• 停止当前脚本 (Stop) [ Ctrl+F6 ]
  • 停止当前 VSCode 对应的脚本
  • 对所有已连接的设备有效
• 停止所有脚本 (Stop All) [ Ctrl+Shift+F6 ]
  • 停止所有正在运行的脚本
  • 对所有已连接的设备有效
• 保存到所有设备 (Save)
  • 保存当前文件到已连接设备的 AutoJs6 工作目录
  • 对所有已连接的设备有效
• 指定设备运行 (Run On Device)
  • 弹出设备菜单并指定运行 VSCode 对应脚本的设备
• 保存到指定设备 (Save To Device)
  • 弹出设备菜单并在指定保存 VSCode 对应脚本的设备
• 新建项目 (New Project) [ CTRL+ALT+6 N ]
  • 选择 (或创建后选择) 一个空文件夹用于新建 AutoJs6 项目
• 运行项目 (Run Project) [ CTRL+ALT+6 R / Alt+F6 ]
  • 运行一个 AutoJs6 项目
• 保存项目到设备 (Save Project) [ CTRL+ALT+6 S ]
  • 保存一个 AutoJs6 项目

版本历史 (Release Notes)

v1.0.7

2023/10/30

• 修复 输入 AutoJs6 服务端地址有效且部分匹配历史记录时无法按输入值建立连接的问题
• 优化 增加 AutoJs6 项目实例的必要文件检测及提示
• 优化 未命名文件保存到设备时自动识别文件类型并添加扩展名

v1.0.6

2023/07/21

• 修复 服务端发送消息长度超过四位十进制数时长度数据被截断的问题 issue #7 issue #9

v1.0.5

2023/07/06

• 新增 支持通过 HTTP 协议携带参数执行插件命令 issue #6
• 新增 已建立连接的历史客户端支持显示最近连接时间
• 修复 无法保存文件到设备以及无法运行或保存项目的问题 issue #5
• 优化 插件命令选择窗口增加详细说明便于用户了解并选择合适的连接方式
• 优化 实现 VSCode 插件与 AutoJs6 的双向版本检测并提示异常检测结果
• 优化 支持同一设备使用同一方式重复连接的行为检测及提示
• 优化 清除连接设备历史记录时增加确认操作提示

更多版本历史可参阅

• CHANGELOG.md

相关项目

• AutoJs6 { author: SuperMonster003 }
  • 安卓平台 JavaScript 自动化工具 (二次开发项目)
• AutoJs6-TypeScript-Declarations { author: SuperMonster003 }
  • AutoJs6 声明文件 (代码智能补全)
• Auto.js-VSCode-Extension { author: hyb1996 }
  • Auto.js VSCode 开发插件
• Auto.js-VSCode-Extension { author: 710850609 }
  • Auto.js VSCode 开发插件 (二次开发项目)
• Auto.js-VSCode-Extension { author: kkevsekk1 }
  • Auto.js VSCode 开发插件 (二次开发项目)