跳到正文

← 全部工具

给 Apple 开发者的免费参考

App Store 的 Xcode 与 SDK 版本要求

自 2026 年 4 月 28 日起,App Store Connect 只接受用 Xcode 26 或更高版本、并使用 iOS 26、iPadOS 26、tvOS 26、visionOS 26 或 watchOS 26 SDK 构建的新 App 和更新;Apple 没有规定 Mac App 的 SDK 最低版本。Apple 已公布下一步:2027 年 4 月起需要 27 系列 SDK,它们最早随 Xcode 27 提供。下面是各平台的现行最低要求、Apple 公布的所有期限、Xcode 14 到 27.2 每个版本的 SDK、运行所需 macOS 和 Swift 版本,以及一个可以查任意 Xcode 和日期的检查器。

现在的要求

2026年10月31日 时 App Store Connect 对新上传和更新的要求,按平台列出。

平台最低 SDK最低 Xcode生效日期来源
iOSiOS 26 SDK 或更高Xcode 26 或更高2026年4月28日Apple 公告
iPadOSiPadOS 26 SDK 或更高Xcode 26 或更高2026年4月28日Apple 公告
macOSApple 未说明Apple 未说明––
tvOStvOS 26 SDK 或更高Xcode 26 或更高2026年4月28日Apple 公告
visionOSvisionOS 26 SDK 或更高Xcode 26 或更高2026年4月28日Apple 公告
watchOSwatchOS 26 SDK 或更高Xcode 26 或更高2026年4月28日Apple 公告

Apple 关于 SDK 最低版本的公告只提到 iOS、iPadOS、tvOS、visionOS 和 watchOS,没有一条提到 macOS,所以本页不给出 Mac App 的最低 Xcode。

“Apps uploaded to App Store Connect must be built with Xcode 26 or later using an SDK for iOS 26, iPadOS 26, tvOS 26, visionOS 26, or watchOS 26.”

下一次变化:从 2027年4月(Apple 没有给出具体日期) 起,需要 iOS 27, iPadOS 27, tvOS 27, visionOS 27, watchOS 27 SDK。

其他正在生效的上传规则

  • 2024年5月1日
    列出的 API 需要写明批准的理由

    使用 Apple 清单中 API 的 App(包括其中的第三方 SDK)必须在隐私清单里写明批准的理由,否则上传会被拒。

    Apple 原文(英文)
    You’ll need to include approved reasons for the listed APIs used by your app’s code (including from third-party SDKs) to upload a new or updated app to App Store Connect.
  • 2025年2月18日
    Mac App 里不能带隔离属性
    macOS

    上传前要去掉 Mac App 中每个文件的 com.apple.quarantine 扩展属性。

    Apple 原文(英文)
    macOS apps distributed on TestFlight and the App Store shouldn’t include the quarantine extended file attribute com.apple.quarantine. Starting February 18, you must remove this attribute from all files within macOS apps in order to upload to App Store Connect.
  • 2026年4月(Apple 没有给出具体日期)
    watchOS App 必须支持 64 位
    watchOS

    watchOS App 必须包含 64 位代码,并用 watchOS 26 SDK 构建。

    Apple 原文(英文)
    Beginning April 2026, watchOS apps uploaded to App Store Connect must also include 64-bit support and be built with the watchOS 26 SDK.
  • 2026年9月9日
    部署目标须为 iOS 13 或更高
    iOS · iPadOS

    iOS 和 iPadOS App 的最低部署目标必须是 iOS 13 或更高。

    Apple 原文(英文)
    iOS and iPadOS apps uploaded to App Store Connect must target iOS 13 or later.

即将生效

