asc-id-resolver

asc-id-resolver

熱門

使用 asc 從人類可讀的名稱解析 App Store Connect ID(應用程式、建置、應用程式與數位商品版本、群組、測試人員)。當指令需要 ID 時使用。

939星標
49分支
更新於 2026/7/21
SKILL.md
readonlyread-only
name
asc-id-resolver
description

Resolve App Store Connect IDs (apps, builds, app and digital-goods versions, groups, testers) from human-friendly names using asc. Use when commands require IDs.

asc id resolver

使用此技能將名稱對應到其他指令所需的 ID。

App ID

  • 依 bundle ID 或名稱:
    • asc apps list --bundle-id "com.example.app"
    • asc apps list --name "My App"
  • 取得全部:
    • asc apps list --paginate
  • 設定預設值:
    • ASC_APP_ID=...

Build ID

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

Version 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

輸出提示

  • 輸出預設值會依 TTY 調整:在終端機中顯示表格,在管道或 CI 中顯示最小化 JSON。明確的 --output 優先。
  • 自動化時使用明確的 --output json,僅在需要人類可讀的 JSON 時加上 --pretty
  • 供人類檢視時,使用 --output table--output markdown

防護措施

  • 在列表指令中優先使用 --paginate,以避免遺漏 ID。
  • 在可用之處使用 --sort,讓結果具有確定性。