Как подключить визуал студио к юнити
Перейти к содержимому

Как подключить визуал студио к юнити

  • автор:

Как в Unity подключить Visual Studio

unity preferences

The associated script can not be loaded. Please fix any compile errors and assign a valid script.

associated script can not be loaded

то необходимо исправить ошибки в скрипте или в кодировке.

281

Интеграция Visual Studio C#

Более профессиональную среду разработки C#. Интеллектуальное автодополнение, автоматизированное изменение исходных файлов, умная подсветка синтаксиса и многое другое.

Какое различие между Express и Pro?

VisualStudio C# 2010 это продукт компании Microsoft. Он выпускается в двух версиях — Express и Professional. Редакция Express бесплатна и вы можете скачать её отсюда: http://www.microsoft.com/express/vcsharp/ Редакция Professional не бесплатная, вы можете более подробнее узнать здесь: http://www.microsoft.com/visualstudio/en-us/products/professional/default.mspx

Интеграция Unity с VisualStudio позволит вам создавать и поддерживать файлы VisualStudio проекта автоматически. Кроме того, VisualStudio будет открыт после двойного щелчка по скрипту или по сообщению об ошибке в сонсоли Unity.

У меня есть Visual Studio Express, как я могу её использовать?

  • В Unity выберите меню Assets->Sync MonoDevelop Project
  • Найдите новый файл .sln в дирректории Unity проекта (на одну папку выше папки Assets)
  • Откройте этот файл в Visual Studio Express.
  • Теперь вы можете редактировать ваши файлы скриптов, и переходить назад в Unity чтобы их использовать.

У меня Visual Studio Profesional, как мне использовать её?

  • В Unity, перейдите в Edit->Preferences, и убедитесь, что Visual Studio выбран как предпочтительный внешний редактор.
  • Дважды кликните по C# файлу в вашем проекте. Visual Studio автоматически откроет этот файл для вас.
  • Вы можете редактировать файл, сохранить и перейти обратно в Unity.

Важные пункты:

  • Не смотря на то, что Visual Studio поставляется со своим собственным компилятором C#, и вы можете использовать его для проверки ваших скриптов на ошибки, Unity по прежнему использует собственный компилятор C# для компиляции ваших скриптов. Однако использование компилятора Visual Studio все равно очень эффективно, потому что вам не нужно постоянно переключаться в Unity чтобы проверить свои скрипты на наличие ошибок.
  • Компилятор C# в Visual Studio обладает большим количеством возможностей чем C# компилятор в Unity. Это означает, что код (содержащий новейшие возможности C#) не вызовет ошибок в Visual Studio, но может вызвать ошибки в Unity.
  • Unity автоматически создает и поддерживает файлы .sln и .csproj для Visual Studio. Когда кто-либо добавляет/переименовывает/перемещает/удаляет файлы из под Unity, Unity восстанавливает .sln и .csproj файлы. Так же вы можете добавить файлы в ваш проект Visual Studio. Unity импортирует эти файлы и в следующий раз создаст файлы проекта снова, включив в них добавленные вами файлы.
  • Unity не обновит файлы проекта Visual Studio после обновления AssetServer или SVN. Вы можете вручную заставить Unity обновить файлы проекта Visual Studio через меню: Assets->Sync MonoDevelop Project

Использование инструментов Visual Studio для Unity

В этом разделе мы рассмотрим, как использовать возможности интеграции и повышения производительности набора средств Visual Studio для Unity, а также как использовать отладчик Visual Studio для разработки Unity.

Открытие скриптов Unity в Visual Studio

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

Кроме того, можно открыть Visual Studio без скрипта в редакторе исходного кода, выбрав меню «Ресурсы > открыть проект C#» в Unity.

Screenshot of the Open C# project in Visual Studio.

Screenshot of the Open C# project in Visual Studio for Mac.

Доступ к документации Unity

