从 2026 年 4 月 28 日起,Apple 要求所有上传到 App Store Connect 的 App 和 App 更新都必须使用 Xcode 26 或更高版本构建,并使用 iOS 26 SDK 或对应的 iPadOS、tvOS、visionOS 和 watchOS 26 SDK。如果你发布的是 Capacitor App,这就是关键截止日期。
好消息是:对于大多数团队来说,这只是构建环境的变更,而非完整的 App 迁移。如果你已经在使用 Capgo 构建,你的 iOS 构建系统已在使用 Xcode 26。
Apple 改了什么
Apple 已在其 即将生效的要求 页面中公布了这一要求,并会在 App Store 提交 页面中再次说明。
从 2026 年 4 月 28 日起,App Store Connect 将不再接受使用低于 Xcode 26 的版本构建、或缺少所需 26 SDK 的上传包。已在 App Store 上架的现有应用仍可正常使用,但你下次提交的二进制文件必须由新的工具链构建。
这对 Capacitor 团队意味着什么
对于大多数 Capacitor 应用,这主要关乎你的构建方式,而不是要替换 Capacitor 或重写你的项目。
请确保所有构建路径都使用 Xcode 26 或更高版本:
- 本地 Mac 构建:安装并选择 Xcode 26 或更高版本。
- 自托管 CI:使用包含 Xcode 26 或更高版本的 macOS runner 镜像。
- 原生依赖和旧版插件:在新的 SDK 上重新构建,并在下次发布前测试全新的 archive。
这里的失败模式很简单:开发环境可能一切正常,但如果构建使用的是旧版 Xcode,App Store Connect 将会拦截你的 upload。
Capgo Build 已用上 Xcode 26
如果你使用 Capgo 构建 进行构建,你无需为了应对 Apple 的这个截止日期而手忙脚乱地更新构建环境。截至 2026 年 4 月 29 日,我们目前的 iOS 构建系统已通过 Capgo 构建.
运行在 Xcode 26 或更高版本上。这意味着使用 Capgo Build 的团队已经符合 Apple 2026 年 4 月 28 日的提交要求。无需更新本地 Mac,无需寻找 runner 镜像,也无需为了维持发布而进行临时的 Xcode 升级。
何时仍需采取行动
如果符合以下任一情况,你仍需做出调整:
- 你在本地构建并归档 iOS 应用,且尚未迁移到 Xcode 26 或更高版本。
- 你的自管理 CI pipeline 锁定在低于 Xcode 26 的旧版 Xcode 镜像上。
- 你的某个原生 SDK 或 plugin 用 iOS 26 SDK 重新构建时出现问题。
如果属于这种情况,请先更新 toolchain,然后执行 clean build 并提交 TestFlight,再规划生产发布。
总结
这是 Apple 每年例行的 toolchain 截止,但强制执行日期是实打实的: 自 2026 年 4 月 28 日起,旧版 Xcode 构建已不足以用于 App Store 上传。
如果你使用 Capgo Build,则已在使用 Xcode 26 或更高版本。如果你在其他环境构建,请在下次 iOS 发布前将环境更新至 Xcode 26 或更高版本。
继续阅读:Apple 对 Capacitor 应用的 Xcode 26 要求
如果你正在使用 Apple Xcode 26 对 Capacitor 应用的新要求 规划 CI/CD 自动化,并将其与 Capgo CI/CD 用于 Capgo CI/CD 中的产品工作流, Capgo Native Build 用于 Capgo Native Builds 中的产品工作流, Capgo 集成 用于 Capgo 集成中的产品工作流, CI/CD 集成 了解 CI/CD 集成的实现细节,以及 GitHub Actions 集成 有关 GitHub Actions 集成的实现细节。