截至 2026年10月31日 尚未到期、Apple 已公布期限的要求,按日期先后排列。

  • 2027年2月1日
    旧的 Developer ID 证书颁发机构到期App Store 以外
    macOS

    用原 Developer ID Sub-CA 签发的证书签名的 Mac 软件到期后无法使用,用它签名的安装包将无法安装。请从 G2 颁发机构创建新证书并重新签名。

    Apple 原文(英文)
    The original Developer ID Certification Authority (Sub-CA) expires on February 1, 2027. Certificates issued by this authority will stop working on that date.
  • 2027年4月(Apple 没有给出具体日期)
    27 系列 SDK
    iOS · iPadOS · tvOS · visionOS · watchOS

    iOS、iPadOS、tvOS、visionOS 和 watchOS App 必须用 27 系列或更高的 SDK 构建。在 Apple 的表中,Xcode 27 是第一个带这些 SDK 的版本。

    Apple 原文(英文)
    Starting April 2027, apps and games uploaded to App Store Connect need to meet the following minimum requirements: iOS and iPadOS apps must be built with the iOS 27 & iPadOS 27 SDK or later; tvOS apps must be built with the tvOS 27 SDK or later; visionOS apps must be built with the visionOS 27 SDK or later; watchOS apps must be built with the watchOS 27 SDK or later.
  • 2027年4月(Apple 没有给出具体日期)
    iPhone Duo 截图
    iOS

    提交的每个 App 或游戏都必须包含 iPhone Duo 截图。

    Apple 原文(英文)
    Starting April 2027, any apps or games submitted will need to include screenshots for iPhone Duo.

这个 Xcode 现在还能上传吗?

选一个 Xcode 版本和一个日期。答案来自本页的 SDK 最低要求和发布日期。

只限部分平台。2026年10月31日 时 Xcode 16.4 可以上传的平台:macOS。

  • iOS 会被拒:带的是 iOS 18.5 SDK;自 2026年4月28日 起 Apple 要求 26 或更高。
  • iPadOS 会被拒:带的是 iPadOS 18.5 SDK;自 2026年4月28日 起 Apple 要求 26 或更高。
  • macOS 可以:那天 Apple 对 macOS 没有 SDK 最低要求。
  • tvOS 会被拒:带的是 tvOS 18.5 SDK;自 2026年4月28日 起 Apple 要求 26 或更高。
  • visionOS 会被拒:带的是 visionOS 2.5 SDK;自 2026年4月28日 起 Apple 要求 26 或更高。
  • watchOS 会被拒:带的是 watchOS 11.5 SDK;自 2026年4月28日 起 Apple 要求 26 或更高。

这里只检查 SDK 最低要求。构建仍可能因为其他原因被拒,例如隐私清单缺少条目。

Xcode 版本、SDK、macOS 与 Swift

Apple《SDK and system requirements》表中的每一行,新版本在前。Apple 的表从 Xcode 14 开始。发布日期来自 Apple 的 Releases 页面。 Apple 原表 · Apple Releases 页面

