2***@qq.com

发布：2026-02-03 09:15
更新：2026-02-03 10:16
阅读：17

【报Bug】 IOS 原生插件打包自定义基座，提示当前基座未包含此插件

分类：uni-app

bug反馈

产品分类： uniapp/App

PC开发环境操作系统： Windows

PC开发环境操作系统版本号： win11

HBuilderX类型：正式

HBuilderX版本号： 4.87

手机系统： iOS

手机系统版本号： iOS 17

手机厂商：苹果

手机机型： iPhone 12

页面类型： vue

vue版本： vue2

打包方式：云端

项目创建方式： HBuilderX

示例代码：

manifest.json

            "XF_iOSDFULibrary" : {  
                "__plugin_info__" : {  
                    "name" : "xf-ios-dfu-library",  
                    "description" : "XF_iOSDFULibrary",  
                    "platforms" : "iOS",  
                    "url" : "",  
                    "android_package_name" : "",  
                    "ios_bundle_id" : "",  
                    "isCloud" : false,  
                    "bought" : -1,  
                    "pid" : "",  
                    "parameters" : {}  
                }  
            }

插件的package.json

{  
    "name": "xf-ios-dfu-library",  
    "id": "XF_iOSDFULibrary",  
    "version": "0.0.1",  
    "description": "XF_iOSDFULibrary",  
    "_dp_type": "nativeplugin",  
    "_dp_nativeplugin": {  
        "ios": {  
            "plugins": [  
                {  
                    "type": "module",  
                    "name": "XF_iOSDFULibrary",  
                    "class": "IOSDFULibraryWXModule"  
                }  
            ],  
            "frameworks": [  
                "NordicDFU.framework"  
            ],  
            "embedFrameworks": [  
                "NordicDFU.framework"  
            ],  
            "privacies": [  
                "NSBluetoothAlwaysUsageDescription"  
            ],  
            "integrateType": "framework",  
            "deploymentTarget": "12.0",  
            "validArchitectures": [  
                "arm64"  
            ],  
            "resources": [  
                "ZIPFoundation_ZIPFoundation.bundle"  
            ]  
        }  
    }  
}

操作步骤：

    nrfDfu = uni.requireNativePlugin('xf-ios-dfu-library');

预期结果：

插件正常使用

实际结果：

[JS Framework] 当前运行的基座不包含原生插件[xf-ios-dfu-library]，请在manifest中配置该插件，重新制作包括该原生插件的自定义运行基座 __WARN

bug描述：

之前版本一直打包使用正常，昨天打包自定义基座突然发现插件无法使用，没有对插件以及manifest.json有任何修改，回滚代码打包仍然提示自定义基座未包含插件。

2026-02-03 09:15 负责人:无分享

3 个回复

Ask小助手

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

【官方排查指引】

一、先确认 3 个“必做”动作

插件是否已在 manifest.json → "app-plus" → "nativePlugins" 节点中声明

"app-plus": {  
 "nativePlugins": {  
   "XF_iOSDFULibrary": { ... }  
 }  
}

重新制作自定义基座
- 菜单：发行 → 原生 App-云打包 → 选择 自定义调试基座
- 在弹出的模块列表里 务必勾选 “XF_iOSDFULibrary”
- 等待打包完成并下载新的 ipa
删除手机上的旧基座 App，再安装新 ipa，并通过 “运行 → 使用自定义基座运行” 启动

每次升级 HBuilderX（包括同版本号的小幅更新）后，旧自定义基座不会自动升级，必须重新制作，否则就会出现“基座不包含插件”的提示。参考文档

二、如果仍提示缺失，请继续检查

打包日志
- 在 HBuilderX 控制台完整日志中搜索 XF_iOSDFULibrary，确认插件是否被编译进 ipa
证书与描述文件
- iOS 17 真机必须使用 有效的开发证书 及 包含当前设备 UDID 的描述文件，否则安装后会被系统拒绝，表现与“缺失插件”类似
本地缓存
- 关闭 HBuilderX → 删除项目目录下 unpackage/cache 和 unpackage/debug → 重启 HBuilderX 重新打包
离线打包（可选）
- 若云打包始终无法携带插件，可临时改用离线 SDK 自行制作基座：iOS 离线自定义基座指南

三、一键自查清单（建议截图回帖时附上）

HBuilderX 版本号（截图关于页）
manifest.json 完整结构（可脱敏）
云打包控制台完整日志（关键段即可）
手机安装新基座后，设置 → 通用 → 设备管理中的证书截图

按以上步骤操作后，若问题仍然存在，请把上述 4 项信息补充到帖子中，官方可进一步定位。

内容为 AI 生成，仅供参考

2***@qq.com (作者)

问题仍然存在

2026-02-03 10:16 分享

2***@qq.com (作者)

[HBuilder] 09:38:02.355 项目 xj-gateway-app [UNI5F1907C]的打包状态：
[HBuilder] 09:38:02.355 时间: 2026-02-03 09:37:45 类型: iOS Appstore(真机) 正在云端打包
[HBuilder] 09:38:02.355 当前项目使用了原生插件，如果原生插件依赖了三方库且三方库需要联网下载，可能会消耗较长时间，预计 3-30 分钟完成打包，请耐心等待。
[HBuilder] 09:39:04.163
[HBuilder] 09:39:04.164 项目 xj-gateway-app [UNI5F1907C]打自定义调试基座包成功：

[HBuilder] 09:39:04.164 路径为: D:/work/xj-gateway-app/unpackage/debug/iOS_debug.ipa

[HBuilder] 09:39:04.164 选择菜单“运行->运行到手机或模拟器->运行基座选择->自定义调试基座”后再次运行项目，即可通过自定义调试基座查看日志

[HBuilder] 09:39:04.164 注：自定义调试基座不可用于正式发布，其脱离HBuilderX无法更新应用资源

2026-02-03 10:16 分享

要回复问题请先登录或注册

【报Bug】 IOS 原生插件打包自定义基座，提示当前基座未包含此插件

操作步骤：

`nrfDfu = uni.requireNativePlugin('xf-ios-dfu-library');`

预期结果：

插件正常使用

实际结果：

[JS Framework] 当前运行的基座不包含原生插件[xf-ios-dfu-library]，请在manifest中配置该插件，重新制作包括该原生插件的自定义运行基座 __WARN

bug描述：

3 个回复

公告

相关问题

【报Bug】 IOS 原生插件打包自定义基座，提示当前基座未包含此插件

操作步骤： nrfDfu = uni.requireNativePlugin('xf-ios-dfu-library');

预期结果： 插件正常使用

实际结果： [JS Framework] 当前运行的基座不包含原生插件[xf-ios-dfu-library]，请在manifest中配置该插件，重新制作包括该原生插件的自定义运行基座 __WARN

bug描述：

与内容相关的链接

3 个回复

公告

相关问题

操作步骤：

`nrfDfu = uni.requireNativePlugin('xf-ios-dfu-library');`

预期结果：

插件正常使用

实际结果：

[JS Framework] 当前运行的基座不包含原生插件[xf-ios-dfu-library]，请在manifest中配置该插件，重新制作包括该原生插件的自定义运行基座 __WARN