创建Wap2App项目、打包自定义基座、运行自定义基座、出现启动画面后闪退。
- 发布:2026-02-27 11:45
- 更新:2026-02-27 11:54
- 阅读:28
产品分类: HTML5+
HBuilderX版本号: 4.87
手机系统: iOS
手机系统版本号: iOS 18
手机厂商: 苹果
手机机型: iPhone13
打包方式: 云端
操作步骤:
预期结果:
正常运行
正常运行
实际结果:
闪退
闪退
bug描述:
自定义基座可以正常安装到手机,但是点击运行出现启动画面后就闪退,多次操作均如此。
分别尝试过以下操作,并重新云打包、卸载手机上的旧基座重新安装,问题依旧:
- 重装HBuilderX;
- 重新生成开发版证书和描述文件;
- 重新创建项目后不进行审核修改、直接提交打包;
- 更换应用入口页面地址;
- 完善IOS隐私信息访问的许可描述;
- 添加新的测试设备并重新生成证书和描述文件,重新打包后分别安装于IOS18和IOS12均同样闪退。
附件是IOS18中的日志,提示缺失DCUniBase.framework
欢迎到专业群( uni-app 官方技术交流群 1 ) 咨询,群中有相关专业的管理员和群友。
作为 DCloud 官方人员,我对这条 bug 反馈进行如下评审:
一、反馈完整性评估
| 维度 | 是否完整 | 说明 |
|---|---|---|
| BUG 标题 | ✅ | 明确指出了“Wap2App项目打包自定义基座运行时闪退” |
| BUG 描述 | ✅ | 描述清晰,已尝试多种排查手段(重装HX、重签证书、换设备、换入口页等) |
| 代码示例 | ❌ | 未提供任何代码或项目结构截图,无法判断是否因代码或配置导致 |
| 复现步骤 | ✅ | 步骤简洁明确,具备可复现性 |
| 预期结果 | ✅ | “正常运行”合理 |
| 实际结果 | ✅ | “闪退”明确,且提供了日志提示“缺失DCUniBase.framework” |
| 分类信息 | ✅ | 提供了HX版本、iOS版本、设备型号等关键信息 |
结论:该反馈在描述和分类信息上较为完整,但缺少代码示例或项目配置截图,建议用户补充 manifest.json 配置、是否使用原生插件、是否引入 DCUniBase.framework 等相关信息。
二、Bug 是否成立
根据知识库内容:
-
iOS自定义基座闪退 FAQ 明确指出:
若提示缺失
DCUniBase.framework,说明打包时未正确引入该依赖,需检查是否使用了原生插件或模块配置中是否勾选了相关模块。 -
自定义基座使用说明 也指出:
自定义基座需包含所有 manifest.json 中配置的模块和原生插件,否则运行时会闪退。
结论:该 bug 成立,且属于已知问题,原因是打包时未正确包含 DCUniBase.framework,需用户检查 manifest.json 中是否配置了相关模块或插件,并重新打包。
三、是否为基础概念问题
- 用户已尝试重装 HX、重签证书、换设备、换入口页等操作,说明非基础误操作;
- 但用户未提及是否检查了 manifest.json 中是否勾选了相关模块或插件,可能遗漏配置项;
- 日志提示缺失
DCUniBase.framework,明确指向配置或打包遗漏。
四、官方建议回复(面向用户)
您好,感谢详细反馈。根据日志提示“缺失 DCUniBase.framework”,这是 iOS 自定义基座运行时闪退的典型原因。
请按以下步骤排查:
- 打开
manifest.json,确认“App模块配置”中是否勾选了涉及原生能力的模块(如地图、支付、推送等);- 若使用了原生插件,请确认插件是否已正确配置,并在插件市场中已绑定当前 AppID;
- 重新制作自定义基座(每次升级 HX 后需重新打包);
- 如仍有问题,请提供
manifest.json截图或最小复现项目,我们将进一步协助定位。参考文档:
五、内部建议(面向开发团队)
- 建议在 HX 中增加“缺失 framework”提示的友好化提示,引导用户检查 manifest 配置;
- 考虑在打包失败或运行时增加“配置完整性检测”机制,提前拦截此类问题。