安装适用于 Unity 的 Google 软件包

适用于 Unity 的 Google 软件包以两种不同的格式分发:

  • 资源包: <ph type="x-smartling-placeholder">
      </ph>
    • 扩展名为 .unitypackage
    • 安装到您项目的 Assets 目录。
    • 可在 Unity 5 及更高版本中导入。
    • 通常包含依赖软件包。
  • Unity Package Manager (UPM) 软件包: <ph type="x-smartling-placeholder">
      </ph>
    • 扩展名为 .tgz
    • 安装到您项目的 Packages 目录。
    • 可在 Unity 2018.4 及更高版本中导入。
    • 引用需要单独安装的依赖软件包。

软件包页面包含最新的 .unitypackage 文件 以及 .tgz 文件(用于部分软件包)。

归档页包含 .unitypackage.tgz 文件, 所有软件包版本。

您可以在下面找到有关如何安装这两种软件包的说明,以及 提供了迁移说明,帮助您从一种类型转换为另一种类型。

熟悉这些安装选项后,请务必参阅 适用于 Firebase 的其他产品专用说明

使用 .unitypackage 文件导入资源包

通过选择 Unity 菜单选项,导入 .unitypackage 文件 Assets > Import package > Custom Package,正在导入所有项。 这会将软件包内容添加到您项目的“Assets”下 目录。

使用 .tgz 文件导入 UPM 软件包 (2018.4+)

使用以下方法之一将 .tgz 文件导入您的项目中:

manifest.json

  1. 在项目的 Packages 文件夹旁边创建一个新文件夹,并将其命名为 GooglePackages
  2. .tgz 文件放入该文件夹中。
  3. 使用文本编辑器打开 Unity 项目下的 Packages/manifest.json 文件夹中。
  4. 为要安装的每个软件包添加一个条目,映射软件包名称 磁盘上的位置(相对于 Packages/manifest.json 文件)。请务必将 file: 附加到 .tgz 文件路径。对于 例如,如果您要安装 com.google.firebase.storage 及其 则 manifest.json 如下所示:

    {
      "dependencies": {
        "com.google.external-dependency-manager": "file:../GooglePackages/com.google.external-dependency-manager-1.2.164.tgz",
        "com.google.firebase.app": "file:../GooglePackages/com.google.firebase.app-7.1.0.tgz",
        "com.google.firebase.auth": "file:../GooglePackages/com.google.firebase.auth-7.1.0.tgz",
        "com.google.firebase.storage": "file:../GooglePackages/com.google.firebase.storage-7.1.0.tgz",
        // com.unity package entries...
      }
    }
    
  5. 保存 manifest.json 文件。

  6. Unity 重新获得焦点后,将重新加载 manifest.json 并导入新添加的软件包。

某些旧版 Unity 不支持 manifest.json 中的 .tgz 文件。 在这种情况下,您应该:

  1. 解压缩 .tgz 文件。
  2. 将解压缩的文件夹放在 GooglePackages 文件夹中。
  3. 请修改 manifest.json 以使用解压缩的文件夹的路径 位于 .tgz 文件中,如下所示:

    {
      "dependencies": {
        "com.google.external-dependency-manager": "file:../GooglePackages/com.google.external-dependency-manager-1.2.164",
        "com.google.firebase.app": "file:../GooglePackages/com.google.firebase.app-7.1.0",
        "com.google.firebase.auth": "file:../GooglePackages/com.google.firebase.auth-7.1.0",
        "com.google.firebase.storage": "file:../GooglePackages/com.google.firebase.storage-7.1.0",
        // com.unity package entries...
      }
    }
    

软件包管理器界面

  1. 打开 Unity 的 Package Manager 窗口。
  2. 点击软件包管理器窗口左上角的 + 图标,然后 选择 Add package from tarball 以打开文件浏览器。

    Unity Package Manager 窗口的屏幕截图,其中包含

  3. 在文件浏览器中选择所需的 tar 压缩文件。

某些旧版 Unity 不支持直接添加 tar 压缩文件。 在这种情况下,您需要执行以下操作:

  1. 解压缩 .tgz 文件。
  2. 点击软件包管理器左上角的 + 图标 窗口,然后选择 Add package from disk 以打开文件浏览器。

    Unity Package Manager 窗口的屏幕截图,其中包含

  3. 在文件浏览器中选择解压缩的文件夹。

此外,请务必导入软件包依赖项的 .tgz 文件。 您可以在归档页面下的 所需软件包的部分。

例如,如果您要安装 com.google.firebase.storage,则需要执行以下操作: 请按以下顺序安装这些 .tgz 文件:

  1. 外部依赖项管理器 (com.google.external-dependency-manager)
  2. Firebase 核心 (com.google.firebase.app)
  3. Firebase 身份验证 (com.google.firebase.auth)
  4. Firebase 存储 (com.google.firebase.storage)

如果您希望一次性添加所有 .tgz 文件,而不用担心 有关该订单的详情,请按照 manifest.json 标签页

版本控制

如果您使用版本控制软件来管理项目文件, 建议将相关的 .tgz 文件添加到版本控制中。您可以手动 修改项目的 manifest.json(请参阅 上述说明),并使用以下命令引用本地 .tgz 文件: 相对路径。

如果您使用的是 Git,我们建议您 Git 大文件存储 (LFS) 用于管理大型 .tgz 文件。

从 UPM 文件包迁移到资源包

在某些情况下,您可能希望 Unity Package Manager 管理 Google 软件包、在 Assets 文件夹下安装软件包。

确保使用以下代码从 Unity Package Manager 中移除所有 Google 软件包 使用下列任一方法:

软件包管理器界面

  1. 打开 Unity 的 Package Manager 窗口。
  2. 在左上角的下拉菜单中选择 In Project

    Unity Package Manager 窗口的屏幕截图,其中包含

  3. 在搜索栏中输入 com.google,以过滤出 Google 软件包。

    包含 Unity Package Manager 窗口的屏幕截图

  4. 点击每个软件包名称,然后点击 Remove

manifest.json

  1. 使用文本编辑器打开 Unity 项目下的 Packages/manifest.json 文件夹中。
  2. 检查“dependencies”下是否有来自 Google 的软件包。软件包 名称应以“com.google”开头,例如“com.google.firebase.app”。
  3. 删除这几行并保存 json 文件。
  4. Unity 重新获得焦点后,将重新加载 manifest.json 文件并移除 删除软件包

从 Unity Package Manager 卸载这些软件包后,您可以 从归档文件中下载和导入替换的 .unitypackage 文件 页面

从资源包迁移到 UPM 包

在某些情况下,您可能不想在 使用 Unity Package Manager 安装和跟踪产品的资源树。

如果您不确定自己使用的是哪种安装方法,请在 Unity 界面中, 检查所需的 Google 软件包是否显示在“Project”标签页下的 素材资源。

如需迁移到 UPM 文件包,请执行以下操作:

  1. 请务必从“Assets”文件夹中移除所有 Google 软件包。

    • 如需卸载 Firebase 软件包,请按以下步骤操作: 这些说明
    • 如需卸载适用于 Unity 的 Play 插件,请删除 GooglePlayPlugins 文件夹 低于 Assets
  2. 按照说明使用 Unity Package Manager 安装软件包 上方

特定产品的迁移说明

请点击此处查看 Firebase 说明。