deployment 03-android-deployment.md

Android 部署 (Android Deployment)

AI Agent Target: Contains workflows for Google Play Console track management, PowerShell automation scripts, and automated version incrementing.
Human Target: 透過自動化腳本將 Android AAB 檔案部署到 Google Play 商店的說明。

Google Play Console 設定

在三個不同的測試軌道間管理部署：

1. 內部測試 (Internal Testing): 快速派發給註冊的 QA 測試人員。
2. 封閉測試 (Closed Testing): 提供給較廣泛的公開測試人員。
3. 正式版 (Production): 最終發布。

PowerShell 編譯腳本

透過客製化 PowerShell 腳本來自動化部署流程。

• build_aab_internal.ps1: 針對內部測試軌道。
• build_aab_closed.ps1: 針對封閉測試軌道。
• build_aab_production.ps1: 發布正式版本。

非互動標記 (Non-interactive Flags):

• -AutoY: 略過所有互動式確認。
• -AutoDeploy: 建置成功後自動執行上傳腳本。

版本管理 (Version Management)

版本號自動遞增，避免因版本衝突導致上傳失敗。

• get_latest_version.py: 從 Play 商店抓取目前最高的 versionCode。
• 自動遞增: 將取得的 versionCode 加 1。
• pubspec.yaml 格式: 必須符合 MAJOR.MINOR.PATCH+BUILD_NUMBER。

自動化 AAB 上傳

deploy_play_store.py

透過 Google Play Developer API 自動上傳 AAB 並發布至指定軌道。

update_listings_only.py

僅更新商店頁面資訊（描述、截圖、發布說明），無需提供新二進位檔案。