Добавление классов, модулей и подключаемых модулей Unreal Engine в Visual Studio

Из этой статьи вы узнаете, как использовать инструменты Visual Studio для Unreal Engine:

• добавление модулей Unreal Engine в Visual Studio
• Добавление классов Unreal Engine в Visual Studio
• Добавить подключаемые модули Unreal Engine в Visual Studio

Необходимые условия

Необходимо установить следующее:

• Visual Studio версии 17.11 или более поздней.
• Unreal Engine версии 5 или более поздней.
• Инструменты Visual Studio для Unreal Engine. См. Инструкции по установке средств Visual Studio для Unreal Engine.
• Выполните краткое руководство по начальной настройке: Инструменты Visual Studio для Unreal Engine, чтобы скачать и собрать игру Lyra и настроить ее для использования инструментов Visual Studio для Unreal Engine.

Добавление модулей Unreal Engine в Visual Studio

Теперь вы можете добавить модули Unreal Engine в проект Unreal Engine из Visual Studio. Вам больше не нужно переключаться между редактором Unreal Engine и Visual Studio, чтобы добавить модуль или синхронизировать решение Visual Studio с файлом проекта Unreal Engine после этого.

Модули — это способ упорядочить код в Unreal Engine. Они помогают группировать связанные классы и ресурсы вместе и упорядочивать код в автономные единицы, которые можно загрузить и выгрузить во время выполнения. Создание модулей может быть утомительным и подверженным ошибкам, если это делается вручную, так как для него требуется редактировать файлы конфигурации и добавлять стандартный код. Visual Studio упрощает создание модулей, предоставляя диалоговое окно, которое проводит вас через процесс, выполняет настройку и добавляет шаблонный код для вас.

Чтобы добавить модуль Unreal Engine в Visual Studio, выполните следующие действия после завершения шага "Быстрый старт: Инструменты Visual Studio для Unreal Engine", чтобы скачать и собрать игру Lyra. Предполагается, что у вас открыто решение LyraStarterGame.sln в программе Visual Studio.

1. В обозревателе решенийвыберите проект, например LyraStarterGame, где нужно перейти к новому модулю.
2. Щелкните правой кнопкой мыши проект (убедитесь, что выбран проект, а не папка) и выберите >Добавить элемент Unreal Engine..., чтобы открыть диалоговое окно Добавить новый элемент для элементов Unreal Engine:
3. Выберите модуль Unreal Engine, укажите имя модуля в поле Имя, а затем выберите Добавить для открытия диалогового окна Добавить модуль Unreal Engine:

   

   В диалоговом окне "Добавить модуль Unreal Engine" есть поле для имени модуля, раскрывающийся список для типа модуля (выбрана среда выполнения) и этап загрузки модуля (выбрано значение по умолчанию). Перечислены пути модуля, заголовок, источник и пути к файлам сборки. Включен флажок для обновления сведений IntelliSense с помощью инструментов Unreal Editor.

4. Используйте раскрывающиеся списки, чтобы выбрать тип модуля и, а также этап загрузки модуля и.
5. Нажмите кнопку ОК, чтобы добавить модуль в проект и обновить файл решения Visual Studio.

Модули можно создавать только в папке источника или в качестве части подключаемого модуля в папке подключаемых модулей.
Путь сборки показывает, где файл Build.cs создается. Файл Build.cs содержит сведения о конфигурации модуля.

Создание одного модуля Unreal Engine

После добавления модуля создайте его, чтобы сделать его доступным в редакторе Unreal Engine. Вместо сборки всего проекта можно создать только модуль.

В обозревателе решенийщелкните правой кнопкой мыши папку модуля и выберите Сборка. Это компилирует подключаемый модуль и делает его доступным в редакторе Unreal Engine.

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

Добавление классов Unreal Engine в Visual Studio

Теперь можно добавить классы Unreal Engine в проект Unreal Engine из Visual Studio. Вам больше не нужно переключаться между Редактором Unreal и Visual Studio, чтобы добавить класс или синхронизировать решение Visual Studio с файлом проекта Unreal Engine после этого.

Чтобы добавить класс Unreal Engine в Visual Studio, выполните следующие действия после завершения «Quickstart: Visual Studio Tools for Unreal Engine» для скачивания и сборки игры Lyra. В этих шагах предполагается, что в Visual Studio открыто решение LyraStarterGame.sln.

1. В обозревателе решенийвыберите папку, в которой нужно перейти к новому классу. Например, в проекте LyraStarterGame можно добавить новый класс в папку LyraStarterGame>Source.
2. Щелкните правой кнопкой мыши папку и выберите Добавить элемент Unreal Engine>..., чтобы открыть диалоговое окно "Добавить новый элемент":

   

   Он предлагает варианты добавления общих классов Unreal Engine (выбран по умолчанию), пустого модуля Unreal Engine и плагинов Unreal Engine.

