4***@qq.com
4***@qq.com
  • 发布:2026-04-07 12:50
  • 更新:2026-04-07 12:51
  • 阅读:46

【报Bug】iOS 快速安心打包应用图标丢失,传统打包图标正常

分类:uni-app

产品分类: uniapp/App

PC开发环境操作系统: Mac

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

HBuilderX类型: 正式

HBuilderX版本号: 5.06

手机系统: iOS

手机系统版本号: iOS 18

手机厂商: 苹果

手机机型: iphone14

页面类型: vue

vue版本: vue2

打包方式: 云端

项目创建方式: HBuilderX

操作步骤:

HBX升级到5.06,点击发行-》点击App-Android/iOS 云打包

HBX回退到v4.87,打包正常,有应用图标,从v4.87升级到v5.06打包ios异常,没有有应用图标

预期结果:

iOS能正常显示应用图标

实际结果:

iOS不能正常显示应用图标

bug描述:

使用HBX v5.06的云打包,应用图标已经设置了,iOS 快速安心打包应用图标丢失,传统打包图标正常。

注意:图片格式是PNG,不包含透明通道,重启 iOS 设备问题依然在

特别注意:HBX回退到v4.87,打包正常,有应用图标,从v4.87升级到v5.06打包ios异常,没有有应用图标

2026-04-07 12:50 负责人:DCloud_HB_Gml 分享
已邀请:
Ask小助手

Ask小助手 - Ask社区AI助手

作为DCloud官方技术支持人员,对该bug反馈进行如下评审:

反馈质量评价

该反馈基本信息较为完整,但关键复现细节缺失,目前无法直接定位问题根源,需补充关键信息后才能进一步排查。

详细评审分析

1. 信息完整性评估

  • 环境信息:提供了Mac 15.5、HBuilderX 5.06(存疑,最新正式版为5.04)、iOS 18、iPhone14等关键环境信息,较为完整
  • 问题描述:清晰区分了"快速安心打包"与"传统打包"的差异现象,有助于定位问题范围
  • 复现步骤严重缺失,仅描述"HBX升级到5.06,打包iOS",缺少具体操作路径和配置细节,官方人员无法据此复现
  • 代码/配置示例:未提供manifest.json中icons配置或项目结构截图,无法验证配置正确性

2. 版本号异常提醒

你填写的HBuilderX版本号为5.06,但目前官方最新版本为:

  • 正式版:5.04(2026-03-18更新)
  • Alpha版:5.03

请确认实际使用的版本号,版本号错误将影响问题定位。

3. 基于知识库的初步分析

根据应用图标配置文档,iOS平台图标需满足以下要求,请逐一确认:

  • 必须使用PNG格式(你已确认)
  • 不得包含透明通道(Alpha通道)(你已确认)
  • 必须配置1024×1024分辨率的AppStore图标(云端打包机默认使用纯白色图标,未配置会导致异常)
  • 图标必须为直角,非圆角

关于图标不显示,知识库中提到:

iOS系统会缓存应用图标,需要重启手机新图标才能生效

你提到已重启设备但问题依然存在,说明可能不是缓存问题,而是打包过程中图标未正确写入或配置未生效。

4. 关键缺失信息(需补充)

为便于复现和定位,请补充以下内容:

  1. 详细的复现步骤

    • 具体的打包入口路径(是"发行"→"原生App-云打包"→"快速安心打包"选项吗?)
    • manifest.json中图标配置的具体方式(可视化界面截图或源码视图配置代码)
    • 是否使用了自定义基座
  2. 项目配置信息

    • manifest.json中app-plusdistributeiconsios节点的具体配置
    • 图标文件的实际存放路径和命名规则
    • 是否配置了1024×1024的AppStore图标
  3. 打包产物验证

    • 下载ipa文件后,解压查看Payload中.app文件夹内的Icon相关文件是否存在
    • 提供云打包的控制台日志(脱敏后)
  4. 对比信息

    • "传统打包"具体指什么?(本地打包还是云打包的非快速模式?)
    • 传统打包与快速安心打包在操作上的具体差异

5. 初步排查建议

在补充信息前,建议先检查:

  • 确认manifest.json中AppStore图标已配置(1024×1024),未配置会导致云端打包使用默认白色图标
  • 检查PNG文件是否确实无Alpha通道(可用图片工具验证,不仅仅是改后缀)
  • 尝试清除HBX缓存后重新打包

结论:该反馈现象描述清晰,但复现细节不足,且版本号存在疑问。请按上述要求补充详细信息,特别是manifest图标配置截图和打包操作的具体路径,以便官方人员复现和进一步分析。

内容为 AI 生成,仅供参考

要回复问题请先登录注册