Доступ к документации по созданию скриптов Unity можно быстро получать из Visual Studio. Если набор средств Visual Studio для Unity не находит документацию по API в локальном режиме, он попытается найти ее через Интернет.

  • В Visual Studio выделите API Unity, с которым хотите ознакомиться (или наведите на него курсор), а затем нажмите клавиши CTRL+ALT+M, CTRL+H.
  • Вы также можете использовать > меню справки по API Unity вместо привязки ключей.

Screenshot of the Unity API Reference menu in Visual Studio.

  • В Visual Studio для Mac выделите или поместите курсор на API Unity, о котором вы хотите узнать, а затем нажмите клавиши Cmd+.
  • Вы также можете использовать > меню справки по API Unity вместо привязки ключей.

Screenshot of the Unity API Reference menu in Visual Studio for Mac.

IntelliSense для сообщений API Unity

Средство автозавершения кода IntelliSense позволяет легко реализовать сообщения API Unity в скриптах MonoBehaviour и помогает в изучении API Unity. Чтобы использовать IntelliSense для сообщений Unity, сделайте следующее:

  1. Поместите курсор на новую строку внутри тела класса, производного от MonoBehaviour .
  2. Начните вводить имя сообщения Unity, например OnTriggerEnter .
  3. После ввода букв «ontri» отображается список предложений IntelliSense.

Screenshot of using IntelliSense in Visual Studio.

  1. Выбранный элемент в списке можно изменить тремя способами:
    • с помощью клавиш со стрелками ВВЕРХ и ВНИЗ;
    • щелкая нужный элемент;
    • продолжив ввод имени нужного элемента.
  2. IntelliSense может вставить выбранное сообщение Unity, включая все необходимые параметры:
    • при нажатии клавиши TAB;
    • при нажатии клавиши ВВОД;
    • при двойном щелчке выбранного элемента.

Screenshot of the Insert Unity message from IntelliSense in Visual Studio.

Мастер создания скриптов Unity MonoBehavior

Мастер MonoBehavior можно использовать для просмотра списка всех методов API Unity и быстрого выполнения пустого определения. Эта функция, особенно со включенным параметром Создать комментарии для метода, полезна при изучении того, что доступно в Unity API.

Создание определений пустых методов MonoBehavior с помощью мастера MonoBehavior.

  1. В Visual Studio поместите курсор туда, где необходимо вставить методы, а затем нажмите клавиши CTRL+SHIFT+M для запуска мастера MonoBehavior. В Visual Studio для Mac нажмите клавиши CMD+SHIFT+M.
  2. В окне Создание методов скрипта установите флажок рядом с именем каждого метода, который нужно добавить.
  3. Чтобы выбрать необходимую версию, используйте раскрывающийся список Версия платформы.
  4. Методы по умолчанию вставляются в позицию курсора. В качестве альтернативы можно вставить их после любого метода, который уже реализован в классе. Для этого измените значение раскрывающегося списка точка вставки на нужное расположение.
  5. Если вы хотите, чтобы мастер создавал комментарии для выбранных методов, установите флажок Создать комментарии к методу. Эти комментарии позволяют лучше понять, когда вызывается метод и каковы его общие функции.
  6. Нажмите кнопку ОК, чтобы выйти из мастера и вставить методы в код.

Screenshot of the monobehavior wizard dialog in Visual Studio.

Screenshot of the monobehavior wizard dialog in Visual Studio for Mac.

Обозреватель проектов Unity

Обозреватель проектов Unity показывает все файлы и каталоги ваших проектов Unity в том же виде, что и редактор Unity. Это отличается от навигации по сценариям Unity с помощью обычного обозревателя решений Visual Studio, который организует их в проекты и решения, созданные Visual Studio.

  • В главном меню Visual Studio выберите «Вид > проекта Unity» Обозреватель. Сочетание клавиш: ALT+SHIFT+E

