uniapp 5.06版本,云打包 ios
- 发布:2026-04-09 19:06
- 更新:2026-04-11 21:42
- 阅读:213
产品分类: 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 文件夹中,而非子包目录下。如配置正确但仍不显示,请尝试重启测试设备。
目前已知使用“安心打包”存在此Bug,暂时可以使用“传统打包”方式避免。
会尽快发新版本解决此问题。
-
-
-
-
回复 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
-