Catch up on everything we announced at this year's Firebase Summit. Learn more

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

Вместо загрузки большого .zip - файл , содержащий все .unitypackage файлов как для .NET 3.X и 4.X .NET, вы можете загрузить отдельные пакеты из API , Google для сайта Unity .

На сайте представлены:

  • Индивидуальный .NET 4.X .unitypackage файлов для установки в качестве пакетов активов.
  • Индивидуальные .tgz архивы для установки с помощью Unity Package Manager.

Это особенно полезно , когда ваше приложение использует один Firebase продукт, так как отдельные .unitypackage файлы содержат всю необходимую зависимость, и .tgz файлы отображаются в списке связанных .tgz файлы , на которых они зависят.

Эта страница содержит инструкции , связанные с Unity Package Manager, так что это хорошая идея , чтобы узнать об инструменте из документации Unity .

Установить пакеты Firebase как активы

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

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

  • Не смешивайте методы установки в одном проекте. То есть не устанавливайте продукты Firebase с потоком пакетов Asset и с помощью потока Unity Package Manager.

После скачивания для установки:

  1. В открытом проекте Unity, перейдите в Assets> Import Package> Индивидуальный пакет.

  2. В окне Import Unity Package, нажмите кнопку Импорт.

Установите пакеты Firebase с помощью Unity Package Manager

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

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

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

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

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

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

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

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

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

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

  1. Разархивируйте .tgz файл.
  2. Нажмите + значок в верхнем левом углу окна Package Manager и выберите 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 Package Manager на пакеты активов

В некоторых случаях вы можете переключаться с помощью Unity Package Manager для отслеживания продуктов Firebase, установкой продуктов под Assets папку.

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

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

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

    1. В меню Window выберите Package Manager. В окне Package Manager, убедитесь , что «пакеты: В Project» выбран.
    2. Обратите внимание на версии установленных пакетов Firebase.
    3. Нажмите на название пакета, а затем нажмите кнопку Удалить. Не забудьте удалить пакет внешнего Dependency Manager ( .com.google.external-dependency-manager ), а также пакеты Firebase.
  2. Загрузка и замена импорта .unitypackage файлов. У вас есть два варианта:

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

Переход с пакетов ресурсов на Unity Package Manager

В некоторых случаях вы можете захотеть , чтобы перейти от установки продукции под Assets папки для установки и сопровождения продуктов с Unity Package Manager.

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

Чтобы перейти на Unity Package Manager:

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

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

    1. В открытом проекте Unity, перейдите к Assets> External Dependency Manager> Версия Handler> Удаление управляемых пакетов.
    2. Выберите все пакеты Firebase и диспетчер внешних зависимостей.
    3. Нажмите Uninstall выбранного пакета.

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

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

    • Assets/Editor Default Resources/Firebase
    • Assets/ExternalDependencyManager
    • Assets/Firebase
    • Assets/Parse
    • Assets/Plugins/iOS/Firebase
  2. Установка пакетов с помощью Unity Package Manager, как описано выше на этой странице.