ARTICLE

Google Play 上架实战:Android 签名、服务账号授权、内测与内购配置(81 图)

原创文章
声明:作者声明此文章为原创,未经作者同意,请勿转载,若转载,务必注明本站出处,本平台保留追究侵权法律责任的权利。

以 exampleApp 为例,走一遍 Google Play 上架准备:核对 AAB 签名、授权后端验单、验证内测安装与内购,再补齐审核资料和商店详情。

办理顺序:确认包名和上传密钥 → 生成并上传 release AAB → 配置后端要用的 Android Publisher API → 通过内部测试跑通安装和支付 → 核对应用内容与商店详情。API 可以与内测准备并行。仅手动上传 AAB 的项目可以跳过 API 部分。

全篇包含 81 张操作截图,按步骤组成 30 组。图内编号对应原始截图顺序。命令块里的项目路径、alias 和文件名按你的环境替换。

一、在酷鸟云电脑生成 Android 签名

1. 检查 JDK,准备签名文件目录

图 01 是酷鸟云电脑里的 Windows 命令提示符(CMD)。先确认能运行 Java 和 JDK 自带的 keytool。图 02–03 是创建目录和资源管理器检查。若命令报未找到,检查装的是 JDK,确认 bin 在 PATH,或直接调用 keytool.exe 的完整路径。下文的 %USERPROFILE% 和行尾续行符 ^ 是 CMD 语法。

bat 复制代码
where java
where keytool
java -version
keytool -help

set "SIGN_DIR=%USERPROFILE%\AndroidSigning"
if not exist "%SIGN_DIR%" mkdir "%SIGN_DIR%"
dir "%SIGN_DIR%"
图 01–03 · 检查 Java 和 keytool,创建签名目录

2. 分开生成调试密钥和上传密钥

调试密钥用于本地调试。一般项目可继续使用 Android 工具链自动生成的 debug keystore,只有团队确实需要专用调试证书时才运行第一条生成命令。第二条生成上传密钥,用于签署提交给 Google Play 的 release AAB。首次注册上传密钥后,后续构建继续使用同一把密钥。

bat 复制代码
if not exist "%SIGN_DIR%\debug.jks" keytool -genkeypair -v ^
  -keystore "%SIGN_DIR%\debug.jks" -storetype JKS ^
  -alias androiddebugkey -keyalg RSA -keysize 2048 ^
  -validity 10000 -dname "CN=Android Debug"

if not exist "%SIGN_DIR%\upload.jks" keytool -genkeypair -v ^
  -keystore "%SIGN_DIR%\upload.jks" -storetype JKS ^
  -alias upload -keyalg RSA -keysize 2048 -sigalg SHA256withRSA ^
  -validity 10000 -dname "CN=Android Upload"

按提示交互输入口令。图 04–05 的历史命令含口令参数,公开图组已遮挡这一部分。把上传密钥库和口令分别放入加密备份与团队的密码管理系统。定制的 debug keystore 需与构建配置中指定的 alias 和口令一致。

图 04–06 · 创建两套 JKS 并在资源管理器核对输出

3. 核查 alias 和证书指纹

图 07–08 分别用 keytool -list -v 查看上传和调试证书,核查 PrivateKeyEntry、有效期、SHA-256 和实际使用的 alias。JKS 的格式建议提示可以结合输出文件和命令退出结果判断。Google Play 使用 应用签名密钥签署分发 APK,核对线上 OAuth、Firebase 等集成时通常要看 Play Console 的应用签名证书。

bat 复制代码
keytool -list -v -keystore "%SIGN_DIR%\upload.jks" -storetype JKS -alias upload
keytool -list -v -keystore "%SIGN_DIR%\debug.jks" -storetype JKS -alias androiddebugkey
图 07–08 · 分别核对上传证书和调试证书

图 09–10 展示云电脑的共享盘和文件中转站。迁移密钥时使用受控传输,确认目标设备能读取加密备份并核对证书指纹,再清理中转残留。若项目已有 Play 上传密钥而旧密钥确实丢失,按上传密钥重置流程登记新证书。

图 09–10 · 云电脑共享盘与文件中转页面

二、在 Google Cloud 配置服务账号和 Android Publisher API

