在 UDP 控制台上管理和发布您的游戏

重要
Unity 分发门户 (UDP) 将于 2025 年 2 月 17 日关闭。届时，UDP Web 控制台和服务将永久停用。要下载您的密钥库以及有关如何将游戏直接重新发布到应用商店的说明，请访问UDP 概述页面。如果您对您的帐户有任何疑问，请通过Unity 客户支持提交工单。

将您的游戏上传到 UDP 控制台

在 Unity 编辑器中构建游戏后，UDP 控制台需要使用每个商店的 SDK 重新打包它，然后才能将游戏发布到受支持的商店。要将您的构建上传到 UDP 控制台，请按照以下步骤操作。注意：UDP 控制台仅接受具有 UDP 实现的APKUnity 输出的 Android 包格式。当您选择“文件”>“构建并运行”时，APK 会自动部署到您的设备。更多信息
请参阅词汇表或 AAB。

1. 在 UDP 控制台中，在“我的游戏”中选择您的项目。
2. 在“游戏信息”选项卡中，转到“二进制文件”部分。
   • 选择“上传 APK”并上传游戏的 APK 文件（以及任何 OBB 文件）。
   • 要上传 AAB 文件，请选择“从 AAB 文件转换”并上传文件。

您还可以通过以下方式将游戏部署到 UDP 控制台

• 使用 UDP API
• 将您的 APK 上传到构建自动化，然后从那里部署到 UDP
• 使用构建自动化构建您的游戏，然后从那里部署到 UDP

使用 UDP API 将您的游戏上传到 UDP 控制台

您只能使用UDP API上传游戏草稿版本的二进制文件。如果您的游戏没有草稿版本，UDP 会根据您游戏的最新版本创建一个。如果上传过程成功，UDP 会返回状态代码为 200 的“上传成功”消息。如果上传过程不成功，UDP 会返回带有非 2xx 状态代码的错误消息。

您可以上传以下任一文件：

• APK 文件、主 OBB 文件（可选）和补丁 OBB 文件（可选）。
  这会覆盖 UDP 控制台中任何现有的 AAB 文件。
• AAB 文件。
  这会覆盖 UDP 控制台中任何现有的 APK 或 OBB 文件。

您一次只能上传一个二进制文件；您无法为一个命令指定多个二进制文件。如果您多次上传相同类型的二进制文件，则最新的文件会覆盖之前的文件。

先决条件

要使用 UDP API，您需要：

• 来自 UDP 控制台的有效身份验证令牌。
  要在 UDP 控制台中生成身份验证令牌，请转到“开发者 API”页面并选择“新建令牌”。
• 用于发送 HTTPS POST 消息的工具。Unity 建议使用curl。

上传二进制文件

要使用 UDP API 将二进制文件上传到 UDP 控制台，请使用 HTTP POST 方法，并将Content-Type设置为multipart/form-data。有关支持的 API 参数的信息，请参阅UDP API。

上传 APK 文件

要上传 APK 文件，请在 POST 方法中使用表单键uploadFile指定 APK 文件的路径。

示例

$ curl -XPOST -F 'whatsNew="example"' -F 'useGoogleService=false'  -F 'uploadFile=@/path/to/your/APK/example.apk'
https://distribute.dashboard.unity.com/developer/api/upload/12369536319506/1d1a4cxq774MzPKwsiHgXA?token=NWQxMWIzZmYyNjk0Njc2NGYwMDU0ZTA3ZTk3YjA2ZDA=

上传 AAB 文件

要上传 AAB 文件，请使用表单键uploadFile指定 AAB 文件的路径。

示例

$ curl -XPOST -F 'whatsNew="example"' -F 'useGoogleService=true  -F 'uploadFile=@/path/to/your/AAB/example.aab'
https://distribute.dashboard.unity.com/developer/api/upload/12369536319506/1d1a4cxq774MzPKwsiHgXA?token=NWQxMWIzZmYyNjk0Njc2NGYwMDU0ZTA3ZTk3YjA2ZDA=

上传 OBB 文件

要上传 OBB 文件，请执行以下操作：

1. 使用表单键uploadFile指定 OBB 文件的路径。
2. 指定 OBB 类型。将查询参数键obbType设置为mainObb或patchObb。

示例主 OBB 文件上传

$ curl -XPOST -F 'uploadFile=@/path/to/your/OBB/exampleMain.obb'
https://distribute.dashboard.unity.com/developer/api/upload/12369536319506/1d1a4cxq774MzPKwsiHgXA?token=NWQxMWIzZmYyNjk0Njc2NGYwMDU0ZTA3ZTk3YjA2ZDA=&obbType=mainObb

