用途:管理 Android 应用包(AAB)、APK 的上传与处理流程,并上传反混淆文件,适用于构建流水线与发布场景。
主要能力:
- 应用包(AAB)管理:上传、列出、按版本号查找、等待处理完成。
- APK(旧版)管理:上传与列出。
- 反混淆文件:上传 ProGuard 映射(用于崩溃符号化)与原生调试符号。
常用命令: 上传 AAB:gpc bundles upload --file app.aab --track internal --package com.example.app 列出 AAB: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 上传 APK:gpc apks upload --file app.apk --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 典型流程:上传 AAB、等待处理、上传 ProGuard 映射、通过 gpc tracks promote 推进渠道。
建议行为:优先使用 AAB 格式(APK 上传已弃用);构建上传后立即上传反混淆文件;在 CI 中使用 gpc bundles wait 阻塞至处理完成;上传后列出 AAB 确认成功。
限制与说明:新应用必须使用 AAB,APK 仅用于旧应用;ProGuard 映射用于 Android Vitals 中可读的崩溃堆栈,原生调试符号用于原生崩溃报告符号化;渠道推进可参考 gpc-release-flow 技能。