加载插件

更新: 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异常。

// 示例：加载 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

插件未找到错误

加载插件 ​

插件安装包下载 ​

正确加载插件 ​

$plugins.load(packageName) ​

打包阶段：内置插件自动集成 ​

打包流程说明 ​

插件选择示意图 ​

用户部署阶段：无需额外安装插件 ​

常见问题排查 ​

常见错误： ​