Отладка кода C# в Unity

Вы можете использовать отладчик для проверки исходного кода во время запуска приложения. Каждый поддерживаемый IDE имеет зависимости, которые необходимо установить, чтобы IDE мог надлежащим образом интегрироваться с Unity. Подробную информацию о том, что требуется для настройки каждого поддерживаемого IDE для отладки в Unity, см. в Поддержка интегрированной среды разработки (IDE).

Хотя эти IDEs слегка отличаются по поддерживаемым функциям отладки, все они обеспечивают базовую функциональность, такую как точки останова, одиночный шаг и проверка переменных. Вы можете подключить IDE к Unity Editor или Unity Player для отладки кода.

Управляемая отладка кода в Unity работает на всех платформах, за исключением Web. Она работает как с Mono и IL2CPP Скрипт-бэкэнд.

Отладка в Unity Editor

Для отладки кода режима редактирования или воспроизведения по мере его выполнения в редакторе:

Настройте IDE для разработки и отладки Unity.
Установить Оптимизация кода редактора режим для отладки.
Присоедините свой IDE к процессу Unity Editor.

Тип: При запуске Редактора в пакетном режиме, вы можете использовать аргумент командной строки -wait-for-managed-debugger заставляет редактор дожидаться подключения управляемого отладчика перед запуском.

Отладка в Unity Player

Для отладки кода режима воспроизведения, когда он запускается в Unity Player:

Настройте IDE для разработки и отладки Unity.
Строительство ваш проект с Разработка Build и Отладка сценариев варианты включен. Дополнительно включите Подождите управляемого отладчика возможность заставлять Проигрыватель ждать, пока отладчик подключится, прежде чем запускать и выполнять любой скриптовый код.
Присоедините ваш IDE к процессу Unity Player.

Примечание: При запуске Проигрывателя в пакетном режиме можно использовать аргумент командной строки -wait-for-managed-debugger чтобы заставлять проигрыватель ждать, пока управляемый отладчик подключится перед запуском.

Настройка режима оптимизации кода Unity Editor

Настройка оптимизации кода Редактора имеет два режима:

Отладка: Разрешает подключение к внешнему отладчику, но код работает медленнее в режиме Play.
Выпуск: Код работает быстрее в режиме Play, но вы не можете подключиться к внешнему отладчику.

Чтобы подключить отладчик к вашему Редактору, вам сначала нужно установить режим оптимизации кода Редактора на режим отладки. Вы можете изменить настройку оптимизации кода следующим образом:

Нажмите кнопку режима оптимизации кода (иконка ошибки) в правом нижнем углу экрана редактора. строка статуса. Откроется небольшое всплывающее окно с кнопкой, которую вы можете использовать для переключения режимов.
Из Предпочтения окно: Чтобы изменить режим Unity Editor запускается в, перейти к Изменить > Предпочтения (macOS: Unity > Настройки) > Общие положения и изменить Оптимизация кода при запуске установка.
Из кода: Вы можете изменить режим оптимизации кода с помощью ManagedDebugger, Compilation.CompilationPipeline-codeOptimizationи Compilation.CodeOptimization APIs.
Из командной строки: используйте аргумент командной строки -releaseCodeOptimization для запуска Редактора в режиме выпуска и -debugCodeOptimization для запуска в режиме отладки. Дополнительные сведения см. в Аргументы отладки.

Установка точек останова

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

Если вы присоедините свой IDE к Unity Editor, Редактор перестанет отвечать на точки останова, пока вы не выберете опцию продолжения в вашем IDE или не остановите отладку.

Дополнительные сведения о том, как установить точки останова, см. в соответствующей документации для вашего IDE:

Визуальная студия.
Visual Studio Код.
Райдер.

Присоединение вашего IDE к Unity Editor или процессу Player

Способ присоединения IDE к процессу Unity Editor или Player зависит от используемого IDE. Некоторые IDEs имеют опцию присоединения, специфическую для Unity, которая отличается от стандартного процесса присоединения к другим приложениям.

Информацию о том, как подключиться к Unity для отладки, см. в соответствующей документации для вашего IDE:

Visual Studio: Использование Visual Studio Tools для Unity (Windows)
Visual Studio Код: Unity Разработка с VS Код
Jetbrains Rider: Отладка Unity Приложения

Как только вы подключитесь к Unity Editor, вернитесь к Unity Editor и перейдите в режим Play, чтобы начать отладку.

Для подключения к встроенному плееру, выберите IP адрес (или имя машины) и порт вашего плеера из вашего IDE. Когда вы подключили отладчик, вы можете начать отладку обычным образом.

Примечание: Ваш IDE отображает все экземпляры Unity, доступные для отладки. Убедитесь, что вы отличаете процесс Редактора от процесса Игрока, если оба выполняются.

Android

Для отладки проигрывателя Unity, запущенного на устройстве Android, подключитесь к устройству с помощью USB или TCP.. Например, для подключения к устройству Android в Visual Studio выберите Отладка > Attach Unity Debugger. Появится список устройств, на которых запущены экземпляры проигрывателя.

Дополнительные сведения см. в Отладка на устройствах Android.

iOS

Для отладки Unity Player, работающего на устройстве iOS, подключитесь к устройству с помощью TCP.

Убедитесь, что на устройстве активен только один сетевой интерфейс (рекомендуется Wi-Fi, мобильные данные отключите) и что между IDE и устройством нет брандмауэра, блокирующего TCP-порт (на снимке экрана выше это порт 56000).

Важная: iOS не поддерживает отладку над USB.

Дополнительные сведения см. в Тестирование и отладка приложения iOS.