跳到正文
返回博客
·约 3 分钟读完

App Store Connect 构建版本状态:Processing、Missing Compliance 等

App Store Connect 和 TestFlight 里每个构建版本状态的含义和处理方法,Processing 多久算太久,以及 Apple 会发哪些邮件。

上传构建版本后,App Store Connect 会在两个地方显示它。TestFlight 标签页里的 Build Uploads 显示上传本身的进度:Processing(处理中)、Failed(失败)或 Complete(完成)。处理完成后,构建版本列表里会出现它的构建状态,比如 Missing Compliance、Ready to Submit、Testing 或 Expired。Apple 说,如果构建版本"超过 24 小时"还停在 Processing,可能出了问题;处理完成或失败时 Apple 会发邮件。下面逐个列出 Apple 给出的状态、含义和处理方法。

两种状态

  • 上传状态(Build Uploads 区域):交付进行到哪一步。Apple:"The upload status provides detailed insights into delivery progress, including warnings, errors, and other information."(上传状态会详细显示交付进度,包括警告、错误和其他信息。)
  • 构建状态(构建版本列表):这个构建版本现在能拿来做什么。Apple:"The status applies to the build only, not the entire app."(状态只针对这个构建版本,不是整个 App。)

构建状态带颜色。红色表示"you need to perform some action or the build is expired"(需要你处理,或构建版本已过期);黄色表示"some process is ongoing, controlled either by you or by Apple"(某个流程正在进行,可能由你控制,也可能由 Apple 控制);绿色表示"the build is being tested in TestFlight"(正在 TestFlight 中测试)。

App 在 App Store 上的审核状态(Waiting for Review、In Review 等)是版本页面上的另一套状态,本文不涉及。

上传状态:Processing、Failed、Complete

在 TestFlight 标签页选择平台,展开 Build Uploads,看 Status 一列。右上角的 All Statuses 菜单可以按状态筛选。

状态Apple 的说明怎么做
Processing"Your build upload is still being processed."(上传的构建版本仍在处理中。)等邮件。超过 24 小时还是 Processing,就联系 Apple(见下文)。
Failed上传"has finished processing, but encountered an issue"(已处理完,但遇到问题)。点开查看错误,全部修好后重新上传。
Complete"Your build upload has processed successfully and is now ready for testing."(处理成功,可以测试了。)看看有没有警告标记,然后测试或提交。

Apple 页面上的几点说明:

  • 失败的构建号可以再用。 "If the build upload fails, you can reuse the same build number for your next upload."(上传失败时,下次上传可以沿用同一个构建号。)
  • Complete 也可能带警告。 "Even if the status is Complete, there may still be warnings or other details you should review and address before your next upload."(即使状态是 Complete,也可能有需要在下次上传前处理的警告。)
  • 第一次上传。 第一次上传时会在账户里创建测试版 App,但构建版本"needs to be processed in Apple's system before it appears in App Store Connect"(要先在 Apple 的系统里处理完,才会出现在 App Store Connect 中)。

上传失败或 Apple 邮件里出现错误代码,可以粘贴到 ITMS 错误查询工具里看含义。

Processing 要多久

Apple 没有给出通常需要多长时间。它只给了一个该求助的时间点:"If you upload a build and it remains in the Processing state for more than 24 hours, there may be an issue. To resolve the issue, submit a Feedback Assistant ticket or contact us."(上传后超过 24 小时仍在 Processing,可能有问题,请通过反馈助理提交工单或联系 Apple。)

用反馈助理提交时,Apple 指定的分类是 Developer Tools & Resources > TestFlight,并要求附上"version and build numbers, upload date and time, and relevant logs"(版本号和构建号、上传日期时间以及相关日志)。

处理完成后的构建状态

以下来自 Apple 的 App build statuses 参考页。其中 Invalid Binary 和 Rejected 两个状态,内部测试和外部测试都"Not visible in TestFlight"(在 TestFlight 中不可见)。

状态Apple 的说明怎么做
Invalid BinaryApple 收到了构建版本,但它"didn't meet all the upload requirements"(没有满足全部上传要求)。修好问题后重新上传。错误代码可用 ITMS 错误查询。
Missing Compliance"Your build is missing export compliance documentation. Action is needed."(缺少出口合规信息,需要处理。)回答加密问题(见下文)。
Waiting for Export Compliance Review出口合规文件已提交,正在审核。不用做什么:"No action is needed on your end."
In Compliance Review出口合规文件正在审核。不用做什么。
Ready to Submit可以分发给内部测试员,也可以提交 TestFlight App 审核做外部测试,或提交 App 审核上架。加内部测试员、加进外部群组,或关联到版本。
Waiting for Review已提交 TestFlight App 审核。等待;通过后才能做外部测试。
In Beta Review正在接受 TestFlight App 审核。等待。
Not Available for Testing描述文件"is missing an application identifier"(缺少应用标识符)。上传一个包含应用标识符的新构建版本。
Expired已超过"90-day availability window"(90 天可用期)。上传新构建版本继续测试。
Rejected被 TestFlight App 审核拒绝,"can no longer be used in TestFlight"(不能再用于 TestFlight)。修好问题,上传新构建版本。
Ready to Test测试员可以用了,"but you haven't added any testers yet"(但你还没加测试员)。加群组或测试员。你可能选择了审核通过后自己通知测试员。
Testing至少有一个群组或测试员在测试。继续测试,或把版本提交 App 审核。

