Catch up on highlights from Firebase at Google I/O 2023. Learn more

Дополнительные параметры установки Unity

Вместо загрузки большого .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.

После скачивания для импорта:

  1. В открытом проекте Unity перейдите к Assets > Import Package > Custom Package .

  2. В окне «Импорт пакета Unity» нажмите «Импорт» .

Импорт пакетов Firebase с помощью диспетчера пакетов Unity

При импорте продуктов Firebase из файлов .tgz , загруженных из архива API Google для Unity , имейте в виду следующее:

  • Этот метод доступен только в версии 2018.3+.

  • Если вы используете несколько продуктов Firebase в своем проекте, вы должны загрузить и обновить все продукты Firebase до одной и той же версии.

  • Не смешивайте методы импорта в одном проекте. То есть не импортируйте продукты Firebase с потоком пакетов ресурсов и с потоком диспетчера пакетов Unity.

  • Зависимости для каждого файла .tgz продукта связаны вместе с их собственными файлами .tgz . Вы должны загрузить и импортировать файл .tgz продукта и файлы зависимостей .tgz в правильном порядке:

    1. Внешний диспетчер зависимостей ( com.google.external-dependency-manager )
    2. Ядро Firebase ( com.google.firebase.app )
    3. Продукты Firebase, используемые в вашем проекте. Если вы используете базу данных реального времени или облачное хранилище, сначала импортируйте аутентификацию ( com.google.firebase.auth ).

После загрузки импортируйте файлы .tgz в свой проект одним из следующих способов:

Пользовательский интерфейс диспетчера пакетов

  1. Откройте окно диспетчера пакетов Unity.
  2. Щелкните значок + в верхнем левом углу окна диспетчера пакетов и выберите Add package from tarball , чтобы открыть файловый браузер.
  3. Выберите нужный архив в файловом браузере.

Некоторые старые версии Unity 2019 не поддерживают прямое добавление архивов. В этом случае вам потребуется:

  1. Разархивируйте файл .tgz .
  2. Щелкните значок + в верхнем левом углу окна диспетчера пакетов и выберите Add package from disk , чтобы открыть файловый браузер.
  3. Выберите извлеченную папку в файловом браузере.

manifest.json

  1. Создайте новую папку рядом с папкой Packages вашего проекта и назовите ее GooglePackages .
  2. Поместите файлы .tgz в эту папку.
  3. Используйте текстовый редактор, чтобы открыть Packages/manifest.json в папке вашего проекта Unity.

  4. Добавьте запись для каждого пакета, который вы хотите импортировать, сопоставив имя пакета с местоположением на диске. Обязательно добавьте 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 не поддерживают файлы .tgz в manifest.json . В этом случае вам следует:

  1. Разархивируйте файл .tgz .

  2. Отредактируйте 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.

Чтобы перейти на пакеты ресурсов:

  1. Обратите внимание на текущие версии пакетов Firebase в вашем проекте и удалите их.

    1. В меню «Окно» выберите «Диспетчер пакетов» . В окне диспетчера пакетов убедитесь, что выбрано «Пакеты: в проекте».
    2. Обратите внимание на версии импортированных пакетов Firebase.
    3. Нажмите на имя каждого пакета, затем нажмите «Удалить» . Обязательно удалите пакет External Dependency Manager ( .com.google.external-dependency-manager ), а также пакеты Firebase.

  2. Загрузите и импортируйте заменяющие файлы .unitypackage . У вас есть два варианта:

    • Если вы можете выполнить обновление до последней версии каждого пакета, загрузите zip-файл Firebase Unity SDK и импортируйте его, как описано в разделе «Добавление Firebase в ваш проект Unity ».
    • Если вам нужно сохранить текущие версии .unitypackage , вы можете загрузить и импортировать отдельные пакеты, как описано выше на этой странице.

Переход с пакетов ресурсов на диспетчер пакетов Unity

В некоторых случаях может потребоваться переключиться с импорта продуктов из папки Assets на импорт и отслеживание продуктов с помощью диспетчера пакетов Unity.

Если вы не уверены, какой метод импорта используете, в папке проекта Unity откройте файл Packages/manifest.json . Если файл содержит записи, начинающиеся с com.google.firebase , ваш проект уже использует диспетчер пакетов Unity для импорта.

Чтобы перейти на диспетчер пакетов Unity:

  1. Убедитесь, что все пакеты Firebase и пакет External Dependency Manager удалены из папки Assets одним из следующих способов.

    Пользовательский интерфейс EDM4U

    1. В открытом проекте Unity перейдите в Assets > External Dependency Manager > Version Handler > Uninstall Managed Packages .
    2. Выберите все пакеты Firebase и External Dependency Manager.
    3. Щелкните Удалить выбранный пакет .

    Ручное удаление

    С помощью инструментов файловой системы вручную удалите следующие папки:

    • Assets/Editor Default Resources/Firebase
    • Assets/ExternalDependencyManager
    • Assets/Firebase
    • Assets/Parse
    • Assets/Plugins/iOS/Firebase

  2. Импортируйте пакеты с помощью диспетчера пакетов Unity, как описано выше на этой странице.