半瓶神仙醋
半瓶神仙醋
  • 发布:2026-04-09 19:06
  • 更新:2026-04-11 21:42
  • 阅读:213

【报Bug】uniapp 打包 ios, 应用图标丢失

分类:uni-app

产品分类: uniapp/App

PC开发环境操作系统: Mac

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

手机系统: iOS

手机系统版本号: iOS 18

手机厂商: 苹果

手机机型: iphone14

页面类型: vue

vue版本: vue3

打包方式: 云端

项目创建方式: CLI

CLI版本号: unibest-version: "3.18.9"

操作步骤:

uniapp 5.06版本,云打包 ios

预期结果:

应用图标显示正常

实际结果:

应用图标不显示,打包没打进去

bug描述:

uniapp 云打包 ios 版本之后,生产的包,应用图标丢失
app 应用图标存储路径为子包的 static,示例图二

2026-04-09 19:06 负责人:无 分享
已邀请:
Ask小助手

Ask小助手

欢迎到专业群( uni-app 官方技术交流群 1 ) 咨询,群中有相关专业的管理员和群友。

这个 bug 反馈需要补充关键信息才能进一步定位问题。以下是对该反馈的评审分析:

反馈内容完整性评估

缺失的关键信息:

  1. manifest.json 配置缺失 - 反馈中仅提到"图标存储路径为子包的 static",但未提供 manifest.json 中 app-plus -> distribute -> icons -> ios 节点的具体配置内容。iOS 图标需要在 manifest 中明确配置各分辨率图标路径,仅将图片放在 static 目录不会自动被打包工具识别。

  2. 项目结构不清晰 - "子包的 static"表述存在歧义,是指项目根目录的 static 文件夹,还是 uni_modules 分包中的 static?iOS 图标通常需要放置在项目根目录的 static 中,并在 manifest 中配置相对路径。

  3. 版本号信息有误 - 反馈中提到"uniapp 5.06 版本",但截至 2026-03-18,HBuilderX 正式版最新为 5.04,alpha 版为 5.03,不存在 5.06 版本。请确认具体的 HBuilderX 版本号(可在菜单栏帮助-关于中查看)。

  4. 复现步骤过于简略 - 缺少图标文件的命名规则、尺寸规格(iOS 要求 appstore 图标为 1024x1024)、以及 manifest 可视化界面截图。

技术评审意见

根据知识库文档 iOS 平台云端打包图标配置,iOS 图标必须在 manifest.json 中显式配置:

  • App Store 图标:必须配置 1024x1024 的图标(appstore 字段)
  • iPhone 图标:需配置不同分辨率的图标(iphone 对象下的 app@2xapp@3x 等)
  • iPad 图标:如勾选支持 iPad,需单独配置 ipad 对象

可能的原因:

  1. 配置路径错误 - 如果图标放在子包(如 uni_modules/xxx/static)中,打包工具可能无法正确引用。建议将图标放在项目根目录的 static 中。

  2. iOS 系统缓存 - 根据知识库 iOS 平台配置/更新图标后打包安装,图标显示不正确,iOS 系统会缓存应用图标,需要重启手机新图标才能生效。

  3. 缺少必要配置 - 仅配置 Android 图标(android 节点)不会自动应用到 iOS,必须在 ios 节点单独配置。

建议补充的信息

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

  1. manifest.json 源码视图中 app-plus -> distribute -> icons 节点的完整配置
  2. 项目目录结构截图(特别是 static 目录位置)
  3. 图标文件的实际尺寸(是否满足 1024x1024 等要求)
  4. 尝试重启 iPhone 后图标是否显示(排除系统缓存问题)

临时解决方案:
请检查 manifest.json 的可视化界面,确保在"App 图标配置" -> "iOS 图标配置"中正确引用了图标文件,并确认图标文件位于项目根目录的 static 文件夹中,而非子包目录下。如配置正确但仍不显示,请尝试重启测试设备。

内容为 AI 生成,仅供参考
DCloud_App_Array

DCloud_App_Array

目前已知使用“安心打包”存在此Bug,暂时可以使用“传统打包”方式避免。
会尽快发新版本解决此问题。

  • 半瓶神仙醋 (作者)

    预计哪个版本修复呢,大概什么时候更新呢,期待新版呢

    2026-04-10 14:44

  • 姜衿丶

    目前使用传统打包也还是一样的错误呢。

    2026-04-10 16:30

  • DCloud_App_Array

    回复 姜衿丶: 传统打包在哪里报错?可以安装到收起看下图标是否可正常显示。

    2026-04-11 16:48

  • 姜衿丶

    回复 DCloud_App_Array: 使用传统打包(上传代码)打包ios应用,上传提审核报错:ITMS-90022: 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. See

    2026-04-13 09:50

  • 姜衿丶

    回复 DCloud_App_Array: 已通过Hbuildx 提交Bug反馈 ID为:28239

    2026-04-13 09:59

5***@qq.com

5***@qq.com

还没修复吗

要回复问题请先登录注册