Быстрый старт: Инструменты Visual Studio для Unreal Engine

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

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

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

  • Visual Studio версии 17.10 или более поздней.
  • Unreal Engine версии 5 или более поздней, так как в примере, используемом в этой статье, требуется Unreal Engine 5 или более поздней версии.
  • Инструменты Visual Studio для Unreal Engine. Инструкции по установке см. в установке средств Visual Studio для Unreal Engine.

Лира является примером игрового проекта для изучения Unreal Engine. Инструкции по скачиванию см. в разделе " Скачивание игры Lyra Starter Game" в Lyra Sample Game. Если вы приобрели проект Lyra с помощью установки исходного кода Unreal Engine, эта версия не содержит ресурсов, необходимых для сборки и запуска игры. Используйте инструкции по скачиванию, чтобы получить все необходимые сведения.

Если у вас есть Visual Studio 2022 версии 17.11 или более ранней версии, необходимо создать файл решения Visual Studio в Unreal Engine, прежде чем открыть проект в Visual Studio. Это сценарий, в котором рассматривается эта статья.

Замечание

Visual Studio 2022 версии 17.12 и более поздних версий обеспечивает прямую поддержку проектов Unreal Engine. Проект Lyra можно открыть непосредственно в Visual Studio без создания файла решения в Unreal Engine. Это рекомендуемый способ работы с проектами Unreal Engine в Visual Studio. Чтобы следовать этому пути, следуйте инструкциям в проектах Open Unreal Engine в Visual Studio , чтобы создать и запустить пример Lyra. Затем вернитесь к этой статье, чтобы узнать больше о окне вывода сборки Visual Studio, панели инструментов Unreal Engine и раскрывающихся списках аргументов командной строки .

Настройка Lyra для использования средств Visual Studio для Unreal Engine

Если у вас есть Visual Studio 2022 17.11 или более ранние версии, необходимо включить подключаемый модуль Средств Visual Studio для Unreal Engine в проекте Lyra, чтобы использовать функции средств Visual Studio для Unreal Engine. После скачивания примера игры Lyra обновите LyraStarterGame.uproject с использованием плагина Visual Studio Tools. Это можно сделать из редактора LyraStarterGame.uproject Unreal или вручную изменить файл.

Метод 1. Включение подключаемого модуля средств интеграции Visual Studio в редакторе Unreal

  1. В редакторе Unreal загрузите проект Lyra.
  2. В главном меню Visual Studio выберите пункт "Изменить>подключаемые модули".
  3. Найдите подключаемый модуль средств интеграции Visual Studio и установите флажок рядом с ним.

Метод 2. Изменение файла проекта

  1. Откройте файл LyraStarterGame.uproject в текстовом редакторе. Он находится в каталоге, где установлен пример игры.

  2. Добавьте следующее в конец раздела Plugins:

    ,{
        "Name": "VisualStudioTools",
        "Enabled": true
    }
    

Создание проекта Lyra в Visual Studio

Перед сборкой проекта Lyra в Visual Studio:

  1. Откройте проект Lyra в Unreal Engine.
  2. В главном меню редактора Unreal Engine выберите Tools>Generate Visual Studio Project. При этом создается файл решения для Visual Studio.
  3. В главном меню редактора Unreal Engine выберите Инструменты>Открыть Visual Studio для открытия игры в Visual Studio. Если на компьютере есть несколько версий Visual Studio, убедитесь, что выбрана правильная версия: в главном меню Visual Studio выберите Справка>О программе Microsoft Visual Studio. Необходимо использовать Visual Studio 2022 версии 17.7 или более поздней. Если правильная версия не открыта, откройте LyraStarterGame.sln вручную в правильной версии Visual Studio.

