asc-id-resolver

asc-id-resolver

热门

使用 asc 从人类友好的名称解析 App Store Connect ID(应用、构建版本、应用和数字商品版本、群组、测试员)。当命令需要 ID 时使用。

939Star
49Fork
更新于 2026/7/21
SKILL.md
readonly只读
name
asc-id-resolver
description

使用 asc 从人类友好的名称解析 App Store Connect ID(应用、构建版本、应用和数字商品版本、群组、测试员)。当命令需要 ID 时使用。

asc id resolver

使用此技能将名称映射为其他命令所需的 ID。

应用 ID

  • 按 Bundle ID 或名称:
    • asc apps list --bundle-id "com.example.app"
    • asc apps list --name "My App"
  • 获取所有应用:
    • asc apps list --paginate
  • 设置默认应用:
    • ASC_APP_ID=...

构建版本 ID

  • 最新构建版本:
    • asc builds info --app "APP_ID" --latest --version "1.2.3" --platform IOS
  • 最近的构建版本:
    • asc builds list --app "APP_ID" --sort -uploadedDate --limit 5

版本 ID

  • asc versions list --app "APP_ID" --paginate

数字商品版本 ID

API 4.4.1 版本 ID 与 IAP 产品、订阅和订阅组 ID 不同:

首先解析所属资源:

  • IAP:asc iap list --app "APP_ID" --paginate --output json
  • 订阅组:asc subscriptions groups list --app "APP_ID" --paginate --output json
  • 订阅:asc subscriptions list --app "APP_ID" --paginate --output json
    asc subscriptions list --group-id "GROUP_ID" --paginate --output json

然后解析其版本 ID:

  • IAP 版本:asc iap versions list --iap-id "IAP_ID" --paginate --output json
  • 订阅版本:asc subscriptions versions list --subscription-id "SUB_ID" --paginate --output json
  • 订阅组版本:asc subscriptions groups versions list --group-id "GROUP_ID" --paginate --output json

从对应的版本子树解析子本地化或图片 ID:

  • IAP 本地化:asc iap versions localizations list --version-id "VERSION_ID" --paginate --output json
  • IAP 主图片:asc iap versions image --version-id "VERSION_ID" --output json
  • IAP 图片集合:asc iap versions images list --version-id "VERSION_ID" --paginate --output json
  • 订阅本地化:asc subscriptions versions localizations list --version-id "VERSION_ID" --paginate --output json
  • 订阅主图片:asc subscriptions versions images primary --version-id "VERSION_ID" --output json
  • 订阅图片集合:asc subscriptions versions images list --version-id "VERSION_ID" --paginate --output json
  • 订阅组本地化:asc subscriptions groups versions localizations list --version-id "VERSION_ID" --paginate --output json

TestFlight ID

  • 群组:
    • asc testflight groups list --app "APP_ID" --paginate
  • 测试员:
    • asc testflight testers list --app "APP_ID" --paginate

预发布版本 ID

  • asc testflight pre-release list --app "APP_ID" --platform IOS --paginate

审核提交 ID

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

输出提示

  • 默认输出根据终端环境自适应:在终端中显示表格,在管道或 CI 中显示压缩 JSON。显式指定 --output 优先。
  • 自动化场景使用显式 --output json,仅在需要人类可读的 JSON 时添加 --pretty
  • 人类查看时,使用 --output table--output markdown

安全护栏

  • 在列表命令中优先使用 --paginate 以避免遗漏 ID。
  • 在可用的情况下使用 --sort 使结果确定性。