Вместо загрузки большого .zip
файла, содержащего все файлы .unitypackage
для .NET 3.X и .NET 4.X, вы можете загрузить отдельные пакеты с сайта API Google для Unity .
Сайт предоставляет:
- Отдельные файлы .NET 4.X
.unitypackage
для импорта в качестве пакетов ресурсов. - Отдельные архивы
.tgz
для импорта с помощью диспетчера пакетов Unity.
Это особенно полезно, когда ваше приложение использует один продукт Firebase, поскольку отдельные файлы .unitypackage
содержат все необходимые зависимости, а файлы .tgz
перечислены вместе со связанными файлами .tgz
, от которых они зависят.
На этой странице приведены инструкции по использованию диспетчера пакетов Unity, поэтому полезно узнать об этом инструменте из документации Unity .
Импорт пакетов Firebase в качестве активов
При импорте продуктов Firebase из файлов .unitypackage
, загруженных с сайта API Google для Unity , имейте в виду следующее:
Если вы используете несколько продуктов Firebase в своем проекте, вы должны загрузить и обновить все продукты Firebase до одной и той же версии.
Не смешивайте методы импорта в одном проекте. То есть не импортируйте продукты Firebase с потоком пакетов активов и с использованием потока диспетчера пакетов Unity.
После скачивания для импорта:
В открытом проекте Unity перейдите к Assets > Import Package > Custom Package .
В окне «Импорт пакета Unity» нажмите «Импорт» .
Импорт пакетов Firebase с помощью диспетчера пакетов Unity
При импорте продуктов Firebase из файлов .tgz
, загруженных из архива API Google для Unity , имейте в виду следующее:
Этот метод доступен только в версии 2018.3+.
Если вы используете несколько продуктов Firebase в своем проекте, вы должны загрузить и обновить все продукты Firebase до одной и той же версии.
Не смешивайте методы импорта в одном проекте. То есть не импортируйте продукты Firebase с потоком пакетов ресурсов и с потоком диспетчера пакетов Unity.
Зависимости для каждого файла
.tgz
продукта связаны вместе с их собственными файлами.tgz
. Вы должны загрузить и импортировать файл.tgz
продукта и файлы зависимостей.tgz
в правильном порядке:- Внешний диспетчер зависимостей (
com.google.external-dependency-manager
) - Ядро Firebase (
com.google.firebase.app
) - Продукты Firebase, используемые в вашем проекте. Если вы используете базу данных реального времени или облачное хранилище, сначала импортируйте аутентификацию (
com.google.firebase.auth
).
- Внешний диспетчер зависимостей (
После загрузки импортируйте файлы .tgz
в свой проект одним из следующих способов:
Пользовательский интерфейс диспетчера пакетов
- Откройте окно диспетчера пакетов Unity.
- Щелкните значок
+
в верхнем левом углу окна диспетчера пакетов и выберитеAdd package from tarball
, чтобы открыть файловый браузер. - Выберите нужный архив в файловом браузере.
Некоторые старые версии Unity 2019 не поддерживают прямое добавление архивов. В этом случае вам потребуется:
- Разархивируйте файл
.tgz
. - Щелкните значок
+
в верхнем левом углу окна диспетчера пакетов и выберитеAdd package from disk
, чтобы открыть файловый браузер. - Выберите извлеченную папку в файловом браузере.
manifest.json
- Создайте новую папку рядом с папкой
Packages
вашего проекта и назовите ееGooglePackages
. - Поместите файлы
.tgz
в эту папку. - Используйте текстовый редактор, чтобы открыть
Packages/manifest.json
в папке вашего проекта Unity. Добавьте запись для каждого пакета, который вы хотите импортировать, сопоставив имя пакета с местоположением на диске. Обязательно добавьте
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 не поддерживают файлы .tgz
в manifest.json
. В этом случае вам следует:
- Разархивируйте файл
.tgz
. Отредактируйте
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 на пакеты активов
В некоторых случаях вы можете захотеть переключиться с использования диспетчера пакетов Unity для отслеживания продуктов Firebase на импорт продуктов в папке Assets
.
Если вы не уверены, какой метод импорта используете, в папке проекта Unity откройте файл Packages/manifest.json
. Если файл содержит записи, начинающиеся с com.google.firebase
, в вашем проекте для импорта использовался диспетчер пакетов Unity.
Чтобы перейти на пакеты ресурсов:
Обратите внимание на текущие версии пакетов Firebase в вашем проекте и удалите их.
- В меню «Окно» выберите «Диспетчер пакетов» . В окне диспетчера пакетов убедитесь, что выбрано «Пакеты: в проекте».
- Обратите внимание на версии импортированных пакетов Firebase.
- Нажмите на имя каждого пакета, затем нажмите «Удалить» . Обязательно удалите пакет External Dependency Manager (
.com.google.external-dependency-manager
), а также пакеты Firebase.
Загрузите и импортируйте заменяющие файлы
.unitypackage
. У вас есть два варианта:- Если вы можете выполнить обновление до последней версии каждого пакета, загрузите zip-файл Firebase Unity SDK и импортируйте его, как описано в разделе «Добавление Firebase в ваш проект Unity ».
- Если вам нужно сохранить текущие версии
.unitypackage
, вы можете загрузить и импортировать отдельные пакеты, как описано выше на этой странице.
Переход с пакетов ресурсов на диспетчер пакетов Unity
В некоторых случаях может потребоваться переключиться с импорта продуктов из папки Assets
на импорт и отслеживание продуктов с помощью диспетчера пакетов Unity.
Если вы не уверены, какой метод импорта используете, в папке проекта Unity откройте файл Packages/manifest.json
. Если файл содержит записи, начинающиеся с com.google.firebase
, ваш проект уже использует диспетчер пакетов Unity для импорта.
Чтобы перейти на диспетчер пакетов Unity:
Убедитесь, что все пакеты Firebase и пакет External Dependency Manager удалены из папки
Assets
одним из следующих способов.Пользовательский интерфейс EDM4U
- В открытом проекте Unity перейдите в Assets > External Dependency Manager > Version Handler > Uninstall Managed Packages .
- Выберите все пакеты Firebase и External Dependency Manager.
- Щелкните Удалить выбранный пакет .
Ручное удаление
С помощью инструментов файловой системы вручную удалите следующие папки:
-
Assets/Editor Default Resources/Firebase
-
Assets/ExternalDependencyManager
-
Assets/Firebase
-
Assets/Parse
-
Assets/Plugins/iOS/Firebase
Импортируйте пакеты с помощью диспетчера пакетов Unity, как описано выше на этой странице.