Xcode发布日期iOS / iPadOS SDKmacOS SDKtvOS SDKwatchOS SDKvisionOS SDK运行所需 macOSSwiftiOS 部署目标发布说明
Xcode 27.2
27B52
2026年10月29日27.227.227.227.227.2macOS Tahoe 26.6 or later6.4
语言模式 6, 5, 4.2, 4
15–27说明
Xcode 27.1
27A9275
2026年10月15日27.127272727macOS Tahoe 26.6 or later6.4
语言模式 6, 5, 4.2, 4
15–27说明
Xcode 27
27A266a
2026年9月14日2727272727macOS Tahoe 26.6 or later6.4
语言模式 6, 5, 4.2, 4
15–27说明
Xcode 26.6
17F113
2026年6月25日26.526.526.526.526.5macOS Tahoe 26.2 - macOS Tahoe 26.x6.3
语言模式 6, 5, 4.2, 4
15–26.5说明
Xcode 26.5
17F42
2026年5月11日26.526.526.526.526.5macOS Tahoe 26.2 - macOS Tahoe 26.x6.3
语言模式 6, 5, 4.2, 4
15–26.5说明
Xcode 26.4.1
17E202
2026年4月16日26.426.426.426.426.4macOS Tahoe 26.2 - macOS Tahoe 26.x6.3
语言模式 6, 5, 4.2, 4
15–26.4说明
Xcode 26.3
17C529
2026年2月26日26.226.226.226.226.2macOS Sequoia 15.6 - macOS Tahoe 26.x6.2.3
语言模式 6, 5, 4.2, 4
15–26.2说明
Xcode 26.2
17C52
2025年12月12日26.226.226.226.226.2macOS Sequoia 15.6 - macOS Tahoe 26.x6.2.3
语言模式 6, 5, 4.2, 4
15–26.2说明
Xcode 26.1.1
17B100
2025年11月11日26.126.126.126.126.1macOS Sequoia 15.6 - macOS Tahoe 26.x6.2.1
语言模式 6, 5, 4.2, 4
15–26.1说明
Xcode 26.1
17B55
2025年11月3日26.126.126.126.126.1macOS Sequoia 15.6 - macOS Tahoe 26.x6.2.1
语言模式 6, 5, 4.2, 4
15–26.1说明
Xcode 26.0.1
17A400
2025年9月22日2626262626macOS Sequoia 15.6 - macOS Tahoe 26.x6.2
语言模式 6, 5, 4.2, 4
15–26说明
Xcode 26
17A324
2025年9月15日2626262626macOS Sequoia 15.6 - macOS Tahoe 26.x6.2
语言模式 6, 5, 4.2, 4
15–26说明
Xcode 16.4
16F6
2025年5月28日18.515.518.511.52.5macOS Sequoia 15.3 - macOS Tahoe 26.1.x6.1
语言模式 6, 5, 4.2, 4
15–18说明
Xcode 16.3
16E140
2025年3月31日18.415.418.411.42.4macOS Sequoia 15.2 - macOS Sequoia 15.x6.1
语言模式 6, 5, 4.2, 4
15–18说明
Xcode 16.2
16C5032a
2024年12月11日18.215.218.211.22.2macOS Sonoma 14.5 - macOS Sequoia 15.x6.0
语言模式 6, 5, 4.2, 4
15–18说明
Xcode 16.1
16B40
2024年10月28日18.115.118.111.12.1macOS Sonoma 14.5 - macOS Sequoia 15.x6.0
语言模式 6, 5, 4.2, 4
15–18说明
Xcode 16
16A242d
2024年9月16日181518112macOS Sonoma 14.5 - macOS Sequoia 15.x6.0
语言模式 6, 5, 4.2, 4
15–18说明
Xcode 15.4
15F31d
2024年5月13日17.514.517.510.51.2macOS Sonoma 14.x5.10
语言模式 5, 4.2, 4
12–17.5说明
Xcode 15.3
15E204a
2024年3月5日17.414.417.410.41macOS Sonoma 14.x5.10
语言模式 5, 4.2, 4
12–17.4说明
Xcode 15.2
15C500b
2024年1月8日17.214.217.210.21macOS Ventura 13.5 - macOS Sonoma 14.x5.9
语言模式 5, 4.2, 4
12–17.2说明
Xcode 15.1*
15C65
2023年12月11日17.214.217.210.21macOS Ventura 13.5 - macOS Sonoma 14.x5.9
语言模式 5, 4.2, 4
12–17.2说明
Xcode 15.0.x
15A240d
2023年9月18日17141710–macOS Ventura 13.5 - macOS Sonoma 14.x5.9
语言模式 5
12–17说明
Xcode 14.3.1
14E300c
2023年6月1日16.413.316.49.4–macOS Ventura 13.x5.8.1
语言模式 5, 4.2, 4
11–16.4说明
Xcode 14.3*
14E222b
2023年3月30日16.413.316.49.4–macOS Ventura 13.x5.8
语言模式 5, 4.2, 4
11–16.4说明
Xcode 14.2
14C18
2022年12月13日16.213.116.19.1–macOS Monterey 12.5 - macOS Ventura 13.x5.7
语言模式 5, 4.2, 4
11–16.2说明
Xcode 14.1
14B47b
2022年11月1日16.11316.19.1–macOS Monterey 12.5 - macOS Ventura 13.x5.7
语言模式 5, 4.2, 4
11–16.1说明
Xcode 14.0.x
14A309
2022年9月12日1612.3169–macOS Monterey 12.5 - macOS Ventura 13.x5.7
语言模式 5, 4.2, 4
11–16说明

* Apple 在表下的注释:“The iOS 15 and watchOS 8 Simulators are not supported on macOS Sonoma 14.x.”

Apple 对“部署目标”一列的定义:“The OS range supported by this version of Xcode for uploading apps to App Store Connect.”

已于 2026年10月30日 对照 Apple 页面核对。

