Работа с проектами
Проект - это независимый объект, который содержит все данные о содержимом вашего приложения, организованные в наборе каталогов. Файл .project, содержащий метаданные, связан с проектом.
Один проект может состоять из нескольких миров . Таким образом, нет необходимости создавать отдельный проект для каждого мира.Release and Development BuildsСборки для выпуска и разработки#
Вы можете выбрать сборку UNIGINE Engine Development или Release:
- Сборка Development включает дополнительные функции, которые могут быть полезны при разработке проекта (Microprofile и т.д.)
- Сборка Release позволяет проверить конечную производительность приложения.
Creating New ProjectСоздание нового проекта#
Перед тем, как начать создавать новые проекты, у вас должен быть установлен SDK . Когда у вас будет необходимая версия SDK, вы можете создать новый проект следующим образом:
- Откройте вкладку Projects в браузере SDK.
- Щелкните Create New. Откроется окно создания нового проекта.
- Определите имя проекта, выберите путь для хранения файлов проекта, укажите SDK и UNIGINE Engine build , которые будут использоваться.
Проект будет создан в папке <project path>/<unigine_project>. - Укажите необходимое приложение и общие настройки .
- Укажите надстройки , которые нужно добавить (необязательно).
- Щелкните Create New Project. Проект появится в списке проектов.
Вы можете изменить настройки проекта в любое время, нажав Other Actions -> Configure Project.Application SettingsНастройки приложения#
Проект может быть создан со следующими настройками приложения:
| Template | Шаблон, который используется в качестве основы для проекта:
|
|---|---|
| API+IDE | Programming language to be used for project creation. The following APIs are available:
|
| Precision | Используемая точность координат:
|
Featuresобщие настройки#
Проект может быть создан со следующими общими настройками:
| GUI-based settings configurator | Создайте проект с помощью launcher . |
|---|
Щелкните Plugins, чтобы указать следующее:
| Oculus support (AppOculus plugin) | Создайте проект с поддержкой виртуального дисплея Oculus Rift . |
|---|---|
| HTC Vive support (AppVive plugin) | Создайте проект с поддержкой HTC Vive output . |
| Dual output stereo 3D (AppSeparate plugin) | Выведите 2 отдельных изображения для каждого глаза.
Примечание
AppSeparate поддерживает только DirectX 11 . |
| 3-monitor output (AppSurround plugin) | Визуализируйте приложение на 3 мониторах одновременно . |
|---|---|
| Monitor wall (AppWall plugin) | Выполните рендеринг приложения на настраиваемое количество мониторов . |
| Multi-projector setups (AppProjection plugin) | Создайте проект с помощью плагина AppProjection. Копируются все необходимые файлы и генерируется лаунчер с соответствующими настройками. |
|---|---|
| EasyBlend support (AppEasyBlend plugin) | Создайте проект с помощью плагина AppEasyBlend. |
| Syncker plugin | Создайте проект с плагином Syncker для синхронизации многоканального рендеринга. |
|---|---|
| SSLSocket plugin | Создайте проект с помощью подключаемого модуля SSLSocket . |
| Steam plugin | Создайте проект с плагином для интеграции со Steam. |
| VRPN Client plugin | Создайте проект с помощью плагина VRPN Client. |
| ARTTracker plugin | Создайте проект с помощью плагина ARTTracker . |
| Kinect2 Plugin | Создайте проект с помощью плагина Kinect2 . |
|---|---|
| GPU Monitor plugin | Включите мониторинг частоты и температуры графического процессора для вашего проекта. |
| Leap Motion plugin | Отслеживание рук и пальцев с помощью Leap Motion |
| Interface plugin | Создайте проект с помощью плагина Interface. |
Add-OnsДополнения#
Проект может быть создан, включая любые надстройки, доступные во вкладке Add-Ons. Все необходимые дополнения могут быть добавлены как при создании проекта, так и после него.
Specifying Add-Ons on Project's CreationУказание надстроек при создании проекта#
Чтобы создать проект с надстройкой:
- Загрузите необходимое дополнение во вкладке Add-Ons, нажав Install.
ПримечаниеВпоследствии в проект можно было добавить любое количество надстроек. - В проекте creation укажите надстройки, которые нужно включить, нажав кнопку Add-ons (0).
- Отбросьте необходимые дополнения из поля Available в In Use. Вы можете добавить в проект любое количество надстроек. После сброса всех надстроек нажмите Ok.
ПримечаниеЕсли вы не скачали надстройку, нажмите Manage installed add-ons. Вы будете перенаправлены на страницу с доступными надстройками. - Щелкните Create New Project. Чтобы включить добавленные надстройки в проект, вы должны следовать инструкциям для каждого надстройки .
Specifying Add-Ons for Existing ProjectУказание надстроек для существующего проекта#
Чтобы расширить существующий проект надстройками:
- Загрузите необходимое дополнение во вкладке Add-Ons, нажав Install.
ПримечаниеВпоследствии в проект можно было добавить любое количество надстроек.
- Щелкните Other Actions -> Configure Project.
- Нажмите кнопку Add-ons (0) и перетащите нужные надстройки из поля Available в In Use.
ПримечаниеЕсли вы не скачали надстройку, нажмите Manage installed add-ons. Вы будете перенаправлены на страницу с доступными надстройками.
- Щелкните Ok, а затем щелкните Update Configuration.
Adding Existing ProjectДобавление существующего проекта#
Чтобы добавить существующий проект в браузер:
- Щелкните Add Existing на вкладке Projects.
- В открывшемся диалоговом окне файла укажите путь к папке проекта и нажмите Apply. Проект появится в списке проектов.
Если добавленный проект был создан в SDK предыдущей версии, он будет отмечен меткой Upgrade available.Upgrading Existing ProjectОбновление существующего проекта#
Проекты, требующие обновления, отмечены меткой Upgrade available:
Чтобы обновить свой проект до последней установленной версии UNIGINE SDK:
- Щелкните этот ярлык или Other Actions -> Configure Project. Откроется следующая форма:
- Выберите самую последнюю установленную версию SDK и нажмите Update Configuration.
- Укажите путь к папке резервного копирования, в которую будет скопирован исходный проект. Оставьте Migrate Content отмеченным и нажмите Upgrade Project.
Проект будет обновлен автоматически. Вы также можете обновить проект вручную, запустив сценарий обновления . В обоих случаях будет использоваться один и тот же сценарий.
Исходный код следует обновить вручную с помощью Руководства по миграции .Running a ProjectЗапуск проекта с настройками по умолчанию#
Есть несколько вариантов запуска проекта с настройками по умолчанию:
- Запустите проект без загруженного редактора, нажав Run.
- Запустите проект с загруженным редактором, нажав Open Editor.
Нажатие Open Editor запустит только редактор, вам придется загрузить мир вручную: через console , через File -> Open World в строке меню UnigineEditor или дважды щелкнув файл *.world в Asset Browser .Вы также можете использовать пусковые установки , созданные по умолчанию в папке проекта:
-
launch_debug - лаунчер отладочной версии проекта. -
launch_editor - лаунчер проекта с загруженным редактором.
-
launch_release - лаунчер релизной версии проекта.
-
launcher - файл запуска для программы запуска, который предоставляет графический интерфейс для настройки параметров приложения и запуска приложения. Этот модуль запуска можно настроить и использовать в выпускной версии вашего проекта. Чтобы создать проект с помощью средства запуска, установите флажок конфигуратор параметров на основе графического интерфейса в окне создания проекта.
Running Project with Custom SettingsЗапуск проекта с пользовательскими настройками#
Также есть несколько вариантов запуска проекта с пользовательскими настройками:
- Запустите проект без загруженного редактора, щелкнув многоточие под кнопкой Run:
В открывшейся форме Customize Run Options задайте необходимые значения и нажмите Run. - Запустите проект с загруженным редактором, щелкнув многоточие под кнопкой Open Editor:
В открывшейся форме Customize UnigineEditor Options задайте необходимые значения и нажмите Edit.
Нажатие Open Editor запустит только редактор, вам придется загрузить мир вручную через console или через File -> Open World в главном меню UnigineEditor .Настроить параметры запуска#
С помощью этой формы можно запустить проект без загруженного редактора с пользовательскими настройками.
В зависимости от значения параметра Application доступны разные наборы параметров:
- Default - будет запущено основное приложение по умолчанию (<project_name>_x*.exe):
Главное приложение по умолчанию следует использовать, если для реализации проекта используется только UnigineScript . В этом случае можно настроить следующие параметры:Debug Указывает, следует ли запускать отладочную или выпускную версию приложения.Microprofile Enabled Запустите приложение с включенным инструментом Microprofile .Arguments Параметры командной строки запуска .Remember Указывает, следует ли запоминать указанные пользовательские настройки для будущего запуска или нет. - Custom - будет запущено собственное основное приложение:
Этот вариант следует выбрать, если для реализации проекта используется C++ or C# API(помимо UnigineScript). В этом случае можно настроить следующие параметры:Binary Имя настраиваемого основного приложения. Здесь необходимо указать имя скомпилированного двоичного исполняемого файла, расположенного в папке bin проекта. Если исполняемый двоичный файл находится за пределами этой папки, необходимо указать путь к нему относительно папки bin.Arguments Параметры командной строки запуска .Remember Указывает, следует ли запоминать указанные пользовательские настройки для будущего запуска или нет.
Customizing UNIGINE Editor OptionsНастроить параметры UnigineEditor#
| Additional arguments | Параметры командной строки запуска . |
|---|---|
| Debug | Версия редактора (отладочная или выпускная), которая будет использоваться для редактирования проекта. |
| Remember | Указывает, следует ли запоминать указанные пользовательские настройки для будущего запуска или нет. |
Editing ProjectРедактирование проекта#
Чтобы открыть проект на редактирование:
- В Windows щелкните Open Code IDE:
Проект будет открыт для редактирования в связанном инструменте. Чтобы изменить инструмент, щелкните многоточие под Open Code IDE. По умолчанию откроется следующая форма:
В раскрывающемся списке выберите Custom и укажите путь к настраиваемому инструменту (например, IDE или редактору) с необходимыми аргументами:
- В Linux щелкните Open folder и затем отредактируйте код в соответствующем инструменте:
Смотрите также#
- Статьи в разделе Обзор программирования , чтобы узнать, как редактировать открытый проект.
- видеоурок , демонстрирующий, как изменить IDE
Other ActionsДругие действия#
При нажатии на кнопку Other Actions открывается следующая форма:
| Configure Project | Изменить настройки проекта. |
|---|---|
| Open Folder | Откройте папку проекта. |
| Delete | Удалите проект. |
Updating Project ConfigurationОбновление конфигурации проекта#
При нажатии Other Actions -> Configure Project открывается следующая форма:
С помощью этой формы вы можете изменить настройки существующего проекта: сборка UNIGINE Engine , используемая для проекта, версия релизного приложения, точность координат и общие настройки . Эту опцию также следует использовать, когда вам нужно обновить существующий проект до последней версии SDK.
Кроме того, вы можете восстановить файлы проекта, которые были повреждены, пропущены или по ошибке изменены. Для этого следует оставить настройки в форме без изменений и нажать кнопку Update Configuration.
В этом случае будут восстановлены следующие файлы проекта (они будут скопированы из SDK):
- Бинарные файлы
- core.ung, editor.ung and scripts.ung
- Файлы запуска (Launchers)
Если некоторые из файлов, перечисленных выше, изменены, к именам таких файлов добавляется постфикс .modified. При этом также будут скопированы файлы из SDK.