返回

移动端开发: HBuilderX3.6.11以上版本打包iOS常见问题排查指南

Android

Uniapp iOS 打包时如何解决 manifest.json 中的图标配置不符合要求的错误

在 Uniapp 3.6.11 及更高版本中，对内置模块进行了调整，以符合 iOS 平台的隐私合规要求。由于这些更改，云端打包不再默认包含 Camera&Gallery、Barcode、Orientation 和 Record 等模块。开发者需要手动在 manifest.json 的模块配置中勾选这些模块才能使用。然而，在这个过程中，可能会遇到一个常见的错误：“manifest.json 中配置的图标不符合要求”。本文将深入探讨导致此错误的潜在原因，并提供具体的解决方案，帮助开发者顺利打包 iOS 应用。

检查 manifest.json 中的图标配置

首先，请仔细检查 manifest.json 文件中图标的路径是否正确。推荐使用绝对路径，例如："icon: 'static/icon.png'"。此外，请确保图标尺寸符合苹果官方要求。具体尺寸要求可参阅苹果官方文档：https://developer.apple.com/design/human-interface-guidelines/ios/icons-and-images/app-icon/。

添加启动图

苹果官方要求 iOS 项目必须包含启动图。请按照苹果官方文档的规定准备不同尺寸的启动图，并将其添加到项目中。

检查 manifest.json 中的 orientation 配置

manifest.json 中的 orientation 配置不当也可能导致图标配置错误。尝试将 orientation 设置为 "portrait"，然后重新打包。

检查 manifest.json 中的 URL Scheme 配置

URL Scheme 配置不正确也会引发此错误。请将 URL Scheme 设置为一个唯一的字符串，然后重新打包。

检查 manifest.json 中的 splashscreen 配置

splashscreen 配置不正确也可能导致此错误。请将 splashscreen 设置为一个 PNG 或 JPG 文件，然后重新打包。

检查 manifest.json 中的 backgroundColor 配置

backgroundColor 配置不正确也会引发此错误。请将 backgroundColor 设置为一个十六进制颜色值，然后重新打包。

检查 manifest.json 中的 drawer 配置

drawer 配置不正确也可能导致此错误。尝试将 drawer 设置为 false，然后重新打包。

检查 manifest.json 中的 files 配置

files 配置不正确也可能导致此错误。请将 files 设置为一个数组，然后重新打包。

检查 manifest.json 中的 subPackages 配置

subPackages 配置不正确也可能导致此错误。请将 subPackages 设置为一个数组，然后重新打包。

尝试使用命令行打包

如果以上步骤仍然无法解决问题，建议尝试使用命令行打包。在终端中，进入项目目录并运行以下命令：

npm run build:ios --experimental-modules

打包完成后，查看打包日志，根据日志提示解决问题。

常见问题解答

1. 如何创建不同尺寸的启动图？

可以使用 Apple 提供的 启动图生成器 来创建不同尺寸的启动图。

2. 如何设置 URL Scheme？

在 manifest.json 文件中，将 "urlScheme" 字段设置为一个唯一的字符串，例如："urlScheme: 'com.example.myapp'"。

3. 如何配置 splashscreen？

在 manifest.json 文件中，将 "splashscreen" 字段设置为一个 PNG 或 JPG 文件的路径，例如："splashscreen: 'static/splashscreen.png'"。

4. 如何设置 backgroundColor？

在 manifest.json 文件中，将 "backgroundColor" 字段设置为一个十六进制颜色值，例如："backgroundColor: '#ffffff'"。

5. 如何设置 files 配置？

在 manifest.json 文件中，将 "files" 字段设置为一个数组，其中包含要包含在应用中的文件的路径，例如："files: ['static/file1.txt', 'static/file2.png']"。

结论

通过遵循本文中的步骤，开发者可以有效解决 Uniapp iOS 打包时遇到的 manifest.json 中图标配置不符合要求的错误。通过解决这个常见问题，开发者可以顺利打包他们的应用并将其提交到 App Store。