它是怎么工作的

  • •每个数值都照抄自 Apple 自己的页面:Xcode 支持页上的《SDK and system requirements》表、Upcoming Requirements 页面和 Apple Developer News 公告。没有使用维基百科或其他网站的数据,每一行都链接到对应的 Apple 来源。
  • •Apple 已从 Upcoming Requirements 页面撤下的要求(2022 年的 Xcode 13 要求和 2025 年的 Xcode 16 要求)读取自该页面的存档,并按存档链接。
  • •发布日期来自 Apple 的 Releases 页面,较早的来自它的存档。Apple 的表从 Xcode 14 开始,时间线也从这里开始。
  • •Apple 只给出月份的(“Starting April 2027”),页面会注明;检查器对该月内的日期回答“不确定”。
  • •检查器找出你选的那天每个平台正在生效的 SDK 要求,和该 Xcode 自带的 SDK 比较(iPadOS App 使用 iOS SDK),Apple 写明 Xcode 版本时也一并比较。
  • •已于 2026 年 10 月 30 日对照 Apple 页面核对。Apple 发布新 Xcode 或公布新要求时,我们会重新核对。

它做不到的事

  • •不列出 Xcode 14 之前的版本和测试版;Apple 的表里都没有。
  • •不用其他网站的数据补空。Apple 没有说明的值,格子里写“Apple 未说明”。
  • •不检查 App 审核的其他方面:隐私清单、截图、元数据或审核指南。
  • •不是实时消息。想看 Apple 最新发布的公告,请看下方链接的 Apple 更新页面。
  • •不读取你的项目或 Xcode。你的版本号在 Xcode > About Xcode 里查看。

常见问题

2026 年提交 App 需要什么版本的 Xcode?
自 2026 年 4 月 28 日起,需要 Xcode 26 或更高版本,并使用 iOS 26、iPadOS 26、tvOS 26、visionOS 26 或 watchOS 26 SDK。Xcode 26 到 27.2 的任何正式版都满足。Apple 已公布:从 2027 年 4 月起 App 必须用 27 系列或更高的 SDK 构建,按 Apple 的表就是 Xcode 27 或更高;具体日期 Apple 尚未给出。
用新 SDK 构建时,还能支持旧版 iOS 吗?
可以。SDK 决定你能调用哪些 API;部署目标决定 App 能安装的最低 iOS 版本。Apple 的表中 Xcode 26 的 iOS 部署目标是 15 到 26,Xcode 27 是 15 到 27,所以仍然可以支持 iOS 15。新 API 用 #available 判断。另外,自 2026 年 9 月 9 日起,Apple 要求 iOS 和 iPadOS App 的部署目标为 iOS 13 或更高。
部署目标和 SDK 有什么区别?
SDK 是 Xcode 构建时用的系统框架,随 Xcode 一起提供:Xcode 26.6 带的是 iOS 26.5 SDK。部署目标是你自己选的构建设置:App 能运行的最低系统版本。Apple 的上传规则针对的是 SDK(也就是 Xcode 版本);iOS 13 那条规则针对的是部署目标。
用旧版 Xcode 上传会怎样?
App Store Connect 在上传时就会拒收这个构建,它进不了 TestFlight,也到不了审核。Apple 的规则针对的是上传,没有涉及已经在 App Store 上的版本;下一次更新必须用足够新的 Xcode 构建。
运行 Xcode 26 或 Xcode 27 需要什么版本的 macOS?
按 Apple 的表:Xcode 26 到 26.3 可在 macOS Sequoia 15.6 或更高版本上运行;Xcode 26.4.1 到 26.6 需要 macOS Tahoe 26.2;Xcode 27、27.1 和 27.2 需要 macOS Tahoe 26.6 或更高。停留在 Sequoia 的 Mac 最高能用 Xcode 26.3,它满足现行要求,但不满足 2027 年 4 月的要求。
Mac App 有最低 Xcode 要求吗?
Apple 关于 SDK 最低版本的公告都没有提到 macOS,只涉及 iOS、iPadOS、tvOS、visionOS 和 watchOS。Mac App 有自己的上传规则:自 2025 年 2 月 18 日起,App 中任何文件都不能带 com.apple.quarantine 属性。

相关页面