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 设备（用于实际运行自动化脚本）

兼容性说明

Android 版本兼容性

某些依赖包在特定的 Android 版本下可能会出现内存引用错误（Memory Reference Error）。如果遇到此类问题，可以尝试以下解决方案：

1. 修改引入的包：根据您的 Android 版本，可以修改项目中引入的相关包
2. 禁用问题模块：在引擎配置中禁用导致问题的特定模块
3. 使用替代方案：某些功能可能有多种实现方式，可以尝试使用替代方案

Windows 开发环境

在 Windows 环境下开发时，如果引入了某些使用 C 语言的包，可能会遇到以下错误：

The command line is too long.

这是 Windows 命令行长度限制导致的。解决方案：

1. 避免引入问题包：尽量减少使用包含 C 代码的依赖包
2. 使用 WSL：在 Windows Subsystem for Linux (WSL) 环境中开发
3. 调整项目结构：将项目拆分为多个子项目，减少单个项目的依赖复杂度

常见问题处理

如果遇到兼容性问题，建议：

1. 检查您的 Android 设备版本和 SDK 版本
2. 查看项目的 GitHub Issues，了解已知的兼容性问题
3. 根据错误信息调整配置或代码
4. 如有必要，可以 Fork 项目并根据您的环境进行修改

依赖

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

与 AutoGo 的关系

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

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

许可证

MIT License