示例补丁 OBB 文件上传

$ curl -XPOST -F 'uploadFile=@/path/to/your/OBB/examplePatch.obb'
https://distribute.dashboard.unity.com/developer/api/upload/12369536319506/1d1a4cxq774MzPKwsiHgXA?token=NWQxMWIzZmYyNjk0Njc2NGYwMDU0ZTA3ZTk3YjA2ZDA=&obbType=patchObb

完成游戏信息

在您能够将游戏发布到 UDP 控制台上的商店之前，请按照以下步骤操作：

1. 编辑您的游戏信息，包括：
   1. 检查“沙盒测试”部分以确保测试成功。
   2. 上传您的应用签名私钥
   3. 指示您是否使用广告。
   4. 设置高级价格（如果适用）。
   5. 本地化您的游戏信息以支持其他语言（如果适用）。
   6. 完成您的 IAP 产品。
2. 发布您的游戏版本.

然后您可以继续发布您的游戏。

发布您的版本

要能够将游戏发布到商店，您需要发布它。当您保存了版本草稿并准备发布它时，请执行以下操作：

1. 在“游戏信息”页面中，选择“发布”。
   将打开一个窗口以输入发布信息。
2. 输入“发布说明”和“发布标签”以跟踪您的版本。
3. 选择“发布”。

版本是游戏的已发布版本。这使您能够随着时间的推移存储对应用商店提交的更改记录。

版本的关键组件包括：

• 您的游戏构建（APK 文件）
• 您的 IAP 目录
• 您的游戏元数据

如果您更改了其中一个元素，则您的商店提交将发生更改，并且您必须创建新的版本。版本系统是增量的（每次 +1），并由 UDP 管理。您无法创建自定义版本号。在发布新版本时使用版本说明和标签，以帮助您跟踪版本。

注意：如果在 UDP 控制台上保存了版本草稿但未发布，则您无法推送来自编辑器的更改，这些更改会增加版本号。

编辑版本

要覆盖现有的版本草稿。

1. 选择要编辑的现有版本。您的新草稿将继承此版本的所有游戏信息数据。
2. 选择“编辑”以进行更改。
3. 保存更改以创建版本草稿。
4. 要使此草稿成为最新版本，请选择“发布”。
   1. 输入发布说明和发布标签以跟踪您的版本。
      版本号将从最高的已发布版本增加 1。这将成为最新的版本草稿

将您的游戏发布到商店

使用“发布”面板将您的游戏发布到商店。您只能将已发布的版本发布到商店。

对于要提交游戏的每个商店，请按照以下步骤操作：

1. 在商店注册.
2. 在商店注册您的游戏.
3. 将您的游戏提交到商店.
4. 设置高级设置.
5. 添加公司信息.
6. 当您为所有商店完成设置后，请选择“发布”。

有关发布到特定商店的帮助，请参阅 UDP 控制台中的“文档”>“合作伙伴商店指南”。

发布游戏后，您可以在报告仪表板中监控其性能。

在商店注册

要能够将游戏发布到商店，您需要在商店拥有帐户。

要在商店创建帐户，请执行以下操作：

1. 在“发布”页面中，选择“在<商店名称>中注册”。
   对于某些商店，您可能会被重定向到 UDP 控制台外部，以完成在商店中的注册过程。
2. 按照商店的入门流程进行操作。

在商店注册后，您可以注册您的游戏。

注意：只有组织所有者和管理员才能在商店注册。有关更多详细信息，请参阅与组织相关的权限。

商店帐户针对每个 Unity 组织。您通过 UDP 发布的任何游戏都将附加到您发布游戏的组织。如果您在不同的组织下访问 UDP 控制台，则需要重新注册并创建不同的帐户。有关如何在各个商店注册的更多信息，请参阅 UDP 控制台中的“文档”>“合作伙伴商店指南”。

在商店注册您的游戏

在商店注册后，您可以将游戏注册到该商店。

1. 在“发布”页面中，选择“在<商店名称>中注册您的游戏”。
2. 确认您要与商店注册的包名称，然后选择“注册”。某些商店在注册游戏时会要求提供其他信息。

当您的游戏在商店注册后，您将无法再更改该商店的包名称。

如果您使用 UDP 生成应用签名私钥，则 UDP 会生成特定于商店的密钥来签署重新打包的构建。这也可能影响集成到您游戏中的第三方服务。当您的游戏重新打包后，特定于商店的证书在“高级”部分可用。

