Starting April 28, 2026, Apple requires every app and app update uploaded to App Store Connect to be built with Xcode 26 or later, using the iOS 26 SDK or the matching 26 SDKs for iPadOS, tvOS, visionOS, and watchOS. If you ship a Capacitor app, this is the deadline that matters.
The good news: for most teams, this is a build environment change, not a full app migration. And if you already use 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上重建并测试一个新的存档,然后在下一个发布前测试。
这里的故障模式很简单:在开发中,可能仍然会工作,但如果构建来自较旧的Xcode版本,App Store Connect将阻止上传。
Capgo Build Is Already on Xcode 26
如果您使用 Capgo Build,则不需要为苹果的截止日期更新构建环境。截至2026年4月29日,我们的当前iOS构建系统已经通过 Capgo Build.
That means teams using Capgo Build are already aligned with Apple’s April 28, 2026 submission requirement. No local Mac refresh, no runner image hunt, and no last-minute Xcode upgrade just to keep shipping.
当您仍然需要采取行动时
如果以下情况之一适用,您仍然需要进行更改:
- 您在本地构建和存档iOS应用,并尚未迁移到Xcode 26或更高版本。
- 您的自主管理CI管道被锁定在一个旧的Xcode图像上,而不是Xcode 26。
- 其中一个本地SDK或插件在重建时会遇到iOS 26 SDK 的问题。
如果这是您的设置,请先更新工具链,然后运行一次清洁构建和TestFlight提交,最后再计划生产发布。
最终结果
这是苹果正常的每年工具链截止日期,但执行日期是真实的: 自2026年4月28日起,更老的Xcode构建不再足以用于App Store上传。
如果您使用Capgo Build,则已经迁移到Xcode 26或更高版本。如果您在其他地方构建,请在下一个iOS发布之前更新您的环境到Xcode 26或更高版本。
从苹果的Xcode 26要求继续Capacitor 应用
如果您正在使用 Apple’s Xcode 26 Requirement for Capacitor Apps 为__CAPGO_KEEP_0__应用 Capgo CI/CD Capgo CI/CD 为Capgo CI/CD中的产品工作流程 Capgo Native Builds 为Capgo Native Builds中的产品工作流程 Capgo Integrations 为__CAPGO_KEEP_0__ Integrations中的产品工作流程 CI/CD集成 GitHub Actions Integration 为 GitHub Actions Integration 的实现细节。