asc-submission-health

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

ASC Submission Health

ASC提交健康检查

Use this skill to reduce review submission failures and monitor status.

使用该技能可减少审核提交失败并监控状态。

Preconditions

前置条件

Auth configured and app/version/build IDs resolved.
Build is processed (not in processing state).
All required metadata is complete.

已配置认证信息，且已解析应用/版本/构建ID。
构建版本已处理完成（非处理中状态）。
所有必填元数据已完善。

Pre-submission Checklist

提交前检查清单

1. Verify Build Status

1. 验证构建版本状态

bash

asc builds info --build "BUILD_ID"

Check:

```
processingState
```
is
```
VALID
```
```
usesNonExemptEncryption
```
- if
```
true
```
, requires encryption declaration

bash

asc builds info --build "BUILD_ID"

检查：

```
processingState
```
为
```
VALID
```
```
usesNonExemptEncryption
```
- 若为
```
true
```
，则需要加密声明

2. Encryption Compliance

2. 加密合规性

usesNonExemptEncryption: true

bash

undefined

如果

usesNonExemptEncryption: true

：

bash

undefined

List existing declarations

列出现有声明

asc encryption declarations list --app "APP_ID"

Create declaration if needed

如有需要，创建声明

asc encryption declarations create
--app "APP_ID"
--app-description "Uses standard HTTPS/TLS"
--contains-proprietary-cryptography=false
--contains-third-party-cryptography=true
--available-on-french-store=true

Assign to build

关联到构建版本

asc encryption declarations assign-builds
--id "DECLARATION_ID"
--build "BUILD_ID"


**Better approach:** Add `ITSAppUsesNonExemptEncryption = NO` to Info.plist and rebuild.

asc encryption declarations assign-builds
--id "DECLARATION_ID"
--build "BUILD_ID"


**更优方案：** 在Info.plist中添加`ITSAppUsesNonExemptEncryption = NO`并重新构建。

3. Content Rights Declaration

3. 内容权利声明

Required for all App Store submissions:

bash

undefined

所有App Store提交均需完成：

bash

undefined

Check current status

检查当前状态

asc apps get --id "APP_ID" --output json | jq '.data.attributes.contentRightsDeclaration'

Set if missing

若未设置则进行配置

asc apps update --id "APP_ID" --content-rights "DOES_NOT_USE_THIRD_PARTY_CONTENT"

Valid values:
- `DOES_NOT_USE_THIRD_PARTY_CONTENT`
- `USES_THIRD_PARTY_CONTENT`

asc apps update --id "APP_ID" --content-rights "DOES_NOT_USE_THIRD_PARTY_CONTENT"

有效值：
- `DOES_NOT_USE_THIRD_PARTY_CONTENT`
- `USES_THIRD_PARTY_CONTENT`

4. Version Metadata

4. 版本元数据

bash

undefined

bash

undefined

Check version details

检查版本详情

asc versions get --version-id "VERSION_ID" --include-build

Verify copyright is set

验证版权信息已设置

asc versions update --version-id "VERSION_ID" --copyright "2026 Your Company"

undefined

asc versions update --version-id "VERSION_ID" --copyright "2026 Your Company"

undefined

5. Localizations Complete

5. 本地化内容完善

bash

undefined

bash

undefined

List version localizations

列出版本本地化内容

asc localizations list --version "VERSION_ID"

Check required fields: description, keywords, whatsNew, supportUrl

检查必填字段：描述、关键词、更新说明、支持网址

undefined

undefined

6. Screenshots Present

6. 截图已上传

Each locale needs screenshots for the target platform.

每个地区都需要对应目标平台的截图。

7. App Info Localizations (Privacy Policy)

7. 应用信息本地化（隐私政策）

bash

undefined

bash

undefined

List app info IDs (if multiple exist)

列出应用信息ID（若存在多个）

asc app-infos list --app "APP_ID"

Check privacy policy URL

检查隐私政策网址

asc localizations list --app "APP_ID" --type app-info --app-info "APP_INFO_ID"

undefined

asc localizations list --app "APP_ID" --type app-info --app-info "APP_INFO_ID"

undefined

Submit

提交版本

Using Review Submissions API (Recommended)

使用审核提交API（推荐）

bash

undefined

bash

undefined

Create submission

创建提交请求

asc review submissions-create --app "APP_ID" --platform IOS

Add version to submission

为提交请求添加版本

asc review items-add
--submission "SUBMISSION_ID"
--item-type appStoreVersions
--item-id "VERSION_ID"

Submit for review

提交审核

asc review submissions-submit --id "SUBMISSION_ID" --confirm

undefined

asc review submissions-submit --id "SUBMISSION_ID" --confirm

undefined

Using Submit Command

使用提交命令

bash

asc submit create --app "APP_ID" --version "1.2.3" --build "BUILD_ID" --confirm

Use

--platform

when multiple platforms exist.

bash

asc submit create --app "APP_ID" --version "1.2.3" --build "BUILD_ID" --confirm

当存在多个平台时，使用

--platform

参数指定。

Monitor

监控状态

bash

undefined

bash

undefined

Check submission status

检查提交状态

asc submit status --id "SUBMISSION_ID" asc submit status --version-id "VERSION_ID"

List all submissions

列出所有提交请求

asc review submissions-list --app "APP_ID" --paginate

undefined

asc review submissions-list --app "APP_ID" --paginate

undefined

Cancel / Retry

取消 / 重试

bash

undefined

bash

undefined

Cancel submission

取消提交

asc submit cancel --id "SUBMISSION_ID" --confirm

Or via review API

或通过审核API取消

asc review submissions-cancel --id "SUBMISSION_ID" --confirm

Fix issues, then re-submit.

asc review submissions-cancel --id "SUBMISSION_ID" --confirm

修复问题后重新提交。

Common Submission Errors

常见提交错误

"Version is not in valid state"

"Version is not in valid state"（版本状态无效）

Check:

Build is attached and VALID
Encryption declaration approved (or exempt)
Content rights declaration set
All localizations complete
Screenshots present for all locales

检查：

构建版本已关联且状态为VALID
加密声明已通过（或符合豁免条件）
内容权利声明已设置
所有本地化内容已完善
所有地区均已上传截图

"Export compliance must be approved"

"Export compliance must be approved"（出口合规必须通过审核）

The build has

usesNonExemptEncryption: true

. Either:

Upload export compliance documentation
Or rebuild with
```
ITSAppUsesNonExemptEncryption = NO
```
in Info.plist

构建版本的

usesNonExemptEncryption: true

。可选择：

上传出口合规文档
或在Info.plist中添加
```
ITSAppUsesNonExemptEncryption = NO
```
后重新构建

"Multiple app infos found"

"Multiple app infos found"（找到多个应用信息）

Use

--app-info

flag with the correct app info ID:

bash

asc app-infos list --app "APP_ID"

使用

--app-info

参数指定正确的应用信息ID：

bash

asc app-infos list --app "APP_ID"

Notes

注意事项

```
asc submit create
```
uses the new reviewSubmissions API automatically.
Use
```
--output table
```
when you want human-readable status.
macOS submissions follow the same process but use
```
--platform MAC_OS
```
.

```
asc submit create
```
会自动使用新的reviewSubmissions API。
如需易读的状态信息，使用
```
--output table
```
参数。
macOS提交遵循相同流程，但需使用
```
--platform MAC_OS
```
参数。