跳转至正文

Apple Xcode 26 对 Capacitor App 的要求

Apple 现在要求提交到 App Store Connect 时必须使用 Xcode 26 和 iOS 26 SDK。以下是 Capacitor 团队需要了解的变化,以及为什么 Capgo Build 用户已经无需额外处理。

Apple Xcode 26 对 Capacitor App 的要求

从 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 集成的实现细节。

为 Capacitor 应用提供 Live Updates

当 Web 层出现线上 Bug 时,通过 Capgo 发布修复,而不用等 App Store 审核好几天。用户会在后台收到更新,原生变更则仍走正常审核流程。

博客最新动态

Capgo 为你提供打造真正专业的移动应用所需的最有价值的洞察。