This page has been translated automatically.
Видеоуроки
Интерфейс
Основы
Продвинутый уровень
Подсказки и советы
Основы
Программирование на C#
Рендеринг
Профессиональный уровень (SIM)
Принципы работы
Свойства (properties)
Компонентная Система
Рендер
Режимы вывода изображения
Физика
Браузер SDK 2
Лицензирование и типы лицензий
Дополнения (Add-Ons)
Демонстрационные проекты
API Samples
Редактор UnigineEditor
Обзор интерфейса
Работа с ассетами
Контроль версий
Настройки и предпочтения
Работа с проектами
Настройка параметров ноды
Setting Up Materials
Настройка свойств
Освещение
Sandworm
Использование инструментов редактора для конкретных задач
Расширение функционала редактора
Встроенные объекты
Ноды (Nodes)
Объекты (Objects)
Эффекты
Декали
Источники света
Geodetics
World-ноды
Звуковые объекты
Объекты поиска пути
Player-ноды
Программирование
Основы
Настройка среды разработки
Примеры использования
C++
C#
UnigineScript
Унифицированный язык шейдеров UUSL (Unified UNIGINE Shader Language)
Плагины
Форматы файлов
Материалы и шейдеры
Rebuilding the Engine Tools
Интерфейс пользователя (GUI)
Двойная точность координат
API
Animations-Related Classes
Containers
Common Functionality
Controls-Related Classes
Engine-Related Classes
Filesystem Functionality
GUI-Related Classes
Math Functionality
Node-Related Classes
Objects-Related Classes
Networking Functionality
Pathfinding-Related Classes
Physics-Related Classes
Plugins-Related Classes
IG Plugin
CIGIConnector Plugin
Rendering-Related Classes
VR-Related Classes
Работа с контентом
Оптимизация контента
Материалы
Визуальный редактор материалов
Material Nodes Library
Miscellaneous
Input
Math
Matrix
Textures
Art Samples
Учебные материалы

Управление пакетами