Screenshot of the Unity Project Explorer window.

  • В Visual Studio для Mac панель решения автоматически ведет себя так, как при открытии проекта Unity.

Отладка Unity

Набор средств Visual Studio для Unity позволяет отлаживать скрипты редакторов и игр для проекта Unity с помощью мощного отладчика Visual Studio.

Отладка в редакторе Unity

Запуск отладки
  1. Visual Studio можно подключить к Unity, нажав кнопку Воспроизвести, отмеченную меткой Подключить к Unity, или использовав клавишу F5.

Screenshot of the Attach to Unity button in Visual Studio.

  1. Подключите Visual Studio к Unity, нажав кнопку Воспроизвести, клавиши COMMAND+ВВОД или клавишу F5.

Screenshot of the Play button in Visual Studio for Mac.

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

Screenshot of the Play button in Unity on Windows.

Screenshot of the Play button in Unity on macOS.

  1. Когда игра запущена в редакторе Unity при подключении к Visual Studio, все проходимые точки останова будут приостанавливать выполнение игры и выводить соответствующую строку кода в Visual Studio.
Остановить отладку

В Visual Studio нажмите кнопку Стоп или используйте сочетание клавиш SHIFT + F5.

Screenshot of the Stop button in Visual Studio.

Нажмите кнопку Остановить в Visual Studio для Mac или клавиши SHIFT+COMMAND+ВВОД.

Screenshot of the Stop button in Visual Studio for Mac.

Дополнительные сведения об отладке в Visual Studio см. в документации по отладчику Visual Studio.

Подключение к Unity и воспроизведение

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

Screenshot of the Attach and play button in Visual Studio.

  1. Щелкните небольшую стрелку вниз рядом с кнопкой Подключить к Unity.
  2. В раскрывшемся меню выберите Подключить к Unity и воспроизвести.

Затем на кнопке «Воспроизведение» появляется метка Подключение к Unity и воспроизведение. Нажатие этой кнопки или использование клавиши F5 приведет к автоматическому переключению на редактор Unity и запуску игры в редакторе, в дополнение к подключению отладчика Visual Studio.

Начать отладку и воспроизведение в редакторе Unity можно за один шаг, непосредственно из Visual Studio для Mac, выбрав конфигурацию Подключение к Unity и воспроизведение.

Screenshot of the Attach to Unity and Play button in Visual Studio for Mac.

Если вы начали отладку с помощью конфигурации Присоединения к Unity и Play , кнопка «Остановить » также остановит редактор Unity.

Отладка сборок проигрывателя Unity

Вы можете отлаживать сборки разработчиков Unity с помощью Visual Studio.

Включение отладки скриптов в проигрывателе Unity

Screenshot of the Unity build settings for debugging.

  1. В Unity откройте Параметры сборки, выбрав Параметры сборки файлов>.
  2. В окне параметров сборки установите флажки Сборка разработки и Отладка скриптов.
Выбор экземпляр Unity для присоединения отладчика
  • В Visual Studio в главном меню выберите отладочный отладчик >Unity. Screenshot of the Attach Unity Debugging Window in Visual Studio.В диалоговом окне Выбор экземпляра Unity отображаются сведения о каждом экземпляре Unity, к которому можно подключиться. Screenshot of the Choose an instance of Unity to connect to window in Visual Studio.Проект Имя проекта Unity, который выполняется в этом экземпляре Unity. Компьютер Имя компьютера или устройства, на котором выполняется этот экземпляр Unity. Редактор типов , если этот экземпляр Unity работает в редакторе Unity; Проигрыватель, если этот экземпляр Unity является автономным игроком. Порт Номер порта UDP-сокета, через который данный экземпляр Unity обменивается данными.

Так как Инструменты Visual Studio для Unity и экземпляр Unity взаимодействуют по сетевому сокету UDP, брандмауэру может потребоваться правило, чтобы разрешить его. При необходимости может появиться запрос, необходимо авторизовать подключение, чтобы VSTU и Unity могли взаимодействовать.