这一段适用于后端验单、管理订单或通过 API 管理发布。Cloud 项目启用 API、工作负载取得凭据和 Play Console 授予应用权限是三件事。Google Play Developer API 的现行接入说明允许直接在「用户和权限」里邀请服务账号。

1. 创建专用服务账号

在 Google Cloud 里确认项目,进入「IAM 和管理 → 服务账号 → 创建服务账号」。图 11–13 分别是列表、账号资料和可选的 Cloud 项目角色。取一个能表达用途的名称,例如 play-billing。只为该工作负载确实需要访问的 Cloud 资源配置角色。图 14 的主体访问设置决定谁能使用或管理此服务账号。完成后在图 15–16 对应的列表和详情里核对状态,并复制服务账号邮箱,后续在 Play Console 使用。

图 11–13 · 创建服务账号并检查可选的 Cloud IAM 角色
图 14–16 · 检查主体访问设置和服务账号详情

2. 选择凭据方式,识别组织政策拦截

在 Google Cloud 上运行的服务可使用附加到工作负载的服务账号凭据。外部运行环境可优先评估 Workload Identity Federation,通过服务账号模拟取得短期凭据,并让后端以该服务账号调用 Play API。

图 17–19 是旧集成使用「密钥 → 添加密钥 → 创建新密钥」时看到的 JSON 密钥界面。下载的 JSON 带私钥,应由受控的服务器密钥管理系统保管。Android 客户端只需向后端传递验单所需的 purchase token,长期私钥应始终留在服务器侧。

图 17–19 · 服务账号密钥页、添加密钥菜单和 JSON 类型界面

如果创建密钥被拦截,先看图 20 的报错,再到「IAM 和管理 → 组织政策」搜索 iam.disableServiceAccountKeyCreation。如环境使用托管版本,同时检查 iam.managed.disableServiceAccountKeyCreation。图 21–23 对照策略列表、继承状态和项目当前生效规则。

图 20–22 · 密钥创建被拦截,定位约束和实际生效状态

图 23–28 记录的是该项目的策略检查与项目级例外案例。优先使用短期凭据。若旧系统只能用 JSON,而且管理员批准了例外,应把例外限定到必要资源,核对项目生效策略,并约定轮换和撤销时间。

图 23–25 · 查看项目有效策略、继承方式和规则编辑入口
图 26–28 · 核查规则及保存后的项目生效状态

3. 在 Play Console 授予目标应用权限

  1. 在 Play Console 打开「管理账号 → 用户和权限 → 邀请新用户」,填入服务账号邮箱。图 29–31 是管理入口、列表和邀请表单。
  2. 切到「应用权限」,选择目标应用,核对包名。图 32–34 展示添加应用、选择范围及权限项。购买与订阅 API 所需权限按官方接入说明核查「查看财务数据」和「管理订单和订阅」。发布流水线单独按轨道与操作授权,验单服务不需要生产发布权限。
  3. 在图 35–36 的选择与摘要里复核每个授权项,再按图 37–38 发送邀请并确认列表中的状态。需要排查 403 时回到这里检查目标应用和权限,不要只看 Cloud IAM 页面。
图 29–31 · 用户和权限入口及服务账号邀请表单
图 32–34 · 添加目标应用并打开应用级权限表
图 35–36 · 检查订单和订阅权限及应用权限汇总
图 37–38 · 核对邀请对象并回到列表确认状态

4. 启用 Google Play Android Developer API

回到正确的 Google Cloud 项目,进入「API 和服务 → API 库」,搜索 Google Play Android Developer API。图 39–43 是仪表板、搜索、详情启用和已启用状态。图 81 是同一 API 在另一个项目中的界面,操作前要检查项目选择器。服务名为 androidpublisher.googleapis.com,API 调用使用 OAuth 范围 https://www.googleapis.com/auth/androidpublisher。已配置 Google Cloud CLI 的环境也可执行以下命令,并确认列表返回该服务。

bash 复制代码
PROJECT_ID='your-cloud-project-id'
gcloud services enable androidpublisher.googleapis.com --project="$PROJECT_ID"
gcloud services list --enabled --project="$PROJECT_ID" \
  --filter='config.name:androidpublisher.googleapis.com'

