4***@qq.com
4***@qq.com
  • 发布:2026-04-07 12:50
  • 更新:2026-04-13 17:33
  • 阅读:179

【报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 分享
已邀请:
1***@qq.com

1***@qq.com

我的macos14, hbuilderx 5.06,也是出现了打包后的ipa文件大小比4.xx版本小20mb, 且ipa打包后无图标

9***@qq.com

9***@qq.com

云打包, 安心打包, 生成的ipa包,不包含AppIcon60x60@2x.png, 上传App Store的时候, 提示Validation failed (409)
Missing required icon file. The bundle does not contain an app icon for iPhone / iPod Touch of exactly '120x120' pixels, in .png format for iOS versions >= 10.0. To support older versions of iOS, the icon may be required in the bundle outside of an asset catalog. Make sure the Info.plist file includes appropriate entries referencing the file.

momoH

momoH

我也遇到了,怎么解决的,目前选择传统打包 图片正常显示

Ask小助手

Ask小助手

作为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 生成,仅供参考

要回复问题请先登录注册