Выбор экземпляра Unity, который не отображается в списке

Если у вас есть известный проигрыватель Unity, который не отображается в списке, можно использовать кнопку Входной IP-адрес в окне выбора экземпляра Unity. Введите IP-адрес и порт работающего проигрывателя Unity для подключения отладчика.

Чтобы упростить отладку этого проигрывателя без ввода IP-адреса и порта каждый раз, включите параметр «Использовать сохраненные целевые объекты отладки» в > меню «Средства параметров>» для Unity > «Общие«.

Screenshot of the Use saved debug targets setting.

Visual Studio будет отображать сохраненные целевые объекты отладки в качестве параметра в кнопке «Присоединить к Unity».

Screenshot of the Saved debug target setting.

  • В Visual Studio для Mac в верхнем меню выберите «Запустить > подключение к процессу«.
  • В диалоговом окне «Присоединение к процессу » выберите параметр отладчика Unity в раскрывающемся меню отладчика внизу.
  • Выберите экземпляр Unity из списка и нажмите кнопку «Присоединить «.

Отладка библиотеки DLL в проекте Unity

Многие разработчики Unity создают компоненты кода в виде внешних библиотек DLL, чтобы разрабатываемые ими функции можно было легко совместно использовать с другими проектами. Набор средств Visual Studio для Unity упрощает отладку кода в этих библиотеках DLL без создания проблем для другого кода в проекте Unity.

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

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

Отладка проекта с управляемой библиотекой DLL, используемой в проекте Unity

Screenshot of the Add ></p>
<ol>
<li>Добавьте существующий проект библиотеки DLL в решение Visual Studio, которое создается набором средств Visual Studio для Unity. В ряде случаев вы можете создать новый проект с управляемой библиотекой DLL, который будет содержать компоненты кода проекта Unity. В этом сценарии в решение Visual Studio можно добавить новый проект с управляемой библиотекой DLL. Existing Item menu.» /> В любом случае набор средств Visual Studio для Unity сохраняет ссылку на проект, даже если он должен повторно создать файлы проекта и решения, поэтому эти действия нужно будет выполнить только один раз.</li>
<li>Создайте ссылку на нужный профиль платформы Unity в проекте DLL. В Visual Studio в свойствах проекта DLL для свойства <strong>Целевая платформа</strong> укажите версию платформы Unity, которую вы используете. Это библиотека базового класса Unity, соответствующая уровню совместимости API, на который ориентирован ваш проект, например библиотека базовых классов Unity full, micro или web. Благодаря этому ваша библиотека DLL не будет вызывать методы платформы, существующие на других платформах или уровнях совместимости, но которые могут отсутствовать в версии платформы Unity, которую вы используете.</li>
</ol>
<p>Указанные ниже действия требуется выполнять, только если вы используете устаревшую среду выполнения Unity. В новой среде выполнения Unity такие выделенные профили версии 3.5 использовать не нужно. Выберите профиль .NET 4.x, совместимый с вашей версией Unity.</p><div class='code-block code-block-12' style='margin: 8px 0; clear: both;'>
<!-- 12vxworks -->
<script src=

Screenshot of the selecting target framework for a project in Visual Studio.

  1. Скопируйте библиотеку DLL в папку Asset (ресурсы) своего проекта Unity. В Unity ресурсы представляют собой файлы, которые упаковываются и развертываются вместе с вашим приложением Unity, чтобы их можно было загружать во время выполнения. Так как библиотеки DLL связываются во время выполнения, их необходимо развертывать как ресурсы. Для развертывания в виде ресурса редактору Unity требуется, чтобы библиотеки DLL были помещены в папку Assets вашего проекта Unity. Предусмотрены два способа выполнения этой задачи.
    • Измените параметры сборки проекта DLL, чтобы добавить выполняемую после сборки задачу, которая скопирует выходные файлы DLL и PDB из выходной папки в папку Активы проекта Unity.
    • Измените параметры сборки проекта DLL, чтобы сделать выходной папкой папку Assets проекта Unity. Теперь файлы DLL и PDB будут сразу помещаться в папку Assets.