这条命令检查 Cloud 项目的 API 状态。后端调用时还要核对实际使用的服务账号、OAuth 范围、目标包名和 Play Console 权限。

图 39–41 · 从 API 和服务进入 API 库并搜索 Android Developer API
图 42–43、81 · 打开 API 详情、启用并核对项目

三、创建内部测试版本

在 Play Console 的应用列表创建或选中应用,确认控制台目标的包名与 release 的 applicationId 一致。核对当前构建使用上传密钥,并使用尚未上传过的、符合更新顺序的 versionCode。Android Studio 可以用 Generate Signed Bundle / APK → Android App Bundle 构建;已配置 Gradle release 签名的项目可在 Windows 项目根目录执行:

bat 复制代码
gradlew.bat :app:bundleRelease
keytool -printcert -jarfile "app\build\outputs\bundle\release\app-release.aab"

有 product flavor 的项目请改成实际任务和产物路径。已有登记上传证书的应用,可将 AAB 中证书的 SHA-256 与 Play Console 的上传证书比较。

1. 上传 AAB 和版本说明

进入「测试和发布 → 测试 → 内部测试」,选择创建版本并上传已签名的 AAB。首次上传时按页面提示设置 Play App Signing。图 44–46 展示轨道、上传区域、版本名称和按语言填写的版本说明。提交前逐项核对版本号、ABI 与覆盖设备。

图 44–46 · 进入内部测试轨道、上传 AAB 并填写版本说明

2. 检查发布警告,配置测试人员

在图 48 的预览里区分阻塞错误与警告。没有测试人员时先配置名单。如果 release 启用了混淆,保留对应构建的 R8 映射,按控制台提示核查反混淆文件;包含 native 代码时也检查符号归档。图 50–51 是确认内部测试发布和回到版本页的结果。图 80 是测试人员页,把测试 Google 账号加入名单并保存,再把加入链接发给测试人员。测试人员应使用同一个获准 Google 账号加入,并通过 Play 商店安装。

图 48、50 · 查看错误与警告并确认发布到内部测试
图 51、80 · 查看内测版本状态并配置测试名单

内部测试适合先验证分发链路。准备申请正式发布时,请在信息中心核对自己开发者账号显示的测试和正式版资格条件。

四、完成隐私、审核访问和应用内容

1. 使用信息中心清单追踪进度

图 47、53 和 59 是同一类应用设置看板在不同阶段的状态。提交审核前进入「监控和改进 → 政策和计划 → 应用内容」,处理适用于目标版本的必填项,并查看「发布概览」里哪些变更还待送审。

图 47、53、59 · 从信息中心查看设置应用的任务及完成状态

2. 填写隐私政策与审核访问

图 49 将无需登录即可访问的隐私政策链接填入后台。也在应用内提供清楚的入口,政策内容与实际数据做法对应。图 54 是「登录详细信息」表单。若注册、登录、会员、地区或其他条件限制审核者访问功能,按要求提供专用测试凭据和英文操作说明,覆盖受限页面,说明如何处理 OTP 等登录环节。图 55–56 是新增并保存登录说明的示例。保存后用干净设备或新安装环境验证审核账号确实能进入相应页面。

图 49、54 · 填写隐私政策 URL,并确认是否存在访问限制
图 55–56 · 填写并保存审核登录说明,凭据字段已遮挡

3. 逐项核对广告、内容分级和权限

  • 广告与内容分级。图 57–58 是广告声明和 IARC 分级问卷入口。根据发布包里实际投放的内容和接入的 SDK 申报。聊天类应用尤其要检查用户互动、用户生成内容、举报与屏蔽功能是否和问卷答案一致。
  • 数据安全。从 release 的实际行为出发梳理客户端、后端和第三方 SDK 收集或分享的数据,说明用途、安全处理和删除做法。若允许创建账号,按要求提供应用内和应用外的账号删除请求入口。
  • 权限声明。内部测试包上传后检查合并后的 AndroidManifest 和后台显示的声明。只有偶尔选择图片时优先用系统 Photo Picker;如确实有符合要求的广泛媒体访问,再按后台要求填写。使用前台服务时核对其用途、类型与权限,按页面要求提交说明或演示材料。