3. Выберите Общие классы Unreal Engine и выберите Добавить, чтобы открыть диалоговое окно Добавление класса Unreal Engine:

   

   Параметры выбора базы, например "Субъект", "Символ" и т. д., отображаются. Существует поле для имени класса и раскрывающегося списка для модуля, в который добавляется класс. Перечислены пути к файлу заголовка и исходному файлу. Установлен флажок для обновления сведений IntelliSense с помощью инструментов Unreal Editor.

4. Выберите имя класса . Visual Studio предупреждает вас, если имя конфликтует с существующим классом или файлом.
5. Выберите базовый класс. Выбор базового класса гарантирует, что для этого типа класса включены правильные заголовки и макросы.
6. Выберите модуль для добавления в ваш класс, используя раскрывающийся список . Имя модуля — это имя папки, содержащей модуль.
7. Установите флажок Обновить сведения IntelliSense с помощью инструментов Unreal Editor, чтобы выбрать, использует ли Visual Studio средства Unreal Editor для обновления сведений IntelliSense. Выберите это, чтобы средство Unreal Build повторно создало файл решения Visual Studio.
8. Нажмите кнопку ОК, чтобы создать заголовок и исходные файлы нового класса и добавить их в файл решения Visual Studio. Выберите Перезагрузить во всплывающем окне, чтобы перезагрузить проект.

Добавьте подключаемые модули Unreal Engine в Visual Studio

Теперь вы можете добавлять плагины Unreal Engine в ваш проект Unreal Engine прямо из Visual Studio. Вам больше не нужно переключаться между Редактором Unreal и Visual Studio, чтобы добавить подключаемый модуль или синхронизировать решение Visual Studio с файлом проекта Unreal Engine после этого.

Чтобы добавить подключаемый модуль Unreal Engine в Visual Studio, выполните следующие действия после завершения Краткого руководства: Инструменты Visual Studio для Unreal Engine, чтобы скачать и собрать игру Lyra. В этих шагах предполагается, что в Visual Studio открыто решение LyraStarterGame.sln.

1. В обозревателе решенийвыберите папку, в которую вы хотите поместить новый подключаемый модуль. В проекте LyraStarterGame, например, можно добавить новый плагин в папку LyraStarterGame>Source.
2. Щелкните правой кнопкой мыши папку и выберите Добавить элемент Unreal Engine>..., чтобы открыть диалоговое окно "Добавить новый элемент":

   

   У него есть варианты для добавления общих классов Unreal Engine, пустого модуля Unreal Engine и плагинов Unreal Engine (выбран последний).

3. Выберите подключаемые модули Unreal Engine, затем выберите Добавить, чтобы открыть диалоговое окно добавления подключаемого модуля Unreal Engine.

   

   Существует список типов подключаемых модулей (выбран расширенный), а также поля для ввода имени подключаемого модуля, пути, автора, описания и URL-адреса. В наличии флажок "Подключаемый модуль в бета-версии" (снят) и флажок "Обновить информацию IntelliSense с помощью инструментов редактора Unreal" (установлен).

4. Выберите тип вашего подключаемого модуля из списка типа плагина.
5. Укажите имя плагина , автора плагина , описание плагина и URL-адрес плагина .
6. Установите флажок Плагин в бета-версии при необходимости.
7. Установите флажок Обновить сведения IntelliSense с помощью инструментов Unreal Editor, чтобы выбрать, использует ли Visual Studio средства Unreal Editor для обновления сведений IntelliSense. Это приводит к повторному созданию файла решения Visual Studio с помощью средства Unreal Build.
8. Выберите Добавить, чтобы создать заголовок и исходные файлы нового подключаемого модуля и добавить их в решение Visual Studio. Это приводит к запросу на перезагрузку проекта. Выберите Перезагрузить, чтобы перезагрузить проект.

Создание одного подключаемого модуля для Unreal Engine

После добавления плагина скомпилируйте его, чтобы сделать доступным в редакторе Unreal Engine. Вместо сборки всего проекта можно создать только подключаемый модуль.

В обозревателе решенийщелкните правой кнопкой мыши папку плагина и выберите Сборка этого плагина Unreal Engine. Это создает подключаемый модуль и делает его доступным в редакторе Unreal Engine.

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

Связанное содержимое

средства Visual Studio для Unreal Engine
просмотр схем Unreal Engine в Visual Studio
просмотр логирования Unreal Engine в Visual Studio
Просмотр макросов Unreal Engine в Visual Studio