в Visual Studio

  1. Измените выпадающий список конфигураций решений на Редактор разработки. Это включает средства Blueprints Visual Studio Tools для Unreal Engine: снимок экрана Visual Studio с раскрытым списком
  2. Задайте для запуска проекта LyraStarterGame. В проводнике решений щелкните правой кнопкой мыши на решении и выберите Свойства.
  3. В диалоговом окне страниц свойств решения в разделе Общие свойствавыберите Настройка проектов запуска.
  4. Убедитесь, что выбран проект с единичным запуском, и выберите LyraStarterGame в раскрывающемся списке.

    Снимок экрана: диалоговое окно страниц свойств решения.

    В разделе "Общие свойства" выбран параметр "Настройка проектов запуска". Выбрана радиокнопка единственного запускаемого проекта. В раскрывающемся списке стартап-проект — LyraStarterGame.

  5. Нажмите кнопку ОК, чтобы закрыть диалоговое окно.
  6. В главном меню Visual Studio выберите Сборка>сборки решения, чтобы создать игру.

Окно вывода сборки Visual Studio

В окне выходных данных сборки в Visual Studio показаны ход выполнения сборки и все ошибки или предупреждения, возникающие. Окно вывода сборки можно открыть в главном меню Visual Studio с помощью представления>выходных данных.

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

На следующем снимке экрана показано окно вывода для сборки примера LyraStarterGame. Пользователь дважды щелкнул по предупреждению из LyraCharacter.generated.h. Так как указан абсолютный путь к файлу, файл открывается в редакторе.

Снимок экрана окна вывода Visual Studio. Файл LyraCharacter.generated.h выделен, так как указан абсолютный путь, и пользователь дважды щелкнул его, чтобы открыть файл LyrCharacter.generated.h.

Панель инструментов Unreal Engine

Visual Studio предоставляет панель инструментов, которая улучшает интеграцию разработки Unreal Engine в Visual Studio. Панель инструментов предоставляет быстрый доступ к общим задачам UE.

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

Снимок экрана панели инструментов Unreal Engine в Visual Studio.

Кнопки панели инструментов слева направо:

  • Значок воспроизведения — это кнопка быстрого подключения, которая присоединяется к процессам, перечисленным в раскрывающемся списке справа. В раскрывающемся списке перечислены связанные процессы Unreal Engine, что упрощает подключение к редактору Unreal Engine. Это также можно использовать для присоединения к любым процессам.
  • Кнопки для запуска и остановки сервера интеграции Unreal Engine. Сервер интеграции повышает производительность интеграции Unreal Engine с Visual Studio. Он выполняется в качестве фонового процесса и автоматически обновляет сведения о тестировании при работе над проектом. Вы можете отключить ее, чтобы освободить ресурсы компьютера и запустить ее при желании улучшения интеграции. Сервер запускается автоматически при открытии проекта UE в Visual Studio.
  • Кнопка для повторного сканирования ресурсов схемы Unreal Engine. Это обновляет решение Visual Studio с последними Blueprint-ресурсами из проекта Unreal Engine.
  • Кнопка, которая открывает окно журнала Unreal Engine.
  • Кнопка, чтобы открыть окно Конфигурации интеграции Unreal Engine, где можно обновить и просмотреть общее состояние конфигурации и состояние средства интеграции Visual Studio, проверить поддержку Blueprint, узнать статус проверки соглашения об именовании Unreal Engine и т. д.

Раскрывающийся список аргументов командной строки

Вы можете часто запускать игру с различными сочетаниями аргументов командной строки во время редактирования и отладки части внутреннего цикла. Теперь это проще с раскрывающимся списком аргументов командной строки:

Снимок экрана выпадающего списка аргументов командной строки.

Раскрывающийся список аргументов командной строки отображается после раскрывающегося списка "Платформы решений" на панели инструментов "Стандартный". Существует запись для C:\UE\LyraStarterGame\LyraStarterGame.uproject -fullscreen и C:\UE\LyraStarterGame\LyraStarterGame.uproject -JsonDebugOutput.

Чтобы добавить аргументы командной строки, введите их в выпадающем окне и нажмите ВВОД. Аргументы сохраняются в порядке их ввода и отображаются в раскрывающемся списке для дальнейшего использования.

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

Первый аргумент при отладке проекта Unreal Engine, который выполняется в редакторе Unreal Engine, должен быть путь к проекту. Например, C:\UE\LyraStarterGame\LyraStarterGame.uproject.

Дополнительные сведения об использовании раскрывающегося списка аргументов командной строки см. в разделе "Передача аргументов командной строки".

Дальнейшие действия

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