4***@qq.com
4***@qq.com
  • 发布:2026-02-27 11:45
  • 更新:2026-02-27 11:54
  • 阅读:28

【报Bug】Wap2App项目打包自定义基座运行时闪退

分类:HTML5+

产品分类: HTML5+

HBuilderX版本号: 4.87

手机系统: iOS

手机系统版本号: iOS 18

手机厂商: 苹果

手机机型: iPhone13

打包方式: 云端

操作步骤:

创建Wap2App项目、打包自定义基座、运行自定义基座、出现启动画面后闪退。

预期结果:

正常运行

实际结果:

闪退

bug描述:

自定义基座可以正常安装到手机,但是点击运行出现启动画面后就闪退,多次操作均如此。
分别尝试过以下操作,并重新云打包、卸载手机上的旧基座重新安装,问题依旧:

  1. 重装HBuilderX;
  2. 重新生成开发版证书和描述文件;
  3. 重新创建项目后不进行审核修改、直接提交打包;
  4. 更换应用入口页面地址;
  5. 完善IOS隐私信息访问的许可描述;
  6. 添加新的测试设备并重新生成证书和描述文件,重新打包后分别安装于IOS18和IOS12均同样闪退。
    附件是IOS18中的日志,提示缺失DCUniBase.framework
2026-02-27 11:45 负责人:无 分享
已邀请:
Ask小助手

Ask小助手

欢迎到专业群( 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 自定义基座运行时闪退的典型原因。

请按以下步骤排查:

  1. 打开 manifest.json,确认“App模块配置”中是否勾选了涉及原生能力的模块(如地图、支付、推送等);
  2. 若使用了原生插件,请确认插件是否已正确配置,并在插件市场中已绑定当前 AppID;
  3. 重新制作自定义基座(每次升级 HX 后需重新打包);
  4. 如仍有问题,请提供 manifest.json 截图或最小复现项目,我们将进一步协助定位。

参考文档:


五、内部建议(面向开发团队)

  • 建议在 HX 中增加“缺失 framework”提示的友好化提示,引导用户检查 manifest 配置;
  • 考虑在打包失败或运行时增加“配置完整性检测”机制,提前拦截此类问题。
内容为 AI 生成,仅供参考
4***@qq.com

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

附件是manifest.json,以往按照真实使用场景配置过支付和登录鉴权接口参数,当前是新创建的项目且未做任何修改的状态。

要回复问题请先登录注册