Пакет (Package) представляет собой набор файлов и данных для проектов UNIGINE, которые хранятся в одном файле *.upackage. Пакет сжимает данные, сохраняя при этом исходную структуру каталогов. Пакеты можно использовать для удобной передачи файлов между вашими проектами или обмена данными с другими пользователями, будь то контент (отдельная модель или сцена с набором объектов, управляемых логикой, реализованной с помощью компонентов C#) или файлы (плагины, библиотеки, исполняемые файлы и т.д.).

Создание пакета#

UnigineEditor позволяет экспортировать в файл пакета как ассеты из Asset Browser, так и внешние файлы (т.е. файлы, хранящиеся вне каталога data_path).

В целом процесс аналогичен для обоих случаев, однако есть некоторые различия.

Экспорт ассетов из Браузера ассетов#

Чтобы экспортировать ассеты из Asset Browser в файл пакета:

  1. В строке меню выберите Packages -> Export Package, а затем нажмите кнопку Add Assets From Asset Browser в открывшемся окне Export Package.

  2. В окне Select Assets выберите ассеты, которые вы хотите добавить в пакет, и нажмите OK. Вы даже можете выбрать папку, содержащую весь проект целиком, а затем отменить выбор данных, которые вам не нужны, на следующем шаге.

    Обратите внимание, что вы можете сделать то же самое в Asset Browser: щелкните правой кнопкой мыши необходимый ассет(ы) или папку(папки) и выберите опцию Export As Package в контекстном меню.

  3. Теперь вы можете выбрать ассеты для экспорта в окне Export Package, установив флажок для каждого ассета.

    Примечание
    Имейте в виду, что любой отдельный файл, который вы хотите добавить, должен быть размером менее 2 ГБ. Размер пакета не ограничен.
  4. Вы можете автоматически добавить все зависимые ассеты в пакет (текстуры, используемые материалом, материалы, назначенные объекту, и т.д.) с помощью флажка Include Dependencies (зависимые ассеты отмечены зеленым цветом в списке).

  5. После выбора ассетов нажмите Export Package, чтобы упаковать их в новый файл *.upackage.

    Примечание
    Для активации кнопки Export Package необходимо выбрать по крайней мере один ассет.
  6. В открывшемся диалоговом окне укажите имя и путь к вашему пакету и нажмите Save.

Как только ваш пакет ассетов будет успешно создан, местоположение вашего файла *.upackage будет показано в вашем файловом менеджере.

Экспорт внешних файлов#

Чтобы скопировать внешние файлы (т.е. файлы проекта, хранящиеся вне каталога data_path) в файл пакета:

  1. Откройте окно Export Package: в строке меню выберите Packages -> Export Package. Если вы уже добавили ассеты из Asset Browser, вы можете пропустить этот шаг, так как окно открыто.
  2. Нажмите кнопку Add External Files, выберите файлы или папки в открывшемся диалоговом окне и нажмите Open. Обратите внимание, что внешние папки окрашены в красный цвет, в то время как папки из Asset Browser — в синий.

    Примечание
    Вы не можете добавлять файлы, хранящиеся вне папки проекта.
  3. Выберите файлы и/или папки для экспорта, нажмите Export Package, укажите имя и путь к новому файлу *.upackage и нажмите Save.

Импорт пакета#

Чтобы импортировать содержимое существующего пакета в ваш проект, вам необходимо сделать следующее:

  1. Перетащите его из проводника прямо в Asset Browser или выберите Packages -> Import Package в строке меню и выберите файл *.upackage. Вы также можете щелкнуть правой кнопкой мыши на Asset Browser, выбрать Import New Asset в контекстном меню и выбрать пакет.

    Если вы уже добавили файл *.upackage в свой целевой проект, дважды щелкните по нему.

    Примечание
    Не используйте файловый менеджер вашей операционной системы для копирования пакета в папку вашего проекта, так как в этом случае пакет будет отображаться в Asset Browser, но его содержимое не будет извлечено.

    Откроется следующее окно:

  2. Проверьте ассеты, которые будут импортированы. Ассеты в пакете могут быть окрашены в белый, красный и желтый цвета:

    • Ассеты белого цвета могут быть импортированы без каких-либо изменений.
    • Ассеты желтого цвета импортируются с постфиксом для устранения коллизии имен.
    • Ассеты красного цвета не могут быть импортированы по одной из следующих причин:

      • Такой же ассет уже есть в проекте.
      • В проекте найден ассет с таким же исходным идентификатором среды выполнения GUID.
      • Ассет с таким же идентификатором среды выполнения найден в проекте.
      • Указанная целевая точка монтирования (mount point) доступна только для чтения.
    Примечание
    Чтобы импортировать все зависимые ассеты для тех, которые выбраны, установите флажок Force Import Dependencies. Такие ассеты будут окрашены в зеленый цвет. Например, если вы снимите флажок с текстуры, используемой выбранным материалом, текстура все равно будет импортирована.
  3. После выбора всех ассетов, необходимых для импорта, нажмите кнопку Import Package.
  4. Дождитесь завершения процесса извлечения. Время извлечения зависит от размера ассетов, выбранных для импорта.

Кроме ассетов, вы также можете импортировать файлы, хранящиеся в пакете. Если такой файл уже существует в проекте, он будет окрашен в красный цвет без возможности импорта.

После успешного импорта пакета в Asset Browser будет доступна новая папка с соответствующим содержимым и отобразится следующее сообщение:

Управление пакетом#

Пакеты, предоставляемые в магазине дополнений (Add-On Store), могут время от времени обновляться создателем пакета. В этом случае вам нужно будет удалить ранее добавленные файлы и добавить новую версию пакета. Окно Add-On Store Package History показывает все добавленные пакеты, загруженные из магазина дополнений, и помогает удалить файлы пакетов одним щелчком мыши.

Чтобы открыть окно Add-On Store Package History, выберите Packages -> Add-On Store Package History в меню.

Opening the Add-On Store Package History window

Откроется следующее окно:

Add-On Store Package History window

В этом окне представлены следующие сведения и опции:

Imported Packages Список пакетов из магазина дополнений, которые были импортированы в этот проект.
File Hierarchy

Иерархия файлов, доступных в выбранном пакете. Если некоторые файлы пакета не были импортированы, они по-прежнему будут отображаться в списке File Hierarchy, но серым цветом, поскольку они недоступны.

На этой вкладке доступны следующие параметры:

  1. Unlink Files From Package — удаляет все ссылки из ассетов на пакет. Ассеты остаются в проекте, однако ими больше нельзя управлять через окно Add-On Store Package History. Этот процесс необратим. Чтобы восстановить иерархию файлов пакета, импортируйте пакет еще раз.
  2. Delete Package With Files — удаляет из проекта все ассеты, перечисленные в File Hierarchy. Этот процесс необратим. Чтобы восстановить файлы, импортируйте пакет еще раз.
  3. Show In Editor Plugin Manager — кнопка, которая открывает плагин в Editor Plugin Manager. Он доступен в File Hierarchy, если импортированный пакет содержит плагин редактора.

Description

Отображает описание пакета, предоставленное создателем пакета в магазине дополнений, включая версию пакета.

Лучшая практика
При выполнении каких-либо операций через окно Add-On Store Package History проверьте окно консоли редактора.
Последнее обновление: 06.07.2023
Build: ()