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

Agent 行为

• 始终优先使用 AAB 格式，而非 APK（已弃用 APK 上传）。
• 构建版本上传后，立即上传反混淆文件。
• 在 CI 中使用 gpc bundles wait 阻塞流程，直到处理完成。
• 上传后显示应用包列表以确认成功。

备注

• 新应用必须使用 AAB；APK 仅适用于旧版应用。
• ProGuard 映射文件可让 Android Vitals 中的崩溃堆栈更易读。
• 原生调试符号可生成符号化的原生崩溃报告。
• 上传后如何提升轨道，请参阅 gpc-release-flow 技能。