加载插件
更新: 2025/7/20 字数: 0 字 时长: 0 分钟
Bot.js提供了加载插件的机制,允许用户编写带有Activity, Service, C/C++库等的apk,安装到Android设备上,并用Bot.js加载和调用。
一个插件是一个可独立安装的apk文件,用户安装后,再通过$plugins
模块加载插件和调用其中的API。
插件支持打包时合并到apk中,打包后无需再单独安装插件。
插件安装包下载
📦 常见插件 APK 下载地址:
👉 点击前往 蓝奏云 网盘下载插件
🔐 提取密码:47xa
正确加载插件
- 安装插件到开发手机,下载插件 APK(如 com.hraps.ocr32.apk)并安装。
- 手动放置插件文件到项目根目录下的
plugins
目录下(apk文件名必须时插件的包名,比如 com.hraps.ocr32.apk )。
$plugins.load(packageName)
packageName
{string} 加载的插件包名
加载一个插件,并返回插件模块中module.exports导出的对象。
如果插件未安装,则抛出PluginLoadException
异常。
js
// 示例:加载 OCR 插件
try {
var ocrPlugin = $plugins.load("com.hraps.ocr32");//只需要导入一次
console.log("插件加载成功:", ocrPlugin);
//然后就可以调用插件的api了
} catch (e) {
console.error("插件加载失败,请检查:", e);
}
打包阶段:内置插件自动集成
在打包 App 时,你可以通过以下步骤将插件直接嵌入生成的 APK 中,用户安装后无需手动安装插件。
打包流程说明
1️⃣ 打开「Bot.js App 打包」页面
2️⃣ 点击「更多插件」
3️⃣ 勾选你需要集成的插件
✅ 这些插件 APK 会在打包时自动嵌入生成的脚本 App 中
插件选择示意图
用户部署阶段:无需额外安装插件
- 用户只需安装你生成的脚本 APK
- 插件已随 APK 一起打包,无需单独安装或配置
常见问题排查
报错:
plugin not found
?
请确认在打包时是否 漏选了对应插件。如有遗漏,请重新打包并确保勾选所需插件。
常见错误:
插件加载失败
04-28 18:39:59.337/E: Wrapped android.content.res.Resources$NotFoundException: plugin com.hraps.ocr32 not found in installed apps or directory /sdcard/appSync/应用名称/plugins
at file:///android_asset/modules/__plugins__.js:6:0
at /sdcard/appSync/应用名称/main.js:3:0