关于 Testing,Apple 提到:已收到邀请的测试员"will still be able to test your build even after it's available for customers"(在 App 上架后仍可继续测试这个构建版本)。想提前结束,可以在构建版本页面点 Expire Build,之后"The build no longer allows internal and external testers to install it."(内部和外部测试员都不能再安装。)

测试员、群组和 TestFlight App 审核的细节,见 TestFlight 清单。

Missing Compliance

这是大多数人最先遇到的状态。每个构建版本都要说明是否使用加密。处理方法:

  1. 在 TestFlight 标签页打开缺少合规信息的构建版本。
  2. 点 Manage 回答问题,或点 Choose File 上传之前已获批的文件。
  3. 如果需要提交文件,Apple 会引导你到 App Encryption 页面,并给你一个要填进 Xcode 的键值。

不想每次上传都被问一遍,Apple 说可以在 Xcode 里的 Info.plist 中声明加密使用情况,这样"eliminates the need to answer encryption questions with each app submission"(就不用每次提交都回答加密问题)。App 加密与出口合规工具会带你回答这些问题,并给出 Info.plist 条目。

提交 App Store 时也一样。Apple:"If you select a build with the Missing Compliance status, you must answer the export compliance questions before submitting for review."(选中 Missing Compliance 状态的构建版本时,必须先回答出口合规问题才能提交审核。)

Apple 会发的邮件

  • 上传进度。 "In addition to status updates in App Store Connect, you'll also receive email notifications when your build is Processing, Failed, or Complete."(除了 App Store Connect 里的状态,构建版本处于 Processing、Failed 或 Complete 时你还会收到邮件。)
  • 处理完成。 上传页面也写了:"You'll receive an email when this process is complete."(处理完成时你会收到邮件。)
  • 下载体积过大。 任何设备变体超过"the 200 MB over-the-air download limit"(200 MB 蜂窝网络下载上限)时,App Store Connect 会显示黄色警告图标,"Apple also sends you an email with this information"(Apple 也会发邮件说明)。
  • App 状态变化。 App Status Reports 用户通知"Provides email alerts when an app changes state"(App 状态变化时发邮件提醒),适用角色为 Account Holder、Admin、App Manager、Developer 和 Marketing。

Apple 的帮助页面没有说明上传邮件发给团队里的哪些人,也没有给出邮件的具体内容。

选择审核构建版本时找不到某个构建

给 App 版本添加构建版本时,Apple 说:"If an earlier version of your app is Ready for Distribution, the list only includes builds you have uploaded since that version was released on the App Store."(如果之前的版本已是 Ready for Distribution,列表里只显示该版本上架之后上传的构建版本。)每个版本只能关联一个构建版本,提交前可以随时更换。Apple 还提到"Some builds may no longer appear after the app is released."(App 发布后,有些构建版本可能不再显示。)

常见问题

构建版本处理要多久?

Apple 没有公布通常的时长。它只说超过 24 小时还在 Processing 可能有问题,这时应通过反馈助理提交工单或联系 Apple。

Failed 和 Invalid Binary 有什么区别?

Failed 是 Build Uploads 里的上传状态,点开能看到错误列表。Invalid Binary 是构建状态:Apple 收到了构建版本,但它没有满足全部上传要求。两种情况都是修好后重新上传。

上传失败后构建号还能用吗?

能。Apple:"If the build upload fails, you can reuse the same build number for your next upload."

状态是 Ready to Test,为什么没人收到?

Ready to Test 表示已通过审核,但还没加测试员。加上群组或测试员即可;Apple 提到你可能选择了审核通过后自己通知测试员。

Missing Compliance 会挡住 App Store 提交吗?

会。这个状态的构建版本,必须先回答出口合规问题才能提交审核。

资料来源

均于 2026 年 11 月 1 日查阅。

Apple 的状态和措辞会变化,请以上述页面的最新内容为准。

作者

独立开发者,在 Obelisk Club 做本地优先的 Mac 与 iOS 效率应用。 关于作者 →