版本:Unity 6 (6000.0)
语言:英语
与其他服务配合使用 UDP
UDP 参考

与 UDP 构建配合使用 Firebase

重要提示
Unity Distribution Portal (UDP) 将于 2025 年 2 月 17 日关闭。这一日期将永久停用对 UDP 网络控制台和服务功能的访问。要下载密钥库和有关如何直接在应用商店发布游戏的说明,请访问 UDP 概览 页面。如果您对帐户有任何疑问,请向 Unity 客户支持 提交工单。

在 Android 游戏中实施 Firebase 可让你利用 Firebase 产品层,例如 分析Unity Analytics 的缩写
参见 词汇表
Crashlytics。如果您的游戏使用 Firebase,则需要额外的 配置,以支持 Unity Distribution Portal (UDP) 为不同商店创建的构建。

当您的应用调用 Firebase 产品时,Firebase 会检查以下信息是否与在 Firebase 控制台上注册的信息匹配

  • 应用的包名
  • 应用所签名的证书
  • Android 包 (APK) 资源中的 google_app_id

这些详细信息必须匹配,以便 Firebase 提供准确的分析。

对于在其中通过 UDP 发布游戏的特定商店,UDP 会在包名后添加一个特定于商店的后缀。此外,如果您没有使用自己的私钥来生成证书,UDP 会为每个重新打包的构建生成一个证书。这些事件会导致您的证书和/或包名不再与 Firebase 控制台上的信息匹配。

如果您向需要包名后缀的商店注册应用,UDP 控制台会针对 Firebase 服务显示警告。

Firebase services warning in UDP console
UDP 控制台中 Firebase 服务警告

要使您的特定于商店的构建与 Firebase 正常配合使用,您必须向 Firebase 项目注册它们。以下部分说明了如何为 UDP 构建配置 Firebase。

为 UDP 构建配置 Firebase

本部分概述了为 UDP 构建(应用)配置 Firebase 所需的步骤。有关更详细的信息,请参阅 Firebase 文档

必备条件

注意:在注册您的应用的过程中,您可以下载 google-services.json 文件。Unity 建议您在下载此文件之前注册所有软件包版本。

  1. 使用 Firebase 注册您的应用.
    • 使用来自 UDP 控制台的商店特定软件包名称:我的游戏 > 发布 > 商店 > 高级页面。
  2. 在 Firebase 控制台中,转到项目设置一系列广泛的设置,允许您配置物理、音频、联网、图形、输入以及您项目的很多其他区域的表现方式。 更多信息
    请参阅词汇表
    并添加您的应用指纹商店证书。
    • 如果您使用自己的密钥,请用命令获取您的指纹
      keytool -keystore path-to-your-keystore -list -v
    • 如果您不使用自己的密钥,请使用对应的 UDP 商店的 SHA1 证书(UDP 控制台 > 我的游戏 > 发布 > 商店 > 高级
    • 您还可以下载 APK 证书并用命令获取指纹信息
      openssl x509 -in path-to-your-certificate -fingerprint -noout

对您想要链接到 Firebase 项目中的每个商店特定应用重复这些步骤。Firebase 为您添加的每个应用添加一个应用 ID。

注册完所有应用后,将 Firebase 配置文件添加到您的 Unity 项目中。

添加 Firebase 配置文件

在 Firebase 中注册应用时,Firebase 会创建一个 google-services.json 配置文件。将所有应用都添加到 Firebase 后,下载该文件并将其添加到您的项目中。

  1. 在 Firebase 控制台中,转到您的应用的项目设置页面。
  2. 下载 google-services.json 文件。
  3. 将 google-services.json 文件复制到您的 Unity 项目的资源文件夹中。

您的项目现在已针对 Firebase 正确配置。为确保您应用的稳定运行,请重新构建并发布您的项目。

在 UDP 控制台中添加您的 Firebase ID

对于您添加到 Firebase 中的每个构建,在 UDP 控制台中,添加应用 ID

  1. 从 Firebase 中复制构建特定的应用 ID。
  2. 在 UDP 控制台中,转到我的游戏 > 发布 > 商店 > 高级页面。
    1. 将应用 ID 粘贴到Firebase 应用 ID字段中。
    2. 选择保存

重新构建您的项目

  1. 在 Unity 编辑器中,重新构建您的项目
  2. 将您的构建上传到 UDP 控制台。
  3. 发布一个新的版本。
  4. 在“发布”选项卡中,选择你想要发布的各个商店。
    1. 将目标步骤设置为提交到商店
    2. 选择发布

有关这些步骤的更多信息,请参阅 在 UDP 控制台上管理和发布游戏

与其他服务配合使用 UDP
UDP 参考