gpc-build-lifecycle

ビルドのライフサイクル

ビルドのアップロード、処理の完了待ち、APK／バンドルの管理、難読化解除ファイルのアップロードを行うときに、このスキルを使用します。

バンドル（AAB）

バンドルをアップロードする

gpc bundles upload --file app.aab --track internal --package com.example.app

アップロード済みバンドルの一覧を表示する

gpc bundles list --package com.example.app

バージョンコードでバンドルを検索する

gpc bundles find --version-code 42 --package com.example.app

処理の完了を待つ

gpc bundles wait --version-code 42 --package com.example.app
gpc bundles wait --version-code 42 --timeout 600 --interval 30 --package com.example.app

APK（レガシー）

APKをアップロードする

gpc apks upload --file app.apk --package com.example.app

APKの一覧を表示する

gpc apks list --package com.example.app

難読化解除ファイル

ProGuardマッピングをアップロードする

gpc deobfuscation upload --version-code 42 --file mapping.txt --type proguard --package com.example.app

ネイティブデバッグシンボルをアップロードする

gpc deobfuscation upload --version-code 42 --file symbols.zip --type native-code --package com.example.app

CI/CDビルドパイプライン

一般的なCIフロー：

# 1. Upload bundle
gpc bundles upload --file app.aab --track internal --commit --package com.example.app

# 2. Wait for processing
gpc bundles wait --version-code $VERSION_CODE --timeout 600 --package com.example.app

# 3. Upload ProGuard mapping for crash symbolication
gpc deobfuscation upload --version-code $VERSION_CODE --file mapping.txt --type proguard --package com.example.app

# 4. Promote to beta
gpc tracks promote --from internal --to beta --package com.example.app

エージェントの動作

• APKではなく、常にAAB形式を使用してください（APKのアップロードは非推奨です）。
• ビルドをアップロードしたら、直ちに難読化解除ファイルをアップロードしてください。
• CIでは gpc bundles wait を使用して、処理が完了するまで待機してください。
• アップロードの成功を確認するため、バンドルの一覧を表示してください。

注意事項

• 新しいアプリにはAABが必須です。APKはレガシーアプリ向けにサポートされています。
• ProGuardマッピングを使用すると、Android Vitalsで読みやすいクラッシュスタックを確認できます。
• ネイティブデバッグシンボルを使用すると、シンボル化されたネイティブクラッシュレポートを確認できます。
• アップロード後のトラック昇格については、gpc-release-flow スキルを参照してください。