以这种方式签署重新打包的构建会使您的游戏更容易受到 Google Play Protect 警告的影响。

将您的游戏提交到商店

在“发布”选项卡中，为给定商店选择目标步骤。

1. 要首次将游戏发布到商店，请选择该商店的复选框。
2. 选择“提交到商店”。
   UDP 会重新打包并将您的游戏提交到商店。

UDP 为您发布到的每个商店创建一个单独的构建，其中仅包含所需的特定于商店的 SDK。每个特定于商店的构建都使用特定于您的游戏和每个商店的 UDP 证书进行签名。您可以在每个商店的“高级”部分查找和检索证书。

此外，UDP 会在必要时向包名称添加特定于商店的后缀。如果需要，UDP 控制台将在注册步骤中显示此信息。

注意：如果需要，您可以在“发布”页面中配置：

• 您要发布游戏的国家/地区
• 游戏的高级设置

将不同的版本提交到不同的商店

您只能将最新的已发布版本提交到商店。如果您打算将不同的版本提交到不同的商店，Unity 建议您使用发布标签和说明来识别您的版本。

示例：您要将一个版本提交到 StoreA，将另一个版本提交到 StoresBCD。

1. 创建 StoreA 的版本（例如，版本 1）。在发布版本 1 时，编写清晰的发布说明，并将您的发布标记为“StoreA”。
   1. 将版本 1 提交到 StoreA。
2. 为 StoresBCD 创建一个新版本。此版本草稿最终将成为版本 2。在发布版本 2 时，编写清晰的发布说明，并将您的发布标记为“StoresBCD”。
3. 将版本 2 提交到 StoresBCD。
4. 当您需要向 StoreA 提交新版本时，您可以根据之前对该商店的提交进行操作。您的发布标签将显示版本 1 是最后标记为“StoreA”的版本。
5. 选择版本 1 并对其进行编辑。这将基于版本 1 创建一个版本草稿。当您发布它时，它将成为版本 3（因为版本 2 已经发布）。
6. 在发布版本 3 时，继续使用 StoreA 标签。将版本 3 提交到 StoreA。

重新打包您的游戏

如果您之前已将游戏提交到商店，则可以重新打包游戏，而无需上传新的 IAP 目录。这将使用最近提交的 IAP 目录。

1. 要重新打包而无需上传新的 IAP 目录，请选择该商店的复选框。
2. 选择“重新打包游戏”。

在您将重新打包的构建提交到商店之前，请从“状态”选项卡下载 APK 并对其进行测试，以确保您的应用内购买在商店的商业环境中按预期工作。

注意：如果您提交了游戏的新版本，则不会覆盖您在商店的“高级设置”中所做的更改。

添加公司信息

要将您的游戏发布到 UDP 商店，您需要创建一个公司信息配置文件。商店会在其应用商店中您游戏的“关于开发者”部分显示此信息。您只需执行一次此操作。

1. 在 UDP 控制台中，选择设置 > 公司信息。
2. 输入并保存您的公司信息。

发布您的游戏

完成上述所有步骤后，发布您的游戏。

1. 在“发布”选项卡中，选择您要将此游戏版本提交到的每个商店。
2. 选择发布。

仅采用您游戏的最新发布版本，并通过为每个商店选择的目标步骤。

如果您的提交有任何问题，这些问题将显示在详细信息部分。

对于仅与 UDP 部分集成的商店，您必须在商店自己的开发者控制台中完成提交。为此，请在提交的版本旁边选择转到商店。工具提示会说明哪些步骤仍然需要执行。请按照链接并在商店的控制台中完成您的提交。

归档游戏

当您不再需要 UDP 控制台上的游戏时，可以将其归档。

要归档您的游戏

1. 转到我的游戏面板。
2. 选择您游戏的筛选条件。默认情况下，您可以查看所有活动游戏。
3. 将鼠标悬停在游戏上以显示更多菜单 (⋮)。
4. 选择归档。

归档游戏后，您可以将其恢复或从 UDP 控制台中删除。

删除游戏

要删除 UDP 控制台中不再需要的游戏

1. 按照归档游戏的步骤操作。
2. 将鼠标悬停在游戏上以显示更多菜单 (⋮)。
   1. 选择删除。

注意：这会永久从 UDP 控制台的“我的游戏”选项卡中删除游戏，以及报告面板中的所有游戏数据。

恢复已归档的游戏

要恢复已归档的游戏

1. 转到我的游戏面板。
2. 在选择条件中选择已归档筛选条件。
3. 在您要恢复的游戏上，选择更多菜单 (⋮)。
4. 选择恢复。