图 57–58 · 广告声明和 IARC 内容分级问卷

五、填写默认商店详情和上架素材

图 60–62 是默认商店详情的语言、应用名、简短说明和完整说明。优先把主要功能、目标用户和使用场景写清楚,文案与实际 App 一致。英文商店页的原文可作为结构参考,其他语言应同步准备本地化文案和带文字的截图。Play Console 常见上限为应用名 30、简短说明 80、完整说明 4,000 个字符。

图 60–62 · 选择默认语言,填写名称、简短说明和完整说明

图 63–66 对照图标、宣传图、可选视频、手机截图和其他设备素材,按页面的尺寸要求上传。图 67 的 AI 资源声明按实际来源填。图 68 回到总览核对目标语言的材料与审核状态。

图 63–65 · 配置应用图标、宣传图、视频及手机截图
图 66–68 · 查看设备素材、AI 资源声明和商店详情概览

六、创建一次性内购、定价并验证购买

1. 新建商品与购买选项

通过「借助 Play 变现 → 商品 → 一次性商品」进入目录。图 52 是变现入口,图 69–70 是目录和新建表单。先确定商品 ID,再和客户端及服务端约定同一个值,例如 vip_year_pass。一次性商品 ID 与下面的购买选项 ID 各有用途。按项目的实际收费模式选择一次性商品或订阅。如果产品的承诺是自动续费,使用订阅及相应的基础方案。

图 52、69–70 · 打开变现入口、一次性商品列表和创建表单

图 71–73 对应本地化名称与说明、税费和法规字段、购买选项。按商品实际属性填写分类及适用字段,明确用户购买后得到的权益、期限和是否可重复购买。根据后台提供的商品形态选择合适的购买选项。

图 71–73 · 填写商品说明、相关属性和购买选项

2. 设置国家和地区价格

图 74–76 展示国家和地区的供应情况、价格操作菜单与批量选择。图 77 是批量定价弹窗。设置基础币种和价格后,在图 78 对照各市场的换算结果、币种、价格区间和实际可用性,再保存并启用购买选项。图 79 是启用后的购买选项状态。应用本身的分发地区也会影响商品可用范围。

图 74–76 · 查看市场价格表、打开定价菜单并选择地区
图 77–79 · 配置基准价、复核各区价格并确认购买选项状态

3. 用许可测试账号跑完整链路

  1. 把测试账号加入内部测试名单并完成加入流程。在 Play Console 另行配置许可测试,用同一个 Google 账号从 Play 安装目标版本。在结算界面确认使用测试付款方式。
  2. 客户端查询 Play 返回的商品详情与本地化价格,发起购买。后端使用服务账号调用对应购买查询接口校验 purchase token,并依据服务端结果确认目标包名、商品和购买状态。
  3. 对已完成的购买幂等发放权益,按商品形态完成 acknowledge 或 consume。对 pending、取消、退款、恢复购买和重复通知分别做测试。

如果内部测试能装包却拉不到商品,先比对包名、商品 ID、购买选项状态、国家和地区,以及设备当前用于结算的 Google 账号。若能拉到商品但后端验单失败,再检查 Cloud API 和 Play 权限。

提交前核对

检查项 可以怎样验证
签名与构建 release AAB 证书与已登记上传证书一致,包名对应目标应用,versionCode 满足更新要求
API 和授权 正确 Cloud 项目已启用 API,后端身份与 Play Console 已授权的服务账号一致
内部分发 获准的 Google 账号能加入轨道,从 Play 安装预期构建
应用内容 隐私链接可访问,审核账号可登录,数据安全和权限声明与 release 实际行为一致
商店详情 默认语言的文案、图标、宣传图及设备截图齐全
内购 商品和购买选项在目标地区有效,许可测试可完成下单、验单和权益发放

官方参考

Android 签名 · 上传密钥重置实操
Play API 接入 · Cloud 组织政策
内测轨道
提审准备 · 数据安全 · 账号删除 · 敏感权限
一次性商品 · 内购测试 · 购买生命周期

写下你的想法
分享观点,友善交流
请保持友善,理性讨论
0 字

暂无评论,快来发表第一条评论吧