autogo_scriptengine

AutoGo ScriptEngine

AutoGo 的脚本引擎扩展方案，为 AutoGo 提供 JavaScript 和 Lua 脚本语言支持，让开发者可以用熟悉的脚本语言编写自动化任务。

为什么选择 ScriptEngine

1. 降低准入门槛 - 使用脚本语言开发，无需深入理解 Go 语言和 Android 开发，降低学习成本
2. 代码保护 - 脚本代码易于混淆加密，有效保护业务逻辑
3. 热更新支持 - 脚本可动态加载，无需重新编译即可更新功能

功能特性

• 双引擎支持：同时支持 JavaScript 和 Lua 脚本语言
• 丰富的 API：提供应用管理、设备控制、图像识别、OCR 等多种功能
• 方法注册系统：支持动态注册、重写和恢复方法
• 协程支持：Lua 引擎支持协程操作
• 文档生成：可自动生成 API 文档

安装

go get github.com/ZingYao/autogo_scriptengine@v0.0.5

📚 详细文档

🔥 重要提示：查看以下详细文档以获取完整的 API 参考和使用指南

🌐 HTML 在线文档

推荐：查看美观的 HTML 在线文档，提供更好的阅读体验

• 📖 文档索引 - 所有文档的导航页面
• 🏠 项目主页 - 项目介绍和功能特性
• JavaScript 引擎文档 - JavaScript 引擎完整文档
• Lua 引擎文档 - Lua 引擎完整文档

使用方法：

# 生成/更新 HTML 文档
python3 scripts/convert_to_html.py

📖 Markdown 文档

如果您更喜欢阅读 Markdown 格式的文档，可以查看以下链接：

JavaScript 引擎文档

• JavaScript 引擎完整文档 - 包含所有 API、配置选项和高级用法

模块文档

• app 模块 - 应用管理（启动、安装、卸载、强制停止等）
• device 模块 - 设备信息（分辨率、SDK 版本、屏幕方向等）
• motion 模块 - 触摸操作（点击、滑动、手势等）
• files 模块 - 文件操作（读写、复制、删除等）
• images 模块 - 图像处理（截图、找色、找图等）
• storages 模块 - 数据存储（键值对存储）
• system 模块 - 系统功能（剪贴板、通知等）
• http 模块 - 网络请求（GET、POST 等）
• media 模块 - 媒体控制（音量、播放等）
• opencv 模块 - 计算机视觉（图像处理、特征检测等）
• ppocr 模块 - OCR 文字识别
• console 模块 - 控制台窗口（显示、隐藏、日志输出等）
• dotocr 模块 - 点字 OCR 识别（基于字库的 OCR）
• hud 模块 - HUD 悬浮显示（脚本状态显示等）
• ime 模块 - 输入法控制（剪切板、文本输入等）
• plugin 模块 - 插件加载（加载外部 APK 调用 Java 方法）
• rhino 模块 - JavaScript 执行引擎（Rhino）
• uiacc 模块 - 无障碍 UI 操作（控件查找、点击、输入等）
• utils 模块 - 工具方法（日志、Toast、类型转换等）
• vdisplay 模块 - 虚拟显示（虚拟屏操作）
• yolo 模块 - YOLO 目标检测（v5/v8 模型）
• imgui 模块 - Dear ImGui GUI 库（窗口、按钮、输入框等控件）
• coroutine 模块 - 协程支持

📖 Lua 引擎文档

核心文档

• Lua 引擎完整文档 - 包含所有 API、配置选项和高级用法

模块文档

• app 模块 - 应用管理（启动、安装、卸载、强制停止等）
• device 模块 - 设备信息（分辨率、SDK 版本、屏幕方向等）
• motion 模块 - 触摸操作（点击、滑动、手势等）
• files 模块 - 文件操作（读写、复制、删除等）
• images 模块 - 图像处理（截图、找色、找图等）
• storages 模块 - 数据存储（键值对存储）
• system 模块 - 系统功能（剪贴板、通知等）
• http 模块 - 网络请求（GET、POST 等）
• media 模块 - 媒体控制（音量、播放等）
• opencv 模块 - 计算机视觉（图像处理、特征检测等）
• ppocr 模块 - OCR 文字识别
• console 模块 - 控制台窗口（显示、隐藏、日志输出等）
• dotocr 模块 - 点字 OCR 识别（基于字库的 OCR）
• hud 模块 - HUD 悬浮显示（脚本状态显示等）
• ime 模块 - 输入法控制（剪切板、文本输入等）
• plugin 模块 - 插件加载（加载外部 APK 调用 Java 方法）
• rhino 模块 - JavaScript 执行引擎（Rhino）
• uiacc 模块 - 无障碍 UI 操作（控件查找、点击、输入等）
• utils 模块 - 工具方法（日志、Toast、类型转换等）
• vdisplay 模块 - 虚拟显示（虚拟屏操作）
• yolo 模块 - YOLO 目标检测（v5/v8 模型）
• imgui 模块 - Dear ImGui GUI 库（窗口、按钮、输入框等控件）
• coroutine 模块 - 协程支持
• json 模块 - JSON 处理

环境要求

• Go 1.25.4 或更高版本
• AutoGo 框架（已在项目中集成）
• Android 设备（用于实际运行自动化脚本）

依赖

• AutoGo - Android 自动化框架（核心依赖）
• goja - JavaScript 解释器
• gopher-lua - Lua 解释器

与 AutoGo 的关系

本项目是 AutoGo 的扩展方案，通过封装 AutoGo 提供的原生 API，为开发者提供更灵活的脚本编写方式：

• AutoGo - 提供 Android 自动化的核心能力（无障碍服务、图像识别、触摸模拟等）
• ScriptEngine - 为 AutoGo 添加脚本语言支持，让开发者可以用 JavaScript 或 Lua 编写自动化脚本

许可证

MIT License