easyGooglePlay
把一个 Android 项目从本地工程带到 Google Play。Agent 根据项目实际情况自动决定构建命令,并通过 Easy WebBridge 操作已经登录的 Google Play Console。本 Skill 遵循 Agent Skills 标准,可由 Claude Code、Codex、OpenCode、WorkBuddy 及其他兼容 Agent 使用。
先确认可以运行
在本 Skill 根目录执行:
node scripts/easy-webbridge-client.mjs preflight
自检会确认 Node.js、Easy WebBridge、访问令牌和在线浏览器,并返回可选浏览器的名称与 browserId。若运行时尚未安装,按自检结果先完成一次 Easy WebBridge 安装;后续所有 Easy WebBridge 业务 Skill 共用这一套运行时。
能做什么
- 识别原生 Android、Flutter、React Native、Unity、Gradle 和 Fastlane 项目,找到正确的 applicationId、版本名和版本号。
- 检查签名与 Release 配置,按项目现有工具构建或找到可上传的 AAB。
- 上传 AAB、App 图标、Feature Graphic、手机和平板截图及审核视频资料。
- 填写应用名称、简短说明、完整说明、分类、联系方式、隐私政策和版本说明。
- 填写 Data Safety、广告、应用访问权限、内容分级、目标受众和新闻应用等政策表单。
- 按应用能力填写 VPN、前台服务、健康、金融或其他需要的声明与审核资料。
- 创建 Production Release,选择发布范围,并把改动真正发送审核。
- 检查审核和发布状态,读取驳回原因,修改安装包、商店资料或政策声明后重新提交。
开始
- 读取应用项目和现有发布配置,沿用项目当前构建体系。
- 确认目标 App、包名、版本、国家或地区、发布比例和用户期望的终点。
- 根据自检结果选择已经登录 Google Play Console 的浏览器。
- 为本次上架创建一个
easy-google-play-<run-id>标签组;后续操作复用组内当前页面。 - 汇总本次需要的文字、图片、视频、测试账号和政策资料;能从项目可靠读取的内容直接读取。
执行
- 使用项目已有的 Gradle、构建脚本或 Fastlane 完成 Release AAB 构建。
- 在 Play Console 选择正确应用,上传 AAB 和商店素材。
- 填完商店详情、应用内容、Data Safety 和本应用实际需要的声明页面。
- 创建 Production Release,填写版本说明并检查发布范围。
- 用户要求“上架”或“提交审核”时,继续完成发布概览中的“发送更改以供审核”;用户只要求准备或检查时,停在对应结果页。
- 提交后重新读取页面,记录实际显示的版本、versionCode 和状态。
- 若被退回,读取完整政策或技术信息,定位问题,修改对应内容并重新走本次流程。
Easy WebBridge 使用方式
- Easy WebBridge 地址固定为
127.0.0.1:17777。 - 一次任务固定控制一个
browserId。 - 顺序步骤复用同一标签页;确实需要对照时才在同一任务组增加标签页。
- 使用本 Skill 的
scripts/easy-webbridge-client.mjs调用list、navigate、snapshot、click、fill、upload和command;它直接连接运行中的 Easy WebBridge,不依赖另一个 Skill 的本地路径。 - 使用
upload上传绝对路径文件;页面变化后重新读取页面再继续。 - 任务结束时只关闭本 Skill 创建的标签组,保留用户原来的页面。
完成标准
向用户清楚给出:
- App 名称、包名、版本名和 versionCode。
- AAB 的生成或上传结果。
- 商店资料、图片、Data Safety 和政策声明的完成情况。
- Google Play Console 当前真实状态,例如“尚未发送审核”“更改正在审核”“被拒绝”“已发布”。
- 若有审核问题,给出具体原因、已修改内容和下一步。
分别记录“表单已保存”“Release 已创建”“更改已发送审核”和“应用已发布”,以 Play Console 最终页面为准。