PDB-файлы необходимы для отладки, так как они содержат символы отладки библиотеки DLL и сопоставляют код DLL с формой его исходного кода. Если будет применяться устаревшая среда выполнения, Инструменты Visual Studio для Unity будут использовать сведения из файлов DLL и PDB для создания файла DLL.MDB. Это формат отладочных символов, применяемый устаревшим модулем обработки скрипов Unity. Если будет применяться новая среда выполнения и формат Portable-PDB, Инструменты Visual Studio для Unity не будут пытаться преобразовывать символы, так как новая среда выполнения Unity может самостоятельно обрабатывать файлы Portable-PDB.

См. подробнее сведения о создании PDB-файлов. Если будет применяться новая среда выполнения, убедитесь, что для параметра «Отладочная информация» задано значение «Переносимый» для корректного создания файла Portable PDB. Если будет применяться устаревшая среда выполнения, воспользуйтесь значением «Полный».

Сочетания клавиш

Для быстрого доступа средств Unity к функциям Visual Studio можно использовать соответствующие сочетания клавиш. Ниже приведен список таких сочетаний клавиш.

Команда Ярлык Имя контекстной команды
Открыть мастер MonoBehavior CTRL+SHIFT+M EditorContextMenus.CodeWindow.ImplementMonoBehaviours
Открыть обозреватель проектов Unity ALT+SHIFT+E View.UnityProjectExplorer
Доступ к документации по Unity CTRL+ALT+M, CTRL+H Help.UnityAPIReference
Присоединиться к отладчику Unity (проигрыватель или редактор) значение по умолчанию отсутствует Debug.AttachUnityDebugger

Если вас не устраивает сочетание клавиш по умолчанию, его можно изменить. Чтобы узнать, как это сделать, см. статью Определение и настройка сочетаний клавиш в Visual Studio.

Команда Ярлык Имя контекстной команды
Открыть мастер MonoBehavior Cmd+Shift+M EditorContextMenus.CodeWindow.ImplementMonoBehaviours
Доступ к документации по Unity Cmd+’ Help.UnityAPIReference

Если вас не устраивает сочетание клавиш по умолчанию, его можно изменить. Сведения о том, как изменить его, см. в разделе «Настройка интегрированной среды разработки».

Инструменты Visual Studio для Unity

Screenshot of a computer, game controller, and icons for game play.

Инструменты Visual Studio для Unity содержат обширный набор функций, повышающих эффективность написания и отладки скриптов C# для Unity и работы с проектами Unity.

  • Устраняйте неполадки, проверяйте и анализируйте код с помощью отладчика, настроенного для проектов Unity.
  • Быстро выявляйте и пишите скрипты Unity с использованием механизма завершения кода IntelliSense, характерного для Unity.
  • Узнайте больше о создаваемом коде путем быстрого доступа к документации по Unity.
  • Создавайте качественный код с параметрами рефакторинга, соответствующими рекомендациям для скриптов Unity.
  • Определяйте способ, которым подсистема Unity вызывает код, с помощью указаний CodeLens для функций сообщений и использования ресурсов.
  • И выполняйте многое другое.

Доступно для Windows и macOS

Инструменты Visual Studio для Unity являются бесплатными и поддерживают Visual Studio 2017 Community, Professional, Enterprise и более поздние версии. Рекомендуется скачать и использовать последнюю версию Visual Studio.

Инструменты Visual Studio для Unity являются бесплатными и включены в каждую установку Visual Studio для Mac 2017 и более поздних версий. Рекомендуется скачать и использовать последнюю версию Visual Studio для Mac.

