首次将 Android 应用上传至 Google Play

一次性 25 美元费用与政府 ID 验证

前往 play.google.com/console/signup，用你想用来拥有该应用的 Google 账号登录。选择个人或组织：

• 个人——你是个人发布者，需要政府 ID 验证。
• 组织——以公司主体发布应用，需要企业的 D-U-N-S 编号以及与该组织绑定的可验证电话号码。验证周期较长（1–2 周），但可以品牌名义而非个人名义发布。

支付 25 美元（终身有效，此账号可无限发布应用）。提交证件后等待验证——个人账号通常 48 小时内完成，组织账号时间更长。

绝大多数情况下，选择 Play 应用签名

你需要在两种方案中选择一种：

• Play 应用签名（约 99% 的情况推荐）。你在本地生成一个上传密钥；Google 生成并持有一个应用签名密钥。你上传的每个 AAB 都由上传密钥签名，Play 会将其剥离，再用应用签名密钥重新签名后下发给设备。如果上传密钥泄露，你可以联系 Google 进行轮换；用户设备上的应用仍可正常运行，因为应用签名密钥始终在 Google 手中。
• 自管理签名（旧方式）。你生成一个密钥，自行签署所有内容，从不将密钥上传给 Google。一旦密钥丢失，便永远无法更新该应用。新应用将作为不同包名下的独立列表重新上架。这种方式适用于因法律原因不允许 Google 接触签名密钥的组织，并不适合大多数人。

选择 Play 应用签名。你接下来要生成的"上传密钥"就是本地构建所使用的签名密钥。

一个 keystore 文件，永久妥善保管

keytool -genkey -v \
  -keystore ~/keys/mybrand-upload.keystore \
  -keyalg RSA -keysize 2048 -validity 25000 \
  -alias mybrand-upload
# Enter a password. Save it in your password manager.
# Fill in the X.500 fields (name, organization, country).
# 25000 days = ~68 years. Yes, really. Keystores aren't supposed to expire.

务必备份这个 keystore 文件：云存储、加密 U 盘、密码管理器附件——任何能在你笔记本电脑损坏后幸存的地方都行。一旦丢失，就必须走 Google 的申诉流程（流程存在，但极为缓慢）。把它当作一份不动产契约来对待。

keystore 密码和密钥密码（两者都会要求你输入）可以相同，很多人为了简便起见使用同一个密码。两者都应存入密码管理器。

必须是 AAB，不能是 APK——Play Console 会拒绝新应用的 APK 上传

在 app/build.gradle.kts（或 Groovy DSL 的 app/build.gradle）中添加发布签名配置：

android {
    signingConfigs {
        create("release") {
            storeFile = file(System.getenv("UPLOAD_KEYSTORE_PATH") ?: "$rootDir/keystore-not-set")
            storePassword = System.getenv("UPLOAD_KEYSTORE_PASSWORD")
            keyAlias = "mybrand-upload"
            keyPassword = System.getenv("UPLOAD_KEY_PASSWORD")
        }
    }
    buildTypes {
        release {
            signingConfig = signingConfigs.getByName("release")
            isMinifyEnabled = true
            proguardFiles(getDefaultProguardFile("proguard-android-optimize.txt"), "proguard-rules.pro")
        }
    }
}

构建 bundle：

export UPLOAD_KEYSTORE_PATH=~/keys/mybrand-upload.keystore
export UPLOAD_KEYSTORE_PASSWORD='your-password'
export UPLOAD_KEY_PASSWORD='your-password'
./gradlew :app:bundleRelease

# Output:
# app/build/outputs/bundle/release/app-release.aab

这就是你要上传的文件。验证其签名是否正确：

jarsigner -verify -verbose -certs app/build/outputs/bundle/release/app-release.aab
# Last line should say: "jar verified."

建立商店列表的基本框架

Play Console → 创建应用。填写以下信息：

• 应用名称——用户在商店中看到的名称，最多 30 个字符。之后可以修改，但 URL 别名由此初始值决定。
• 默认语言——商店列表主要文案所使用的语言区域，之后可添加其他语言。
• 应用或游戏——影响可选的分类树，多数情况下影响不大。
• 免费或付费——付费指一次性购买或订阅。免费应用仍可包含应用内购买。免费应用之后无法改为付费，只能从付费改为免费。请谨慎选择。

提交后，该应用将以草稿状态出现在 Play Console 中。此时还无法发布任何内容，你需要先在某个轨道上传已签名的 AAB，并填写完整的元数据。

六个表单，一个都不能省

在 Play Console 侧边栏中点击应用内容，逐项完成填写。未填写这些内容就提交是首次上传最常见的错误。

• 隐私政策。指向一个公开可访问的隐私政策文档的 URL。如果应用收集了任何数据，此项为必填。即使不收集任何数据，也需要一条简短声明。可使用生成工具（app-privacy-policy-generator.firebaseapp.com），并将结果托管在稳定可访问的地址上。
• 应用访问权限。如果应用的部分功能需要登录，你必须提供测试账号凭据，供审核人员访问。"用户名：[email protected]，密码：……"——Google 审核人员会实际使用这些凭据。
• 广告。是或否。如选是，则需回答额外的广告内容分级问题。
• 内容分级。一份问卷（"应用是否含有暴力内容？""是否涉及赌博？"），生成 IARC 分级。大约需要 5–10 分钟。分级结果会影响应用在哪些国家可见。
• 目标受众和内容。年龄段划分，若面向 13 岁以下用户则有额外规定。对于大多数面向普通消费者的应用，选择"混合受众"较为稳妥。
• 数据安全。最繁琐的表单。需要披露应用收集的每类数据（位置、通讯录、照片、文件、设备 ID 等），以及这些数据是否为必需、是否与第三方共享、是否在传输中加密。披露内容必须与实际情况一致——Google 会对比应用的运行时行为与表单内容，不符将是下架原因。首次填写此表单请预留 20–40 分钟。
• 政府应用 / 新闻应用 / 健康应用等。如果你的应用属于受监管类别，需填写相应的条件声明。

用户点击你的应用后看到的内容

侧边栏主商店列表，必填素材如下：

• 应用图标——512×512 PNG，32 位，带 Alpha 通道。Google 在各处展示的图标。
• 特色图片——1024×500 JPG/PNG，显示在商店列表顶部的横幅图。
• 手机截图——至少 2 张，最多 8 张。PNG 或 JPG，16:9 或 9:16，短边在 320 至 3840 像素之间。可从 AVD 截取：adb exec-out screencap -p > screen.png。
• 简短说明——80 个字符以内，显示在搜索结果摘要中。
• 完整说明——最多 4000 个字符，即应用的完整产品页文案。
• 平板电脑截图——可选，但如果你支持平板电脑，建议提供。不提供的话，平板用户看到的是手机截图以不太理想的宽高比呈现的效果。

描述文案是最值得反复打磨的部分——上线后仍可编辑，因此首次发布时"足够好"就行了。图标和特色图片重新上传则相对麻烦。

最快在真实设备上安装应用的路径

侧边栏测试 → 内部测试 → 创建新版本：

• 应用签名——首次上传时 Play Console 会提示开启 Play 应用签名，接受即可。
• 上传 AAB——拖入第 4 步生成的 app-release.aab，上传需 1–3 分钟。
• 版本名称——自动从版本号填充，保持默认即可。
• 版本说明——描述本次更新内容。首次发布填写"初始版本"即可。

保存 → 审核版本 → 开始向内部测试版推出。版本通常在 5 分钟内处理完毕。

添加测试人员：内部测试 → 测试人员标签页 → 创建电子邮件列表（每行粘贴一个 Gmail 地址，最多 100 人）。保存后，每位测试人员会收到一个 Play 商店加入链接，点击后方可安装应用。

将加入链接发给测试人员。他们点击链接并接受后，访问该应用的 Play 商店页面（或内部测试直链）即可安装。版本推出后约 5–10 分钟，应用便可在他们的设备上安装。

真正面向公众发布的完整流程

内部测试确认构建无误后：

• 封闭测试——私人群组，通常基于邮件列表或 Google 群组。上传流程相同，将版本从内部测试提升到封闭测试即可。适合早期体验用户或 Beta 计划。如果你使用的是个人账号，这就是 14 天的必经阶段。
• 开放测试（可选）——任何有链接的人都可以加入，承诺度低于正式发布，适合在不获得 Play 商店搜索曝光的情况下进行"软发布"。
• 正式发布——公开上线。支持国家/地区的所有用户均可搜索并安装你的应用。首次正式发布需经过完整审核（3–7 天），后续更新通常在 24 小时内通过。

首次推送到正式发布：正式发布 → 创建新版本 → 从封闭测试版推广。添加版本说明后提交，然后等待。状态变更时会收到邮件通知。