Google Play 自动上架

上架材料清单

材料规范要求
隐私政策AiFlutter内编辑，填入线上可访问链接
登录详细信息是否包含登录
广告是否包含广告
内容分级按实际情况填写
目标受众群体按实际情况填写
数据安全帮助用户了解您的应用会如何收集和分享他们的数据
政府应用应用是否由政府或以政府名义开发
金融产品和服务应用中是否涉及的金融产品和服务
健康应用中是否属于健康类应用
应用类别按实际情况填写即可
标签按实际情况填写即可
商品详情中的详细联系信息按实际情况填写 邮箱、电话号码、网站
应用名称您的应用在 Google Play 中显示的名称
简短说明应用的简短说明。用户可以展开来查看完整说明。 0~80
完整说明0~4000
应用图标大小不得超过 1 MB，尺寸为 512 x 512 像素
置顶大图大小不得超过 15 MB，并且尺寸为 1,024 x 500 像素
手机屏幕截图2 到 8 张手机屏幕截图。相应屏幕截图必须是 PNG 或 JPEG 格式的文件，每张屏幕截图的大小不得超过 8 MB，宽高比为 16:9 或 9:16，各条边的尺寸介于 320 像素和 3840 像素之间

一、准备条件

发布前必须全部准备完成，否则无法正常上架应用

分类要求说明
账号资质已注册并完成付费认证的 Google Play 开发者账号注册地址：https://play.google.com/apps/publish/signup
应用在 Google Play Console 创建应用
服务账号在 Google Cloud 创建服务账号并导出 JSON 密钥文件，供 AiFlutter 建立授权连接，链接地址：https://console.cloud.google.com/
上架规则本平台只负责发布到内部测试， 应用正式版本必须手动在 Google Play 控制台发布至生产渠道

二、创建应用

  1. 访问 Google Play Console ：https://play.google.com/apps/publish/#ApiAccessPlace
  2. 点击【创建应用】
  3. 按要求输入 应用名称、软件包名称（与 AiFlutter 中的包名一致） 即可
  4. 创建成功后，列表中会自动显示该应用

image-20260724204623129

三、创建服务账号并导出 JSON 密钥（核心授权步骤）

服务账号作用：AiFlutter 免个人账号密码调用 Google Play API，用于自动上传应用包。

1.打开 Google Cloud API 访问页面：https://console.cloud.google.com/apis/dashboard

image-20260724204843221

如果未创建项目需要点击上方按钮创建项目后才能执行以下操作

image-20260724205021438

2.在右侧菜单选择【服务帐户】板块

image-20260724205150498

3.点击【创建服务帐户】

image-20260724205249065

4.填写服务帐户名称，点击【创建并关闭】

服务账号只是用来上传应用包不用配置2、3选项

image-20260724205613896

5.点击服务账号，进入详情页面，在密钥一栏点击【创建新密钥】→ 密钥类型选择 JSON → 点击【创建】

image-20260724205913263

6.浏览器自动下载 .json 密钥文件，妥善保管（后续平台对接必备）

7.访问【API和服务】-> 【库】页面，开启 Google Play Android Developer API

image-20260724210722808

在搜索框中搜索 Google Play Android Developer API 并启用

image-20260724210554093

image-20260724210637468

四、AiFlutter 发布应用至 Google Play

注意

  1. 发布轨道：应用会发布至内部测试轨道，验证无问题后，需人工登录 Google Play 控制台手动升级至 Beta / 正式生产渠道；
  2. 草稿冲突规则：若目标轨道存在未提交的草稿版本，执行新版本发布后原有草稿会自动清除。

4.1 渠道前置配置

1.上传上一步获取的服务账号 JSON 文件，完成平台与 Google Play 的授权连通

image-20260718175315114

2.应用下载，打包时 Android 分发渠道选择「Google Play」

3.打包完成后自动推送至谷歌内部测试渠道；如需正式发布，需人工登录后台提交正式版本审核，后台链接：https://play.google.com/console/u/0/developers

4.2 提交审核

1.创建新的发布版本，这里选择内部测试轨道的版本，就是前面已经上传成功的版本

image-20260718174951442

2.确认无误后，点击【下一步】提交审核

五、常见问题补充说明

  1. JSON 密钥失效、上传失败

    排查：服务账号权限是否为「项目所有者」、密钥文件是否完整未损坏、API 项目是否正常绑定当前 Play 账号。

  2. 发布长时间不显示在商店

    属于 Google 正常同步延迟，最长等待 24 小时，可在 Play Console 查看版本审核状态。

上次更新: