发布用于 Google Play 分发的 .NET MAUI Android 应用

向用户分发 Android 应用最常见的方法是通过 Google Play。 首次将应用提交到 Google Play 时，必须通过 Google Play 控制台提交。 可以通过 Visual Studio 提交应用的后续版本。 在这两种情况下，都需要 Google Play 开发人员帐户。 提交到 Google Play 的应用需要 Google 的批准。

若要将 .NET 多平台应用 UI (.NET MAUI 分发) Android 应用，需要先使用密钥存储中的密钥对其进行签名，然后再上传到 Google Play。 密钥存储是充当证书和私钥存储库的二进制文件。

Google Play 要求将应用作为 Android App Bundle (AAB) 提交。 Google Play 使用应用捆绑包为每个设备配置生成和提供优化的 Android 程序包 (APK) ，以便仅下载运行应用的特定设备所需的代码和资源。 有关 Android 应用程序包的详细信息，请参阅关于 developer.android.com 上的 Android 应用程序包 。

通过 Google Play 分发 .NET MAUI Android 应用的过程如下：

然后，可以通过 Visual Studio 发布应用的后续版本。 有关详细信息，请参阅 通过 Visual Studio 分发应用。

若要在 Google Play 上发布 Android 应用，需要创建 Google Play 开发人员帐户：

重要

必须先完成身份验证，然后才能通过 Google Play 发布应用。

创建 Google Play 开发人员帐户后，你将能够开始将应用发布到 Google Play 的过程。

有关详细信息，请参阅在 support.google.com 上注册 Google Play 开发人员帐户 。

创建 Google Play 开发人员帐户后，需要在 Google Play 控制台中创建应用：

登录到 Google Play 开发人员帐户。

在 Google Play Console 的“ 所有应用 ”选项卡上，选择“ 创建应用 ”按钮：

在 “创建应用 ”页中，输入应用详细信息，然后选择“ 创建应用 ”按钮：

有关在 Google Play Console 中创建应用的详细信息，请参阅在 support.google.com 上创建和设置应用 。

创建应用后，应对其进行设置。 应用仪表板将指导你完成所有最重要的步骤。

若要开始设置应用，请选择左侧菜单中的“ 仪表板 ”。 在页面顶部的应用详细信息下，你将找到与应用设置和发布相关的不同类别和任务。 必须先完成强制性任务，然后才能在 Google Play 上启动应用。 完成任务后，你将看到绿色刻度线和删除线文本。 部分顶部的进度栏也将更新。 有关详细信息，请参阅在应用仪表板 support.google.com 上设置应用。

若要发布用于 Google Play 分发的 .NET MAUI Android 应用，需要应用包格式为 AAB，这是发布版本的默认包格式。 若要验证应用的包格式是否已正确设置，请执行以下操作：

在 Visual Studio 的解决方案资源管理器右键单击 .NET MAUI 应用项目，然后选择“属性”。 然后，导航到 “Android > 选项 ”选项卡，并确保“ 发布 ”字段的值设置为 bundle：

发布

首次将 AAB 提交到 Google Play 时，必须通过 Google Play 控制台手动上传。 这使 Google Play 能够将未来所有捆绑包上的密钥签名与用于应用第一个版本的原始密钥相匹配。 若要通过 Google Play Console 上传应用，必须先在 Visual Studio 中生成并登录该应用。

若要在 Visual Studio 中生成应用并签名，请执行以下操作：

在 Visual Studio 工具栏中，使用 “调试目标” 下拉列表选择 “Android 模拟器 ”，然后选择所选的仿真器：

在 Visual Studio 工具栏中，使用 “解决方案配置” 下拉列表从调试配置更改为发布配置：

在“解决方案资源管理器”中，右键单击 .NET MAUI 应用项目，然后选择“发布...”：

存档管理器将打开，Visual Studio 将开始存档应用程序包：

在 存档管理器中，成功完成存档后，请确保已选择存档，然后选择“ 分发...” 按钮开始分发应用的过程：

将显示 “分发 - 选择频道 ”对话框。

在 “分发 - 选择频道 ”对话框中，选择“ 临时 ”按钮：

在 “分发 - 签名标识 ”对话框中，选择 + 按钮以创建新的签名标识：

将显示 “创建 Android 密钥存储 ”对话框。

注意

或者，可以通过选择“ 导入 ”按钮来使用现有的签名标识。

在 “创建 Android 密钥存储 ”对话框中，输入创建新签名标识（称为 密钥存储）所需的信息，然后选择“ 创建 ”按钮：

包含新证书的新密钥存储将保存到 适用于 Android\Keystore{Alias}{Alias}{Alias}.keystore 的 C：\Users{Username}\AppData\Local\Xamarin\Mono。

重要

密钥存储和密码不会保存到 Visual Studio 解决方案中。 因此，请确保备份此数据。 如果丢失，将无法使用相同的签名标识对应用进行签名。

在 “分发 - 签名标识 ”对话框中，选择新创建的签名标识，然后选择“ 另存为 ”按钮：

存档管理器显示发布过程。

在“ 另存为 ”对话框中，确认 的位置和文件名 。AAB 文件正确，然后选择“ 保存” 按钮。

在“ 签名密码 ”对话框中，输入签名标识密码，然后选择“ 确定” 按钮：

在 存档管理器中，在发布过程完成后，选择“ 打开分发 ”按钮：

Visual Studio 将打开包含已发布应用的文件夹。

然后，可以通过 Google Play Console 将已发布的应用发布到 Google Play。 为此，必须先在 Google Play Console 中创建一个版本。 发布是一个或多个应用版本的组合，你将准备这些版本以启动应用或推出更新。 可以在以下轨道上创建发布：

有关在 Google Play Console 中创建版本的详细信息，请参阅 准备和推出 support.google.com 上的版本 。

重要

提交到 Google Play 的应用通常会经历评审过程。 有关详细信息，请参阅 准备应用以供审阅 和 在 support.google.com 发布应用 。

AAB 必须已提交到 Google Play 并通过评审，然后才能从 Visual Studio 分发它。 如果尝试从 Visual Studio 分发尚未首先从 Play Console 上传的 AAB，将收到以下错误：

Google Play 要求你为此应用手动上传第一个包 (APK/AAB) 。 为此，可以使用即席包。

发生此错误时，请通过 Google Play Console 手动上传 AAB。 然后，可以通过 Visual Studio 发布应用的后续版本。 但是，必须更改每次上传的应用的版本代码，否则将发生以下错误：

已上传版本代码 (1) 的 AAB。

若要解决此错误，请使用不同的版本号重新生成应用，然后通过 Visual Studio 将其重新提交到 Google Play。

注意

可以通过增加应用项目文件中整数属性的值 ApplicationVersion 来更新应用的版本号。

将应用从 Visual Studio 上传到 Google Play 首先需要在 Google Play Console 中设置 API 访问权限。

借助 Google Play 开发人员发布 API，Visual Studio 可以将应用的新版本上传到 Google Play。 在 Visual Studio 开始调用 API 之前，你需要在 Google Play 开发人员帐户中设置 API 访问权限。 这包括将 Google Play 开发人员帐户链接到 Google Cloud 项目，并使用 OAuth 客户端配置对 Google Play 开发人员发布 API 的访问权限。

若要启用 Google API 访问，请执行：

登录到 Google Play 开发人员帐户。

在 Google Play Console 中，展开 “设置” 项并选择“ API 访问权限”。 然后在 API 访问 页中，选择“ 选择要链接的项目 ”按钮：

若要使用 Google Play 开发人员 API，需要一个必须链接到 Google Play 开发人员帐户的 Google Cloud 项目。

注意

Google Play 开发人员帐户只能链接到单个 Google Cloud 项目。 因此，如果从一个 Google Play 开发人员帐户发布多个应用，它们必须共享同一个 Google Cloud 项目。

在 API 访问 页中，选择“ 创建新的 Google Cloud 项目 ”单选按钮，然后选择 “保存” 按钮：

将创建新的 Google Cloud 项目并将其链接到 Google Play 开发人员帐户。

在 “API 访问 ”页的“ OAuth 客户端 ”部分中，选择“ 配置 OAuth 许可屏幕”：

在 “OAuth 许可屏幕 ”页中，选择所需的“用户类型”单选按钮，然后选择“ 创建 ”按钮：

