适用于 Unity 的 Google 软件包以两种不同的格式分发：
- 资源包：
- 扩展名为
.unitypackage。 - 安装到您项目的
Assets目录。 - 可在 Unity 5 及更高版本中导入。
- 通常包含依赖软件包。
- 扩展名为
- Unity Package Manager (UPM) 软件包：
- 扩展名为
.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
- 在项目的
Packages文件夹旁边创建一个新文件夹，并将其命名为GooglePackages。 - 将
.tgz文件放入该文件夹中。 - 使用文本编辑器打开 Unity 项目下的
Packages/manifest.json文件夹中。 为要安装的每个软件包添加一个条目，映射软件包名称 磁盘上的位置（相对于
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... } }保存 manifest.json 文件。
Unity 重新获得焦点后，将重新加载 manifest.json 并导入新添加的软件包。
某些旧版 Unity 不支持 manifest.json 中的 .tgz 文件。
在这种情况下，您应该：
- 解压缩
.tgz文件。 - 将解压缩的文件夹放在
GooglePackages文件夹中。 请修改 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... } }
软件包管理器界面
- 打开 Unity 的 Package Manager 窗口。
点击软件包管理器窗口左上角的
+图标，然后 选择Add package from tarball以打开文件浏览器。
在文件浏览器中选择所需的 tar 压缩文件。
某些旧版 Unity 不支持直接添加 tar 压缩文件。 在这种情况下，您需要执行以下操作：
- 解压缩
.tgz文件。 点击软件包管理器左上角的
+图标 窗口，然后选择Add package from disk以打开文件浏览器。
在文件浏览器中选择解压缩的文件夹。
此外，请务必导入软件包依赖项的 .tgz 文件。
您可以在归档页面下的
所需软件包的部分。
例如，如果您要安装 com.google.firebase.storage，则需要执行以下操作：
请按以下顺序安装这些 .tgz 文件：
- 外部依赖项管理器 (
com.google.external-dependency-manager) - Firebase 核心 (
com.google.firebase.app) - Firebase 身份验证 (
com.google.firebase.auth) - 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 软件包 使用下列任一方法：
软件包管理器界面
- 打开 Unity 的 Package Manager 窗口。
在左上角的下拉菜单中选择
In Project。
在搜索栏中输入
com.google，以过滤出 Google 软件包。
点击每个软件包名称，然后点击
Remove。
manifest.json
- 使用文本编辑器打开 Unity 项目下的
Packages/manifest.json文件夹中。 - 检查“dependencies”下是否有来自 Google 的软件包。软件包 名称应以“com.google”开头，例如“com.google.firebase.app”。
- 删除这几行并保存 json 文件。
- Unity 重新获得焦点后，将重新加载
manifest.json文件并移除 删除软件包
从 Unity Package Manager 卸载这些软件包后，您可以
从归档文件中下载和导入替换的 .unitypackage 文件
页面。
从资源包迁移到 UPM 包
在某些情况下，您可能不想在 使用 Unity Package Manager 安装和跟踪产品的资源树。
如果您不确定自己使用的是哪种安装方法，请在 Unity 界面中， 查看“Project”标签页下的 素材资源。
如需迁移到 UPM 文件包，请执行以下操作：
请务必从“Assets”文件夹中移除所有 Google 软件包。
- 如需卸载 Firebase 软件包，请按以下步骤操作： 这些说明。
- 如需卸载适用于 Unity 的 Play 插件，请删除
GooglePlayPlugins文件夹 低于Assets。
按照说明使用 Unity Package Manager 安装软件包 上方。
特定产品的迁移说明
请点击此处查看 Firebase 说明。