Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. 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 одним из следующих способов.

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

    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, как описано выше на этой странице.