有关用户类型的详细信息，请参阅 support.google.com 上的 用户类型 。

在 “编辑应用注册 ”页中，完成标记为必填的字段，然后选择“ 保存并继续 ”按钮：

在 “编辑应用注册 ”页中，选择“ 添加或删除 SCOPES ”按钮：

在 “更新所选作用域” 浮出控件中，选择 ./auth/androidpublisher 表中的作用域，然后选择“ 更新 ”按钮：

注意

可以选择选择表中的其他范围，因为它们是标准范围。

在 “编辑应用注册 ”页中，选择“ 凭据 ”选项卡：

在 “凭据 ”页中，选择“ + 创建凭据 ”按钮，然后选择 “OAuth 客户端 ID ”项：

在“创建 OAuth 客户端 ID”页的“应用程序类型”下拉列表中选择“桌面应用”，在“名称”字段中输入 Visual Studio，然后选择“创建”按钮：

在 OAuth 客户端创建 对话框中，选择 “下载 JSON 数据”按钮以下载客户端 ID 和客户端密码。 稍后会要求这样做。 然后单击“ 确定” 按钮关闭对话框。

有关启用 Google API 访问 Google Play 开发人员帐户的详细信息，请参阅 developers.google.com 上的入门。 有关设置 OAuth 同意屏幕的详细信息，请参阅 support.google.com 上的 设置 OAuth 同意屏幕 。

若要在 Visual Studio 中生成应用并签名，请执行以下操作：

在 Visual Studio 工具栏中，使用 “调试目标” 下拉列表选择 Android 仿真器 ，然后使用所选模拟器：

在 Visual Studio 工具栏中，使用 “解决方案配置” 下拉列表从调试配置更改为发布配置：

在“解决方案资源管理器”中，右键单击 .NET MAUI 应用项目，然后选择“发布...”：

存档管理器将打开，Visual Studio 将开始存档应用捆绑包：

在 存档管理器中，成功完成存档后，请确保已选择存档，然后选择“ 分发...” 按钮以开始分发应用的过程：

将显示 “分发 - 选择频道 ”对话框。

在 “分发 - 选择频道 ”对话框中，选择 Google Play 按钮：

在 “分发 - 签名标识 ”对话框中，选择在通过 Google Play Console 生成要分发的应用时创建的签名标识，然后选择“ 继续 ”按钮：

在 “分发 - Google Play 帐户 ”对话框中，选择 + 按钮以添加 Google Play 开发人员帐户详细信息：

在 “注册 Google API 访问 ”对话框中，输入说明以及 OAuth 客户端 ID 和客户端密码，然后单击“ 注册 ”按钮：

注意

通过帐户说明，可以注册多个 Google Play 开发人员帐户，并将应用上传到不同的 Google Play 开发人员帐户。

Web 浏览器将打开。

在 Web 浏览器中，登录到 Google Play 开发人员帐户。 登录后，可能会显示一条消息，告知 Google 尚未验证该应用。 如果发生这种情况，请选择“ 继续 ”按钮：

在 Web 浏览器中，选择“ 继续 ”按钮以授权应用：

Web 浏览器将收到验证码。

重要

不要关闭 Web 浏览器。

在 Visual Studio 的“ 分发 - Google Play 帐户 ”对话框中，选择“ 继续”：

在 “分发 - Google Play Track ”对话框中，选择要将应用上传到的曲目。 Google Play 提供五个用于上传应用的轨道：

重要

如果未看到自定义曲目，请确保已在 Google Play Console 中为该曲目创建了一个版本。 有关详细信息，请参阅在 support.google.com 上准备和推出版本 。

选择要将应用上传到的曲目，然后选择“ 上传 ”按钮：

有关 Google Play 测试的详细信息，请参阅在 support.google.com 上设置开放、关闭或内部测试 。

Visual Studio 将开始将应用发布到 Google Play。 在“ 签名密码 ”对话框中，输入为签名标识创建的密码，然后选择“ 确定 ”按钮：

Visual Studio 将对应用捆绑包进行签名，并将其上传到 Google Play。

重要

提交到 Google Play 的应用通常会经过评审过程。 有关详细信息，请参阅 准备应用以供审阅 和 在 support.google.com 上发布应用 。