SDK version issue,app was built with the iOS 17.5 SDK,must iOS 18 SDK or later

关于iOS应用提交App Store提示SDK版本不兼容的解决方案（ITMS-90725错误）

问题现象：

使用HBuilder开发的UniApp项目通过提交后，提示：

"This app was built with the iOS 17.5 SDK. All iOS and iPadOS apps must be built with the iOS 18 SDK or later..."

或者使用蛋壳Uploader 上传报错, 验证失败:

Validation failed (409) SDK version issue. This app was built with the iOS 17.5 SDK. All iOS and iPadOS apps must be built with the iOS 18 SDK or later, included in Xcode 16 or later, in order to be uploaded to App Store Connect or submitted for distribution

根本原因：

2024年6月苹果强制要求所有新提交应用必须使用Xcode 16（含iOS 18 SDK）构建。当前开发环境使用的SDK版本已不符合最新要求。

解决方案：

请按以下步骤升级开发环境：

1. 升级基础开发工具

- 安装最新Xcode 16（通过App Store或开发者官网下载）

- 确保MacOS系统版本符合Xcode 16要求（建议Ventura 13.5或更高）

2. 更新HBuilder开发环境

- 打开HBuilderX

- 导航至【帮助】→【检查更新】安装最新正式版（推荐3.9.10+）

- 重启IDE使更新生效

3. 更新UniApp依赖链

在项目根目录执行：

```bash

npx @dcloudio/uvm@latest

```

该命令将自动更新以下关键组件：

- uni-app编译器至最新稳定版

- iOS平台特定依赖

- 原生插件兼容层

4. 重建生产包

- 清理项目缓存：菜单【运行】→【清理项目缓存】

- 重新生成iOS证书文件（建议更新为2024年签发的证书）

- 使用【发行】→【原生App-云打包】生成新二进制文件

验证要点：

完成上述步骤后，通过HBuilder控制台检查构建日志，确认包含以下信息：

> Using iOS SDK version: 18.0+

> Xcode version: 16.0+

补充说明：

若使用自定义原生插件，需同步更新插件代码至适配iOS 18的版本。建议在真机调试阶段使用Xcode 16连接设备进行兼容性验证，避免因API变更导致的运行时异常。

dcloud 社区的讨论: ITMS-90725: SDK version issue,app was built with the iOS 17.5 SDK,must iOS 18 SDK or later 错误解决办法 - DCloud问答