uniapp 5.06版本,云打包 ios
- 发布:2026-04-09 19:06
- 更新:2026-04-09 19:16
- 阅读:28
产品分类: uniapp/App
PC开发环境操作系统: Mac
PC开发环境操作系统版本号: macos 26.4
手机系统: iOS
手机系统版本号: iOS 18
手机厂商: 苹果
手机机型: iphone14
页面类型: vue
vue版本: vue3
打包方式: 云端
项目创建方式: CLI
CLI版本号: unibest-version: "3.18.9"
操作步骤:
预期结果:
应用图标显示正常
应用图标显示正常
实际结果:
应用图标不显示,打包没打进去
应用图标不显示,打包没打进去
bug描述:
uniapp 云打包 ios 版本之后,生产的包,应用图标丢失
app 应用图标存储路径为子包的 static,示例图二
欢迎到专业群( uni-app 官方技术交流群 1 ) 咨询,群中有相关专业的管理员和群友。
这个 bug 反馈需要补充关键信息才能进一步定位问题。以下是对该反馈的评审分析:
反馈内容完整性评估
缺失的关键信息:
-
manifest.json 配置缺失 - 反馈中仅提到"图标存储路径为子包的 static",但未提供 manifest.json 中
app-plus->distribute->icons->ios节点的具体配置内容。iOS 图标需要在 manifest 中明确配置各分辨率图标路径,仅将图片放在 static 目录不会自动被打包工具识别。 -
项目结构不清晰 - "子包的 static"表述存在歧义,是指项目根目录的 static 文件夹,还是 uni_modules 分包中的 static?iOS 图标通常需要放置在项目根目录的 static 中,并在 manifest 中配置相对路径。
-
版本号信息有误 - 反馈中提到"uniapp 5.06 版本",但截至 2026-03-18,HBuilderX 正式版最新为 5.04,alpha 版为 5.03,不存在 5.06 版本。请确认具体的 HBuilderX 版本号(可在菜单栏帮助-关于中查看)。
-
复现步骤过于简略 - 缺少图标文件的命名规则、尺寸规格(iOS 要求 appstore 图标为 1024x1024)、以及 manifest 可视化界面截图。
技术评审意见
根据知识库文档 iOS 平台云端打包图标配置,iOS 图标必须在 manifest.json 中显式配置:
- App Store 图标:必须配置 1024x1024 的图标(
appstore字段) - iPhone 图标:需配置不同分辨率的图标(
iphone对象下的app@2x、app@3x等) - iPad 图标:如勾选支持 iPad,需单独配置
ipad对象
可能的原因:
-
配置路径错误 - 如果图标放在子包(如 uni_modules/xxx/static)中,打包工具可能无法正确引用。建议将图标放在项目根目录的 static 中。
-
iOS 系统缓存 - 根据知识库 iOS 平台配置/更新图标后打包安装,图标显示不正确,iOS 系统会缓存应用图标,需要重启手机新图标才能生效。
-
缺少必要配置 - 仅配置 Android 图标(
android节点)不会自动应用到 iOS,必须在ios节点单独配置。
建议补充的信息
请补充以下内容以便进一步排查:
- manifest.json 源码视图中
app-plus->distribute->icons节点的完整配置 - 项目目录结构截图(特别是 static 目录位置)
- 图标文件的实际尺寸(是否满足 1024x1024 等要求)
- 尝试重启 iPhone 后图标是否显示(排除系统缓存问题)
临时解决方案:
请检查 manifest.json 的可视化界面,确保在"App 图标配置" -> "iOS 图标配置"中正确引用了图标文件,并确认图标文件位于项目根目录的 static 文件夹中,而非子包目录下。如配置正确但仍不显示,请尝试重启测试设备。