App Store 發布自動化 是做什麼的?
透過 App Store Connect API 驅動完整的 iOS App Store 提交流程。設計目標:使用者只需提供一次認證資訊 + 一個 config.json 設定檔,代理程式就能執行所有可自動化的操作,僅在碰到 Apple 確實不提供 API 的少數事項時才中斷使用者。不要要求使用者再次確認已經在設定檔中或具有合理預設值的項目。
運作原則(請先閱讀)
- 設定驅動,而非提示驅動。 所有應用程式內容都存在
config.json中。直接執行指令,不要反覆詢問使用者。 - 只有兩件事僅能透過 UI 操作(Apple 沒有 API):App 隱私權資料收集聲明 與 首次訂閱綁定與提交。工具會偵測到這些情況,並提供精確的點擊操作步驟。其餘所有步驟皆可透過腳本自動化。
- 僅在以下情況才詢問使用者:設定檔缺少必要欄位(告訴使用者具體是哪個欄位)、設定檔中未包含的業務決策(例如訂閱價格、發布時機),或在執行唯一次不可逆轉的操作(最終提交)之前。除此之外,直接繼續執行。
- 冪等性:每個指令都可安全重複執行。
node cli.mjs release可以反覆執行。
架構(遵循 SOLID 原則,以便擴充)
scripts/
cli.mjs 單一進入點/調度器 (node cli.mjs <command>)
lib/ 注入式服務,每個服務負責單一職責
env.mjs 解析並驗證環境變數(認證資訊、應用程式 ID)
jwt.mjs ES256 權杖提供者
client.mjs AscClient — 認證 + HTTP + 統一的錯誤處理
discovery.mjs 透過自然鍵值查找 ASC 資源(不硬編碼 ID)
assets.mjs 保留→上傳→提交二進位檔上傳器
config.mjs 載入並驗證設定檔,列出缺少的項目
log.mjs 結構化結果 + 機器可讀的摘要
context.mjs 組合根(依賴注入)
commands/ 每個任務一個檔案,統一的合約 (請參閱 _contract.md)
新增功能 = 新增 commands/x.mjs(包含元資料 + run(ctx)),並在 cli.mjs 中註冊。
設定(一次性)— 請參閱 references/setup.md
- ASC API 金鑰(App Manager 權限):下載
AuthKey_XXXX.p8,記下金鑰 ID 與發行者 ID。 - 在 ASC 中已存在應用程式記錄(已註冊的 bundle ID)。
ASC_APP_ID= 應用程式 ASC 網址中的數字 ID。 - 已設定 EAS 專案,已執行
eas login。 - 根據
references/config-template.json填寫config.json。隨時驗證:任何指令都會印出缺少的欄位。
環境變數
export ASC_KEY_ID=... ASC_ISSUER_ID=... ASC_P8_PATH=/abs/AuthKey_XXXX.p8 # 將 .p8 加入 gitignore
export ASC_APP_ID=1234567890
export APPSTORE_CONFIG=/abs/config.json
cd scripts # 然後執行:node cli.mjs <command>
操作手冊
1. 檢查狀態
node cli.mjs status # 完整的唯讀概覽
node cli.mjs check # 就緒狀態 + 仍待處理的 UI-only 步驟
2. 建置二進位檔 (EAS)
- 如果
eas build因憑證過期失敗(*