Установите пакеты Google для Unity

Пакеты Google для Unity распространяются в двух разных форматах:

• Пакеты активов :
  • Имейте расширение .unitypackage .
  • Установите в каталог Assets вашего проекта.
  • Можно импортировать в Unity 5 и выше.
  • Обычно включают зависимые пакеты.
• Пакеты Unity Package Manager (UPM) :
  • Иметь расширение .tgz .
  • Установите в каталог Packages вашего проекта.
  • Можно импортировать в Unity 2018.4 и более поздних версий.
  • Зависимые от ссылки пакеты, которые необходимо устанавливать отдельно.

Страница «Пакеты» содержит последние файлы .unitypackage для всех доступных пакетов и файлы .tgz для некоторых пакетов.

Страница «Архив» содержит файлы .unitypackage и .tgz для всех версий пакета.

Ниже вы можете найти инструкции по установке обоих типов пакетов, а также инструкции по переходу с одного типа на другой.

Ознакомившись с этими вариантами установки, обязательно ознакомьтесь с дополнительными инструкциями Firebase для конкретного продукта .

Импорт пакетов с помощью OpenUPM

Вы можете добавить внешние пакеты в свой проект Unity, используя реестр OpenUPM. OpenUPM содержит множество полезных плагинов и SDK, таких как плагин Google Play Integrity, который помогает защитить ваше приложение от мошенничества и злоупотреблений.

Вот как можно добавить, например, плагин Google Play Integrity с помощью OpenUPM.

OpenUPM-CLI

Если у вас установлен интерфейс командной строки OpenUPM, вы можете установить реестр OpenUPM с помощью следующей команды:

openupm add com.google.play.integrity

ОпенУПМ

1. Откройте настройки менеджера пакетов , выбрав пункт меню Unity Edit > Project Settings > Package Manager .

2. Добавьте OpenUPM в качестве реестра с заданной областью в окно диспетчера пакетов:

   Name: package.openupm.com
   URL: https://package.openupm.com
   Scopes: com.google.external-dependency-manager
    com.google.play.common
    com.google.play.core
    com.google.play.integrity
   

3. Откройте меню диспетчера пакетов , выбрав пункт меню Unity «Окно» > «Диспетчер пакетов» .

4. Установите раскрывающийся список области менеджера, чтобы выбрать «Мои реестры» .

   

5. Выберите плагин Google Play Integrity для пакета Unity из списка пакетов и нажмите «Установить» .

Импорт пакетов активов с файлами .unitypackage

Импортируйте файл .unitypackage , выбрав пункт меню Unity Assets > Import package > Custom Package и импортировав все элементы. Это добавит содержимое пакета в ваш проект в каталоге Assets.

Примечание. Если вы уже установили пакет с помощью окна диспетчера пакетов Unity, удалите старую версию пакета перед импортом новой. Инструкции см. ниже .

Импорт пакетов UPM с файлами .tgz (2018.4+)

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

манифест.json

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

4. Добавьте запись для каждого пакета, который вы хотите установить, сопоставив имя пакета с местоположением на диске относительно файла Packages/manifest.json . Обязательно добавьте file: к пути к файлу .tgz . Например, если вы устанавливали com.google.firebase.storage и его зависимости, ваш манифест.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. Сохраните файл манифеста.json.

6. Когда Unity восстановит фокус, он перезагрузит файл манифеста.json и импортирует вновь добавленные пакеты.

Некоторые старые версии Unity не поддерживают файлы .tgz в файле манифеста.json. В этом случае вам следует:

1. Распакуйте файлы .tgz .
2. Поместите извлеченную папку в папку GooglePackages .

3. Отредактируйте свой манифест.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...
     }
   }
   

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

1. Откройте окно диспетчера пакетов Unity.

2. Нажмите значок + в верхнем левом углу окна «Диспетчер пакетов» и выберите Add package from tarball чтобы открыть браузер файлов.

   

3. Выберите нужный архив в браузере файлов.

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

1. Распакуйте файл .tgz .

2. Нажмите значок + в верхнем левом углу окна «Диспетчер пакетов» и выберите Add package from disk чтобы открыть браузер файлов.

   

   Примечание. Unity 2018 размещает значок + в левом нижнем углу панели списка пакетов.

3. Выберите извлеченную папку в браузере файлов.

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

Например, если вы устанавливали com.google.firebase.storage , вы должны установить эти файлы .tgz в следующем порядке:

1. Диспетчер внешних зависимостей ( com.google.external-dependency-manager )
2. Firebase Core ( com.google.firebase.app )
3. Аутентификация Firebase ( com.google.firebase.auth )
4. Хранилище Firebase ( com.google.firebase.storage )

Если вы предпочитаете добавить все файлы .tgz сразу, не беспокоясь о порядке, вы можете следовать инструкциям на вкладке Manifest.json .

Примечание. Если вы уже установили пакет с файлом .unitypackage , обязательно удалите эту версию пакета перед добавлением новой. Инструкции см. ниже .

Контроль версий

Если вы используете программное обеспечение для контроля версий для управления файлами проекта, мы рекомендуем добавить соответствующие файлы .tgz в систему контроля версий. Вы можете вручную отредактировать manifest.json вашего проекта.json (см. инструкции выше ) и ссылаться на локальные файлы .tgz используя относительные пути.

Если вы используете git, мы рекомендуем Git Large File Storage (LFS) для управления большими файлами .tgz .

Миграция с пакетов UPM на пакеты активов

В некоторых случаях вам может потребоваться переключиться с использования Unity Package Manager для управления пакетами Google на установку пакетов в папке «Ресурсы».

Убедитесь, что все пакеты Google удалены из диспетчера пакетов Unity одним из следующих методов:

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

1. Откройте окно диспетчера пакетов Unity.

2. Выберите In Project в раскрывающемся списке в левом верхнем углу.

   

3. Введите com.google в строку поиска, чтобы отфильтровать пакеты Google.

   

4. Нажмите на имя каждого пакета, затем нажмите Remove .

манифест.json

1. С помощью текстового редактора откройте Packages/manifest.json в папке проекта Unity.
2. Проверьте, есть ли какие-либо пакеты от Google в разделе «зависимости». Имя пакета должно начинаться с «com.google», например «com.google.firebase.app».
3. Удалите эти строки и сохраните файл JSON.
4. Когда Unity восстановит фокус, она перезагрузит файл manifest.json и удалит удаленные пакеты.

После удаления этих пакетов из Unity Package Manager вы можете загрузить и импортировать заменяющие файлы .unitypackage со страницы архива .

Миграция с пакетов активов на пакеты UPM

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

Если вы не уверены, какой метод установки вы используете, в пользовательском интерфейсе Unity проверьте, отображаются ли нужные пакеты Google на вкладке «Проект» в разделе «Ресурсы».

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

1. Убедитесь, что все пакеты Google удалены из папки «Ресурсы».

   • Чтобы удалить пакеты Firebase, следуйте этим инструкциям .
   • Чтобы удалить плагины Play для Unity, удалите папку GooglePlayPlugins в разделе Assets .

2. Установите пакеты с помощью Unity Package Manager, как описано выше .

Инструкции по миграции для конкретного продукта

Инструкции по Firebase см. здесь .