g***@163.com
g***@163.com
  • 发布:2026-04-09 19:06
  • 更新:2026-04-09 19:16
  • 阅读:28

【报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,暂时可以使用“传统打包”方式避免。
会尽快发新版本解决此问题。

要回复问题请先登录注册