Ознакомьтесь с Инструменты Visual Studio для Unity начале работы с инструментами для Unity. Дополнительные сведения об установке и настройке.

Поддерживаемые версии Unity

Пакет Unity редактора Visual Studio

Для Unity 2020.1 и более поздних версий требуется пакет Unity для внешних инструментов редактора, таких как Visual Studio и Visual Studio для Mac. Документация для получения дополнительных сведений об этих изменениях в записи блога по Unity.

В разделе о начале работы содержатся дополнительные сведения о конфигурации пакета редактора Visual Studio.

Рекомендуется использовать последнюю версию пакета редактора Visual Studio.

Visual Studio Минимальная версия Unity Минимальная версия пакета
2022 Unity 2019.4 Редактор Visual Studio 2.0.11
2019 Unity 2017.4 Редактор Visual Studio 2.0.0
2017 Не рекомендуется Н/П
Visual Studio для Mac Минимальная версия Unity Минимальная версия пакета
2022 Unity 2019.4 Редактор Visual Studio 2.0.11
2019 Unity 2017.4 Редактор Visual Studio 2.0.0
2017 Не рекомендуется Н/П

Функции

Функции событий Unity

Быстро и точно добавляйте функции событий Unity, такие как Start , Update и OnCollisionEnter в скрипты C# несколькими нажатиями клавиш, используя автоматические предложения, основанные на IntelliSense.

Screenshot of the IntelliSense dialog showing OnCollisionEnter.

Создавайте код для нескольких функций событий Unity и их комментариев с помощью ⌘+Shift+M.

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

Высокопроизводительный отладчик

Инструменты Visual Studio для Unity поддерживают надежные функции отладки, характерные для Visual Studio:

  • Задавайте точки останова, включая условные.
  • Оценивайте сложные выражения в окне «Контрольные значения».
  • Проверяйте и изменяйте значения переменных и аргументов.
  • Детализируйте сложные объекты и структуры данных.

Screenshot of Visual Studio stopped on a breakpoint inspecting variables.

Быстрые исправления и предложения по рефакторингу

Напишите эффективный код, сочетающий в себе лучшие методики и глубокое понимание проектов Unity Visual Studio.

Screenshot of the Visual Studio refactoring string comparison with CompareTag.

Указания CodeLens

Определяйте места, откуда вызывается код, используя указания CodeLens, которые показывают неявные вызовы из ресурсов Unity. Выберите указание, чтобы просмотреть список неявных вызовов. При выборе конкретного вызова выполняется переход непосредственно к объекту в редакторе Unity.

Быстро отличайте код от методов Unity с помощью указаний для каждой функции события Unity.

Screenshot of a new script showing CodeLens hints for Unity Script and Unity Message.

Обозреватель проектов Unity

Отображайте файлы проекта в соответствии с представлением в окне иерархии в редакторе Unity.

Screenshot of the Unity Project Explorer.

Представление проекта Unity

Visual Studio для Mac автоматически отображает файлы проекта в соответствии с представлением в окне иерархии в редакторе Unity.

Документация Unity

Просматривайте документацию по Unity непосредственно во всплывающих подсказках при проверке кода.

Screenshot of Unity documentation showing in tooltips.

Быстро выполните поиск в документации по Unity, указав > имя класса или метода, а затем выберите пункт меню справки по API Unity.

Поддержка шейдеров

Выделение синтаксиса и автоматическое завершение для файлов шейдера.

Поддержка файлов определения сборки

Измените файлы определения сборки Unity (ASMDEF) непосредственно в Visual Studio с помощью ключевое слово цвета и завершения.

Выполнение и отладка модульных тестов

Создавайте, выполняйте и отлаживайте модульные тесты непосредственно в Visual Studio для Mac.

Автоматическое обновление ресурсов Unity

Тратить меньше времени на переключение между Unity и Visual Studio. Изменения кода автоматически обновляются в Unity при сохранении файлов.

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *