4***@qq.com
4***@qq.com
  • 发布:2026-04-07 11:47
  • 更新:2026-04-07 12:25
  • 阅读:27

【报Bug】iOS 打包应用图标丢失

分类:uni-app

产品分类: uniapp/App

PC开发环境操作系统: Mac

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

HBuilderX类型: 正式

HBuilderX版本号: 5.06

手机系统: iOS

手机系统版本号: iOS 18

手机厂商: 苹果

手机机型: 苹果

页面类型: vue

vue版本: vue2

打包方式: 云端

项目创建方式: HBuilderX

操作步骤:

HBX升级到5.06,直接打包

预期结果:

iOS有相应的应用图标

实际结果:

iOS没有相应的应用图标

bug描述:

应用图标已经设置了,打包基座时ios有应用图标,使用快速打包时ios没有应用图标,但是安卓有应用图标

2026-04-07 11:47 负责人:无 分享
已邀请:
Ask小助手

Ask小助手

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

反馈质量评价

该反馈属于不完整反馈,无法直接定位问题根源。虽然描述了现象差异(基座有图标/快速打包无图标),但缺少关键的配置信息和排查依据。

主要缺失项

  1. manifest.json 图标配置截图:未提供 app-plus -> distribute -> icons -> ios 节点的具体配置内容
  2. 图标文件详情:未说明图标格式是否为 PNG、是否包含透明通道(alpha)、分辨率是否符合要求
  3. 打包方式不明确:"快速打包"指代不明(云打包?离线打包?),且未说明是否使用自定义基座
  4. 排查步骤缺失:未说明是否已尝试重启手机(iOS 图标缓存机制)

基于知识库的分析

根据知识库文档 app-icons > 常见问题 > iOS平台配置/更新图标后打包安装,图标显示不正确iOS 系统会缓存应用图标,即使重新打包安装,也可能需要重启手机才能显示新图标。

同时,根据 app-icons > iOS平台 的规范要求,iOS 图标必须满足:

  • 必须使用 PNG 格式(不可直接修改后缀名)
  • 图标必须是直角(非圆角)
  • 必须配置 1024×1024 分辨率的 AppStore 图标
  • 所有图标不能包含透明信息(alpha 通道),否则会导致打包失败或图标显示异常

初步判断

该问题大概率是配置或缓存问题,而非产品 bug:

  1. 缓存问题:基座使用旧图标缓存,云打包使用新配置但受系统缓存影响
  2. 配置不完整:可能未配置 appstoreiphone/ipad 特定尺寸的图标(云打包对配置完整性要求更严格)
  3. 图标格式违规:如包含 alpha 通道,可能在云打包时被过滤

需要补充的信息

请补充以下内容以便进一步排查:

  1. manifest.json 中 app-plus.distribute.icons.ios 的完整配置(源码视图截图)
  2. 图标文件的具体格式(是否 PNG)、分辨率和是否包含透明通道
  3. 确认"快速打包"具体指云打包还是离线打包
  4. 尝试重启 iOS 设备后图标是否显示正常

建议先尝试:卸载应用 → 重启手机 → 重新安装,验证是否为 iOS 图标缓存导致的显示异常。

内容为 AI 生成,仅供参考
4***@qq.com

4***@qq.com (作者) - 菜鸟

使用的是云打包,图片格式是PNG,不包含透明通道,"快速打包"具体指云打包,重启 iOS 设备问题依然在

4***@qq.com

4***@qq.com (作者) - 菜鸟

我刚才试了一下,使用传统打包方式ios图标正常,使用快速安心包打包ios就没有图标了

要回复问题请先登录注册