从 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 会阻止上传。
Capgo Build 已用上 Xcode 26
如果你使用 Capgo 构建,你无需为这个 Apple 截止日期匆忙更新构建环境。截至 2026 年 4 月 29 日,我们当前的 iOS 构建系统已通过 Capgo 构建.
这意味着使用 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 对 Capacitor 应用的 Xcode 26 要求 规划 CI/CD 自动化,并将其与 Capgo CI/CD 集成 用于 Capgo CI/CD 中的产品工作流, Capgo Native Build 用于 Capgo Native Builds 中的产品工作流, Capgo 集成 用于 Capgo 集成中的产品工作流, CI/CD 集成 了解 CI/CD 集成的实现细节,以及 GitHub Actions 集成 有关 GitHub Actions 集成的实现细节。