1.在 HBuilderX 中打开工程根目录(与 manifest.json、nativeplugins 同级)。
2.确认 manifest 已配置本地原生插件 AdscopePlugin(可视化界面勾选 + app-plus.nativePlugins 存在)。
3.发行 → 原生 App-云打包,选择 iOS,勾选 打自定义调试基座,真机,使用有效开发证书与描述文件,提交云打包直至成功。
4.将生成的 iOS_debug.ipa 安装到真机(或依赖 HBuilderX 自动安装)。
5.运行 → 运行到 iOS 设备,在运行窗口选择 使用自定义基座运行 → 本地基座,点击运行。
6.进入会调用 uni.requireNativePlugin('AdscopePlugin') 的页面(例如广告调试),观察控制台。
- 发布:2026-05-14 13:34
- 更新:2026-05-14 13:36
- 阅读:25
产品分类: uniapp/App
PC开发环境操作系统: Mac
PC开发环境操作系统版本号: macOS 26.4.1 (25E253)
HBuilderX类型: 正式
HBuilderX版本号: 5.07
手机系统: iOS
手机系统版本号: iOS 26
手机厂商: 苹果
手机机型: 15pro max
页面类型: vue
vue版本: vue2
打包方式: 云端
项目创建方式: HBuilderX
App下载地址或H5⽹址: https://app.liuyingyong.cn/build/download/b5831b50-4f4c-11f1-9dca-fb4b5c6c978e
操作步骤:
预期结果:
自定义调试基座:已按 manifest 打入本地插件 AdscopePlugin
自定义调试基座:已按 manifest 打入本地插件 AdscopePlugin
实际结果:
自定义调试基座:仍报「基座不包含原生插件[AdscopePlugin]」
自定义调试基座:仍报「基座不包含原生插件[AdscopePlugin]」
bug描述:
已在 manifest → App 原生插件配置 中勾选本地插件 AdScope Bridge(id:AdscopePlugin),manifest.json 中 app-plus.nativePlugins 已包含 AdscopePlugin。
已通过 发行 → 原生 App-云打包 → 打 iOS 自定义调试基座(真机),控制台显示 打包成功,并生成 unpackage/debug/iOS_debug.ipa。
运行前已在 运行基座选择 中选 「使用自定义基座运行」+「本地基座」,且本地基座修改时间与打包成功时间一致。
真机运行后,控制台仍反复出现:
[JS Framework] 当前运行的基座不包含原生插件[AdscopePlugin],请在manifest中配置该插件,重新制作包括该原生插件的自定义运行基座
JS 侧 uni.requireNativePlugin('AdscopePlugin') 无法解析到模块(与上述报错一致)
1 个回复
Ask小助手 - Ask社区AI助手
作为DCloud官方人员,我对这个bug反馈进行评审:
反馈完整性评价
这个bug反馈整体质量较高,信息非常完整。BUG描述详细说明了问题现象,包括具体的错误日志"[JS Framework] 当前运行的基座不包含原生插件[AdscopePlugin]",以及JS侧调用
uni.requireNativePlugin('AdscopePlugin')失败的情况。环境信息完整,包含了开发系统、HBuilderX版本号、手机平台、设备型号等关键信息。复现步骤描述非常清晰,从配置插件、云打包生成基座、到选择运行基座的完整流程都有说明,步骤之间逻辑连贯。预期结果合理,实际结果与预期形成明确对比。分类信息也很完整,包含了Vue版本、打包方式等必要信息。
稍显不足的是,代码示例部分只提到了
uni.requireNativePlugin('AdscopePlugin')这一行调用代码,没有展示完整的插件调用上下文,但考虑到问题核心是基座识别问题而非插件调用逻辑,现有信息已经足够官方人员理解问题本质。问题分析
根据知识库中的信息,这类问题在社区中确实被反复提及。在对话知识库中,有多个用户反馈类似情况:"在manifest中配置了某个原生插件了,也打自定义基座包了,运行的时候还是显示'当前运行的基座不包含原生插件'",这与当前用户遇到的情况完全一致。
从官方文档原生插件常见问题来看,这类问题的标准排查流程是:确认配置了自定义基座,并勾选了"使用自定义基座";确认手机上运行的是包含原生插件的自定义基座。
对话记录中,官方人员DCloud_UNI_HT曾针对类似问题建议"按这个文档排查吧,缺少配置",并提供了排查文档链接。这说明系统层面的提示机制本身是有效的,问题通常出在配置或打包环节。
问题成立性判断
这个bug反馈描述的情况值得进一步排查。用户在HBuilderX 5.07版本、iOS平台上,按照标准流程操作后仍然无法识别本地插件。虽然知识库中的官方文档主要强调配置检查,但多个用户的类似反馈表明在某些特定情况下可能存在配置识别或基座加载的问题。
排查建议
建议从以下几个角度进一步排查:
首先,检查插件的package.json配置是否正确。根据知识库中类似案例的排查经验,需要确认"plugins"节点下的"class"值是否与原生代码中的类名完全一致。
其次,尝试删除unpackage目录后重新打包。在对话知识库中,有官方人员针对类似问题建议"把unpackage删了试一试",这有助于清除可能存在的打包缓存问题。
同时,建议严格按照原生插件使用文档重新检查整个配置流程,确保所有步骤都正确执行。
如果上述排查后问题仍然存在,建议在ask社区或issues系统中提供完整的项目结构截图和插件配置文件,便于进一步定位问题。
要回复问题请先登录或注册
公告
更多>相关问题