2***@qq.com
2***@qq.com
  • 发布:2026-08-04 12:00
  • 更新:2026-08-04 12:02
  • 阅读:14

【报Bug】原生插件自定义基座报错[JS Framework] 当前运行的基座不包含原生插件

分类:uni-app

产品分类: uniapp/App

PC开发环境操作系统: Windows

PC开发环境操作系统版本号: 10

HBuilderX类型: 正式

HBuilderX版本号: 5.15

手机系统: Android

手机系统版本号: Android 13

手机厂商: 小米

手机机型: K40

页面类型: vue

vue版本: vue3

打包方式: 离线

项目创建方式: HBuilderX

操作步骤:

预期结果:

成功加载到原生插件

实际结果:

[JS Framework] 当前运行的基座不包含原生插件[GHKeyPair],请在manifest中配置该插件,重新制作包括该原生插件的自定义运行基座

bug描述:

条件:

1、已选本地原生插件
2、已经自作自定义基座
3、插件配置json已确认无误

结果:运行自定义基座就提示“[JS Framework] 当前运行的基座不包含原生插件[GHKeyPair],请在manifest中配置该插件,重新制作包括该原生插件的自定义运行基座”

2026-08-04 12:00 负责人:无 分享
已邀请:
Ask小助手

Ask小助手 - Ask社区AI助手

欢迎到专业群( uni-app 官方技术交流群 1 ) 咨询,群中有相关专业的管理员和群友。

感谢您的反馈。针对您提交的 Bug 信息,我们已进行评审,以下是具体的评审意见与排查建议:

1. Bug 反馈内容完整性评审

  • 描述与分类:问题描述与分类信息较为清晰,已包含 PC 环境、HBuilderX 版本、手机系统与机型等关键信息,有助于定位环境因素。
  • 复现步骤与代码示例缺失:反馈中“复现步骤”标注为“无”,且未提供代码示例和原生插件的 package.json 配置内容。由于原生插件涉及本地工程配置,仅凭目前的描述,官方人员无法直接复现或验证您的插件工程结构是否完全合规,需要您补充详细的复现步骤与必要的配置代码。

2. Bug 是否成立分析
根据官方文档与知识库说明,该现象通常属于配置或打包流程问题,暂无法直接判定为框架 Bug:

  • 基座与插件机制:HBuilderX 默认的标准基座不包含任何原生插件,必须制作并运行自定义基座。同时,每次升级 HBuilderX 版本后,旧的自定义基座不会自动升级,需要重新制作。参考文档:使用自定义基座运行
  • 本地插件配置:对于本地原生插件,需确保已在 manifest.json -> “App原生插件配置”中正确选择本地插件,且插件的 package.json 配置完全符合规范。如果配置有误或未正确勾选,打出的基座将不包含该插件。参考文档:本地原生插件配置
  • 缓存与运行方式:制作自定义基座后,必须通过 HBuilderX 的“运行 -> 运行到手机或模拟器 -> 使用自定义基座”方式启动。如果手机上残留旧基座,可能导致冲突,建议卸载手机上的旧基座应用后重新运行。

3. 排查建议
建议您先按照以下步骤进行自查,若仍无法解决,请补充相应信息后重新提交:

  1. 删除项目 unpackage 目录下的缓存,卸载手机上的旧基座应用。
  2. 重新检查 manifest.json 中的本地插件勾选状态,并确认插件的 package.json 及相关 aar/jar 文件路径是否符合官方规范。
  3. 重新制作自定义基座,并确保运行时选择了“自定义基座”。
  4. 如果问题依旧,请在反馈中补充原生插件的 package.json 内容、manifest.json 中插件配置截图以及完整的复现操作步骤,以便官方进一步排查。
内容为 AI 生成,仅供参考

要回复问题请先登录注册