从2026年4月28日起,Apple要求所有上传到App Store Connect的应用和应用更新都必须使用Xcode 26或更高版本,使用iOS 26SDK或匹配的26 SDKs(iPadOS、tvOS、visionOS和watchOS)。如果您发布Capacitor应用,这是截止日期。
好消息:对于大多数团队来说,这是一个构建环境的变化,而不是一个完整的应用迁移。并且,如果您已经使用 Capgo Build__CAPGO_KEEP_0__ 的 iOS 构建系统已经升级到 Xcode 26。
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运行器映像。
- 本地依赖项和旧插件:在新SDK上重建并测试一个新的存档,然后在下一个发布前测试。
这里的故障模式很简单:在开发中,可能仍然会工作,但App Store Connect会阻止上传,如果构建来自较旧的Xcode线。
Capgo Build已在Xcode 26上运行
如果您使用 Capgo Build,则不需要为苹果的截止日期更新您的构建环境。截至2026年4月29日,我们的当前iOS构建系统已在Xcode 26或更高版本上运行,通过 Capgo Build.
。这意味着使用Capgo Build的团队已经与苹果的2026年4月28日提交要求保持一致。无需本地Mac刷新、无需运行器映像搜索、无需在最后一刻升级Xcode,只要继续发布。
当您仍需要采取行动
如果以下情况之一适用,您仍需要进行更改:
- 您在本地构建和存档 iOS 应用,并尚未迁移到 Xcode 26 或更高版本。
- 您的自管理 CI pipeline pinned 到一个旧的 Xcode 图像比 Xcode 26 更早。
- 其中一个本地 SDK 或插件在重建 iOS 26 时遇到问题:SDK。
如果这是您的设置,请先更新工具链,然后运行清洁构建和 TestFlight 提交,最后再计划生产发布。
最后一版
这是苹果的正常每年工具链截止日期,但执行日期是真实的: 自 2026 年 4 月 28 日起,旧的 Xcode 构建不再足以用于 App Store 上传。
如果您使用 Capgo Build,则已经在 Xcode 26 或更高版本。如果您在其他地方构建,请在下一个 iOS 发布之前更新您的环境到 Xcode 26 或更高版本。