Управление пакетами
Пакет (Package) представляет собой набор файлов и данных для проектов UNIGINE, которые хранятся в одном файле *.upackage. Пакет сжимает данные, сохраняя при этом исходную структуру каталогов. Пакеты можно использовать для удобной передачи файлов между вашими проектами или обмена данными с другими пользователями, будь то контент (отдельная модель или сцена с набором объектов, управляемых логикой, реализованной с помощью компонентов C#) или файлы (плагины, библиотеки, исполняемые файлы и т.д.).
Создание пакета#
UnigineEditor позволяет экспортировать в файл пакета как ассеты из Asset Browser, так и внешние файлы (т.е. файлы, хранящиеся вне каталога data_path).
В целом процесс аналогичен для обоих случаев, однако есть некоторые различия.
Экспорт ассетов из Браузера ассетов#
Чтобы экспортировать ассеты из Asset Browser в файл пакета:
-
В строке меню выберите Packages -> Export Package, а затем нажмите кнопку Add Assets From Asset Browser в открывшемся окне Export Package.
-
В окне Select Assets выберите ассеты, которые вы хотите добавить в пакет, и нажмите OK. Вы даже можете выбрать папку, содержащую весь проект целиком, а затем отменить выбор данных, которые вам не нужны, на следующем шаге.
Обратите внимание, что вы можете сделать то же самое в Asset Browser: щелкните правой кнопкой мыши необходимый ассет(ы) или папку(папки) и выберите опцию Export As Package в контекстном меню.
-
Теперь вы можете выбрать ассеты для экспорта в окне Export Package, установив флажок для каждого ассета.
ПримечаниеИмейте в виду, что любой отдельный файл, который вы хотите добавить, должен быть размером менее 2 ГБ. Размер пакета не ограничен. -
Вы можете автоматически добавить все зависимые ассеты в пакет (текстуры, используемые материалом, материалы, назначенные объекту, и т.д.) с помощью флажка Include Dependencies (зависимые ассеты отмечены зеленым цветом в списке).
-
После выбора ассетов нажмите Export Package, чтобы упаковать их в новый файл *.upackage.
ПримечаниеДля активации кнопки Export Package необходимо выбрать по крайней мере один ассет. - В открывшемся диалоговом окне укажите имя и путь к вашему пакету и нажмите Save.
Как только ваш пакет ассетов будет успешно создан, местоположение вашего файла *.upackage будет показано в вашем файловом менеджере.
Экспорт внешних файлов#
Чтобы скопировать внешние файлы (т.е. файлы проекта, хранящиеся вне каталога data_path) в файл пакета:
- Откройте окно Export Package: в строке меню выберите Packages -> Export Package. Если вы уже добавили ассеты из Asset Browser, вы можете пропустить этот шаг, так как окно открыто.
-
Нажмите кнопку Add External Files, выберите файлы или папки в открывшемся диалоговом окне и нажмите Open. Обратите внимание, что внешние папки окрашены в красный цвет, в то время как папки из Asset Browser — в синий.ПримечаниеВы не можете добавлять файлы, хранящиеся вне папки проекта.
- Выберите файлы и/или папки для экспорта, нажмите Export Package, укажите имя и путь к новому файлу *.upackage и нажмите Save.
Импорт пакета#
Чтобы импортировать содержимое существующего пакета в ваш проект, вам необходимо сделать следующее:
-
Перетащите его из проводника прямо в Asset Browser или выберите Packages -> Import Package в строке меню и выберите файл *.upackage. Вы также можете щелкнуть правой кнопкой мыши на Asset Browser, выбрать Import New Asset в контекстном меню и выбрать пакет.Если вы уже добавили файл *.upackage в свой целевой проект, дважды щелкните по нему.ПримечаниеНе используйте файловый менеджер вашей операционной системы для копирования пакета в папку вашего проекта, так как в этом случае пакет будет отображаться в Asset Browser, но его содержимое не будет извлечено.Откроется следующее окно:
- Проверьте ассеты, которые будут импортированы. Ассеты в пакете могут быть окрашены в белый, красный и желтый цвета:
- Ассеты белого цвета могут быть импортированы без каких-либо изменений.
- Ассеты желтого цвета импортируются с постфиксом для устранения коллизии имен.
-
Ассеты красного цвета не могут быть импортированы по одной из следующих причин:
- Такой же ассет уже есть в проекте.
- В проекте найден ассет с таким же исходным идентификатором среды выполнения GUID.
- Ассет с таким же идентификатором среды выполнения найден в проекте.
- Указанная целевая точка монтирования (mount point) доступна только для чтения.
ПримечаниеЧтобы импортировать все зависимые ассеты для тех, которые выбраны, установите флажок Force Import Dependencies. Такие ассеты будут окрашены в зеленый цвет. Например, если вы снимите флажок с текстуры, используемой выбранным материалом, текстура все равно будет импортирована. - После выбора всех ассетов, необходимых для импорта, нажмите кнопку Import Package.
- Дождитесь завершения процесса извлечения. Время извлечения зависит от размера ассетов, выбранных для импорта.
Кроме ассетов, вы также можете импортировать файлы, хранящиеся в пакете. Если такой файл уже существует в проекте, он будет окрашен в красный цвет без возможности импорта.
После успешного импорта пакета в Asset Browser будет доступна новая папка с соответствующим содержимым и отобразится следующее сообщение:
Управление пакетом#
Пакеты, предоставляемые в магазине дополнений (Add-On Store), могут время от времени обновляться создателем пакета. В этом случае вам нужно будет удалить ранее добавленные файлы и добавить новую версию пакета. Окно Add-On Store Package History показывает все добавленные пакеты, загруженные из магазина дополнений, и помогает удалить файлы пакетов одним щелчком мыши.
Чтобы открыть окно Add-On Store Package History, выберите Packages -> Add-On Store Package History в меню.
Откроется следующее окно:
В этом окне представлены следующие сведения и опции:
| Imported Packages | Список пакетов из магазина дополнений, которые были импортированы в этот проект. |
|---|---|
| File Hierarchy |
|
| Description |
|
При выполнении каких-либо операций через окно Add-On Store Package History проверьте окно консоли редактора.