需从名称解析 App Store Connect ID…

当其他命令需要 App Store Connect 的 app、build、version、IAP/订阅、TestFlight 或审核提交 ID，而手头只有人类可读名称时使用。

适用场景

解决思路

1. 用 asc 将人类可读名称映射为其他命令所需的 ID。
2. App ID——按 bundle ID 查询：`asc apps list --bundle-id "com.example.app"`
3. App ID——按名称查询：`asc apps list --name "My App"`
4. App ID——分页拉取全部：`asc apps list --paginate`
5. App ID——设置默认值：`ASC_APP_ID=...`
6. Build ID——查最新构建：`asc builds info --app "APP_ID" --latest --version "1.2.3" --platform IOS`
7. Build ID——查最近构建：`asc builds list --app "APP_ID" --sort -uploadedDate --limit 5`
8. Version ID——列出应用版本：`asc versions list --app "APP_ID" --paginate`
9. 数字商品版本 ID——先知道 API 4.4.1 的 version ID 与 IAP 产品 ID、订阅 ID、订阅组 ID 不同。
10. 数字商品版本 ID——先解析所属资源：IAP 列表：`asc iap list --app "APP_ID" --paginate --output json`
11. 数字商品版本 ID——先解析所属资源：订阅组列表：`asc subscriptions groups list --app "APP_ID" --paginate --output json`
12. 数字商品版本 ID——先解析所属资源：订阅列表：`asc subscriptions list --app "APP_ID" --paginate --output json` 或 `asc subscriptions list --group-id "GROUP_ID" --paginate --output json`
13. 数字商品版本 ID——解析 IAP 版本 ID：`asc iap versions list --iap-id "IAP_ID" --paginate --output json`
14. 数字商品版本 ID——解析订阅版本 ID：`asc subscriptions versions list --subscription-id "SUB_ID" --paginate --output json`
15. 数字商品版本 ID——解析订阅组版本 ID：`asc subscriptions groups versions list --group-id "GROUP_ID" --paginate --output json`
16. 数字商品版本 ID——从对应 version 子树解析 IAP 本地化 ID：`asc iap versions localizations list --version-id "VERSION_ID" --paginate --output json`
17. 数字商品版本 ID——从对应 version 子树解析 IAP 主图 ID：`asc iap versions image --version-id "VERSION_ID" --output json`
18. 数字商品版本 ID——从对应 version 子树解析 IAP 图片集合 ID：`asc iap versions images list --version-id "VERSION_ID" --paginate --output json`
19. 数字商品版本 ID——从对应 version 子树解析订阅本地化 ID：`asc subscriptions versions localizations list --version-id "VERSION_ID" --paginate --output json`
20. 数字商品版本 ID——从对应 version 子树解析订阅主图 ID：`asc subscriptions versions images primary --version-id "VERSION_ID" --output json`
21. 数字商品版本 ID——从对应 version 子树解析订阅图片集合 ID：`asc subscriptions versions images list --version-id "VERSION_ID" --paginate --output json`
22. 数字商品版本 ID——从对应 version 子树解析订阅组本地化 ID：`asc subscriptions groups versions localizations list --version-id "VERSION_ID" --paginate --output json`
23. TestFlight ID——查分组：`asc testflight groups list --app "APP_ID" --paginate`
24. TestFlight ID——查测试员：`asc testflight testers list --app "APP_ID" --paginate`
25. 预发布版本 ID——列出预发布版本：`asc testflight pre-release list --app "APP_ID" --platform IOS --paginate`
26. 审核提交 ID——列出审核提交：`asc review submissions list --app "APP_ID" --paginate`
27. 输出提示——默认输出感知 TTY：终端中为表格，管道或 CI 中为压缩 JSON；显式 --output 优先。
28. 输出提示——自动化使用显式 --output json，仅在需要人类可读 JSON 时添加 --pretty。
29. 输出提示——供人查看时使用 --output table 或 --output markdown。
30. 守卫规则——列表命令优先使用 --paginate，避免漏掉 ID。
31. 守卫规则——在可用处使用 --sort，使结果确定。

适用边界 · 注意事项

• 不适用于非 App Store Connect 或非 asc CLI 管理的资源。
• 未安装并认证 asc CLI、或没有目标 App 的访问权限时，不应依赖本技能。
• 已经直接拥有所需 ID，且无需从名称反查或枚举资源时，不必执行这些 list 命令。