Unity сообщение об ошибке

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

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

Запись ошибок, предупреждений и сообщений

Unity сама иногда регистрирует ошибки, предупреждения и сообщения в окне консоли. Класс Debug предоставляет вам возможность сделать то же самое из вашего собственного кода, как показано ниже:

Debug.Log("This is a log message.");
Debug.LogWarning("This is a warning message!");
Debug.LogError("This is an error message!");


Каждый из трех типов (ошибка, предупреждение и сообщение) имеет собственный тип значка в окне консоли.

Все, что записывается в окно консоли (Unity или ваш собственный код), также записывается в файл журнала.

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

Вы также можете дополнительно указать второй параметр для этих методов журнала, чтобы указать, что сообщение связано с определенным GameObject фундаментальный объект в сценах Unity, который может представлять персонажей, реквизит, декорации, камеры, путевые точки и многое другое. Функциональность GameObject определяется прикрепленными к нему компонентами. Подробнее
См. в Словарь, например:

using UnityEngine;

public class DebugExample : MonoBehaviour
{ void Start()
{
Debug.LogWarning("I come in peace!", this.gameObject);
}
}


Преимущество этого заключается в том, что когда вы щелкаете сообщение в консоли, игровой объект, связанный с этим сообщением, выделяется в иерархии, что позволяет вам определить, к какому игровому объекту относится сообщение. На изображении ниже вы можете видеть, что нажатие кнопки «Я пришел с миром!» предупреждающее сообщение выделяет игровой объект «Чужой (8)».

Класс Debug также предлагает два метода рисования линий в виде сценыинтерактивном представлении мира, который вы создаете. Вы используете Scene View для выбора и размещения пейзажей, персонажей, камер, источников света и всех других типов игровых объектов. Дополнительная информация
См. в Словарь и в режиме игры. Это DrawLine и DrawRay.

В этом примере к каждому игровому объекту Sphere в сцене добавлен скрипт, который использует Debug.DrawLine для указания расстояния по вертикали от плоскости, где Y равно нулю. Обратите внимание, что последний параметр в этом примере — это время в секундах, в течение которого линия должна оставаться видимой в редакторе.

using UnityEngine;

public class DebugLineExample : MonoBehaviour
{
// Start is called before the first frame update
void Start()
{
float height = transform.position.y;
Debug.DrawLine(transform.position, transform.position - Vector3.up * height, Color.magenta, 4);
}
}


И результат в представлении «Сцена» выглядит так:

Вывести сообщение в консоль (Отладка, дебаг)

Вывести сообщение в консоль можно через метод Debug.Log().

Debug.Log("Сообщение для отладки");
Debug.LogError("Сообщение с ошибкой");

В результате во вкладке Console будут показываться сообщения.

В этом разделе содержится информация по следующим вопросам:

Тип ошибки	Сообщение об ошибке:
General startup issues	— Error messages in the Package Manager window — Package Manager missing or window doesn’t open — Problems after upgrading Unity to new version — Resetting your project’s package configuration
Package installation issues	— Package installation fails — Packages not recognized
Problems installing git dependencies	— No ‘git’ executable was found — git-lfs: command not found — Repository not found — Could not read Username: terminal prompts disabled — Can’t update Git version
Asset StoreA growing library of free and commercial assets created by Unity and members of the community. Offers a wide variety of assets, from textures, models and animations to whole project examples, tutorials and Editor extensions. More info See in Словарь packages (My Assets)	— ‘Failed to parse Http response’ in My Assets context
Scoped registries	— Missing ‘My Registries’ in the Package Manager window
Issues when building packages	— Missing MonoBehaviour errors — Loading error for hostfxr.dll on Windows

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

Error messages in the Package Manager window

Диспетчер пакетов отображает индикаторы ошибок в окне диспетчера пакетов при возникновении проблем:

• Общесистемные проблемы

  Сообщения об ошибках, которые появляются в строке состояния, указывают на то, что диспетчер пакетов обнаружил проблему, не связанную с конкретным пакетом. Например, если диспетчер пакетов не может получить доступ к серверу реестра пакетов, он отображает это сообщение в строке состояния:

  

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

  Если ваше сетевое соединение работает, но вы не вошли в свою учетную запись Unity, диспетчер пакетов не не отображать пакеты Asset Store. При попытке использовать контекст My Assets диспетчер пакетов отображает ошибку в строке состояния:

  

  Нажмите кнопку Sign in в списке, чтобы войти в свою учетную запись Unity через Центр Unity.

• Проблемы, связанные с пакетом

  Если при загрузке или установке определенного пакета возникает проблема (например, при определении версий пакета для загрузки), значок ошибки () отображается в списке пакетов рядом со скомпрометированным пакетом (A). Чтобы выяснить, в чем проблема, откройте представление сведений о скомпрометированном пакете и просмотрите подробное сообщение об ошибке (B):

  

Package Manager missing or window doesn’t open

Окно диспетчера пакетов может быть перемещено за пределы экрана или скрыто другим окном. Когда это происходит, похоже, что окно диспетчера пакетов не открылось. В этом случае вы можете попытаться сбросить макет окна (Window > Layouts > Default) и снова открыть окно диспетчера пакетов.

Если окно диспетчера пакетов по-прежнему не отображается, проверьте окно консоли Unityокно редактора Unity, в котором отображаются ошибки, предупреждения и другие сообщения, созданные Unity или вашими собственными сценариями. Подробнее
См. в Словарь:

Failed to resolve packages: The file [/Packages/manifest.json] is not valid JSON:
Unexpected token '}' at 44:1
}


Это сообщение об ошибке указывает на то, что ваш файл manifest.json имеет неверный формат. Он также сообщает вам номер строки, в которой диспетчеру пакетов не удалось проанализировать файл, чтобы вы могли исправить ошибку JSON. Существует ряд онлайн-валидаторов, которые вы можете использовать, чтобы попытаться решить проблему. Как только вы сохраните исправленный файл, Unity перезагрузит окно диспетчера пакетов.

Если вы выполнили обновление с ранней версии редактора Unity, могут возникнуть другие проблемы с вашим манифестом пакетаКаждый пакет имеет манифест, который предоставляет информацию о пакете диспетчеру пакетов. Манифест содержит такую ​​информацию, как имя пакета, его версия, описание для пользователей, зависимости от других пакетов (если есть) и другие подробности. Дополнительная информация
См. в файле Словарь:

• В версии 2019.3 ваш файл manifest.json не должен содержать никаких ссылок на пакет com.unity.package-manager-ui. Вы можете либо сбросить конфигурацию пакета вашего проекта, либо удалить следующую строку из списка зависимостей манифеста:

  "com.unity.package-manager-ui": "2.1.1",


• Проверьте, есть ли в вашем манифесте проектакаждый проект Unity манифест проекта , который действует как точка входа для диспетчера пакетов. Этот файл должен находиться в каталоге /Packages. Диспетчер пакетов использует его для настройки многих вещей, включая список зависимостей для этого проекта, а также любой репозиторий пакетов для запроса пакетов. Дополнительная информация
  См. Словарь функция «exclude» в качестве пакетной версии. Это устаревшее значение для зависимостей
  См. в свойстве Словарь. Если вы найдете такие строки, удалите всю строку. Диспетчер пакетов устанавливает только те пакеты, которые явно включены в ваш проект как зависимость, поэтому после удаления этой записи диспетчер пакетов игнорирует пакет и не устанавливает его.

Если диспетчер пакетов по-прежнему не загружается, следуйте инструкциям в разделах Нераспознанные пакеты и Сброс конфигурации пакета вашего проекта.

Problems after upgrading Unity to new version

При обновлении проекта до более новой версии Unity диспетчер пакетов автоматически обновляет несовместимые пакеты до более новых совместимых версий. Однако, если ваш пакет не компилируется, диспетчер пакетов отображает сообщения об ошибках в консоли.

Чтобы исправить эти сообщения, прочтите сообщения об ошибках и устраните все возможные проблемы. Например, в пакете может отсутствовать зависимость от другого пакета или версии. В этом случае вы можете попробовать установить пакет самостоятельно.

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

• Создайте резервную копию и удалите папку Packages в своем проекте.
• Создайте резервную копию, а затем удалите исходные коды пакетов в папке Packages вашего проекта, оставив только файл manifest.json. Затем попробуйте перезагрузить проект.
• Создайте новый пустой проект. Если окно диспетчера пакетов загружается успешно, замените папку Library/PackageCache/com.unity.package-manager-ui@ в неудачном проекте на ту же папку из только что созданный проект.
• В крайнем случае вы можете сбросить свой проект до пакета по умолчаниюUnity автоматически предварительно устанавливает выбранное количество пакетов по умолчанию (например, Analytics Library, Unity Timeline и т. д.) при создании нового проекта. Он отличается от встроенного пакета тем, что его не нужно устанавливать, и отличается от встроенного пакета тем, что расширяет возможности Unity, а не позволяет включать или отключить их.
  Просмотрите в конфигурации Словарь и добавляйте обратно пакеты по одному, пока не заработает.

Resetting your project’s package configuration

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

Примечание. Вы не можете отменить сброс конфигурации пакета, поэтому сначала создайте резервную копию файла manifest.json или убедитесь, что ваш проект находится под управлением исходного кода. Вы также можете принять дополнительные меры предосторожности, клонировать свой проект и протестировать операцию на клоне, прежде чем продолжить.

Чтобы вернуться к конфигурации пакета по умолчанию, выберите Reset Packages to defaults в меню Help.

Resetting a clone of your project

Вы также можете протестировать возврат к пакетам по умолчанию, прежде чем вносить окончательные изменения:

1. Клонируйте свой проект, скопировав папку проекта и переименовав ее, чтобы ее было легко найти (например, если ваш проект называется MyProject, вы можно использовать что-то вроде clone_MyProject).

2. Загрузите новый клонированный проект.

3. В меню «Help» выберите Reset Packages to defaults.

   В зависимости от размера вашего проекта это может занять несколько минут.

4. Убедитесь, что он успешно сбросил пакеты. Если это так, вы можете безопасно выполнить операцию в исходном проекте.

Package installation fails

Если вы пытаетесь установить новый пакет из реестра, и он не работает, это может быть связано с проблемами с правами доступа.

У вас должны быть полные права доступа к папке кеша:

• Windows: C:UsersyournameAppDataLocalUnitycache
• MacOS: ~/Users/Library/Unity/cache

Это может быть проблема с сетью. Проверьте настройки брандмауэра и прокси-сервера.

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

Packages not recognized

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

Для Windows:

1. Загрузите и установите Visual Studio 2017 версии 15.9.0 или выше с рабочей нагрузкой .NET Core cross-platform development workload, выбранной в разделе Other Toolsets.
2. Загрузите и установите компонент .NET SDK v2.2.101.

Для MacOS:

1. Загрузите и установите компонент .NET SDK v2.2.101.

2. Установите все рекомендуемые обновления в Visual Studio

3. Используйте homebrew для приготовления и установки mono:

   brew update
brew install mono # optional
brew upgrade mono


4. При необходимости удалите папку Library/obj/temp в своем проекте и перезапустите Unity.

5. Если вы по-прежнему испытываете трудности, попробуйте также перезагрузить компьютер.

No ‘git’ executable was found

Если вы попытаетесь установить пакет с URL-адреса git, появится сообщение, похожее на это:

Cannot perform upm operation: Unable to add package
[https://github.example.com/myuser/myrepository.git]:
No 'git' executable was found. Please install Git on your system and restart Unity [NotFound]
UnityEditor.EditorApplication:Internal_CallUpdateFunctions()


git-lfs: command not found

Если вы пытаетесь загрузить пакет, использующий Git LFS (большое файловое хранилище), вы можете увидеть следующее сообщение об ошибке:

Error when executing git command. git-lfs filter-process: command not found.

Это указывает на то, что Git LFS, вероятно, не установлен на вашем компьютере. Чтобы убедиться, вы можете проверить это в командной строке:

git lfs --version

Если вы видите что-то подобное, Git LFS установлен:

git-lfs/2.8.0 (GitHub; darwin amd64; go 1.12.7)

В противном случае вы можете установить его, выполнив Bitbucket GitHub.

Repository not found

Если указать несуществующее расположение, в Консоли Unity появится сообщение, похожее на это:

Cannot perform upm operation: Unable to add package [https://mycompany.github.com/gitproject/com.mycompany.mypackage.git]:
Error when executing git command. fatal: repository 'https://mycompany.github.com/gitproject/com.mycompany.mypackage.git/' not found
[NotFound]
UnityEditor.EditorApplication:Internal_CallUpdateFunctions() (at /Users/builduser/buildslave/unity/build/Editor/Mono/EditorApplication.cs:310)


Проверьте правописание. Чтобы убедиться, что вы используете правильный URL-адрес, перейдите на страницу репозитория и скопируйте URL-адрес из кнопки «Клонировать»:

Нажмите кнопку справа от URL-адреса на GitHub (A) или GitLab (B), чтобы скопировать URL-адрес в буфер обмена.

Если расположение репозитория верное, может быть другая проблема с URL-адресом:

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

  https://github.example.com/myuser/myrepository1.git#revision

• Если вы нацелены на ревизию, а пакет не находится в корне, убедитесь, что параметр запроса path предшествует привязке ревизии. Например:
  https://github.example.com/myuser/myrepository.git?path=/example/folder#v1.2.3

Could not read Username: terminal prompts disabled

Если вы пытаетесь установить пакет из частного репозитория, для которого требуется аутентификация, в консоли Unity появится сообщение, похожее на это:

Cannot perform upm operation: Unable to add package [https://mycompany.github.com/gitproject/com.mycompany.mypackage.git]:
Error when executing git command. fatal: could not read Username for 'https://mycompany.github.com': terminal prompts disabled
[NotFound]
UnityEditor.EditorApplication:Internal_CallUpdateFunctions() (at /Users/builduser/buildslave/unity/build/Editor/Mono/EditorApplication.cs:310)


Это сообщение, вероятно, связано с тем, что диспетчер пакетов не предоставляет интерактивный терминал или диалоговое окно, где вы можете ввести свое имя пользователя и пароль для HTTP или парольную фразу для разблокировки ключа SSH:

• При использовании HTTP(S) каждый раз, когда вы входите в BitBucket, GitHub или GitLab, вам необходимо вводить имя пользователя и пароль в терминале или диалоговом окне. Однако диспетчер пакетов не предоставляет интерактивный терминал или диалоговое окно, где вы можете ввести свое имя пользователя и пароль для HTTP(S).

  Чтобы избежать этого, используйте один из обходных путей, предложенных в разделе Решения для HTTPS.

• SSH использует пару открытых и закрытых ключей SSH. Вы можете добавить свой открытый SSH-ключ в Bitbucket, GitHub или GitLab, а затем получить доступ к репозиториям без ввода имени пользователя и пароля.

  Однако, если вы установили парольную фразу для обеспечения безопасности своего ключа SSH, вам все равно придется ввести эту парольную фразу в терминал или диалоговое окно, чтобы авторизовать свой ключ. В этом случае вы можете использовать агент SSH, который может разблокировать ваш ключ SSH для аутентификации в диспетчере пакетов от вашего имени.

Решения для HTTPS

Диспетчер пакетов не предоставляет интерактивный терминал или диалоговое окно, где вы можете ввести свое имя пользователя и пароль HTTP(S). Чтобы обойти это, используйте один из следующих обходных путей:

• Используйте диспетчер учетных данных (Git Credential-Manager для Windows или OSXKeyChain). Менеджеры учетных данных обрабатывают отправку пароля без использования терминала или командной строки.
• Используйте git-credential-Storage из терминала или командная строка. Затем запустите Hub с того же терминала, чтобы у Unity был доступ к кэшированным или сохраненным учетным данным.
• Вместо этого используйте SSH для аутентификации. Если вы настроили свой SSH-ключ без парольной фразы, диспетчеру пакетов не нужно его расшифровывать для аутентификации на сервере Git. Если вы решите использовать парольную фразу для дополнительной безопасности, вы все равно можете обойти проблему аутентификации, используя ssh-agent в любой из macOS или Windows.

Решения для SSH

Если вы используете протокол SSH для установки пакета по URL-адресу Git, вы можете получить ошибку аутентификации от Git. Обычно это происходит, когда вы настраиваете закрытый ключ SSH на локальном компьютере, который защищен парольной фразой.

Решение этой проблемы заключается в настройке агента SSH, который может разблокировать ваш ключ SSH для аутентификации в диспетчере пакетов от вашего имени. Следуйте инструкциям в разделе, соответствующем вашей операционной системе:

• Настройка OpenSSH для Windows
• Добавление ключей SSH в агент SSH для macOS

Настройка OpenSSH для Windows

Собственная версия OpenSSH для Windows ssh-agent работает лучше, чем версия, доступная по умолчанию с Git для Windows. Эта процедура объясняет, как настроить клиент OpenSSH и добавить свой ключ в его ssh-агент. Если вы используете Git для Windows, вы также можете отдать приоритет собственному Windows OpenSSH над агентом Git для Windows SSH:

1. Убедитесь, что клиент OpenSSH установлен, выполнив поиск в окне настроек Windows Optional features (Start > Settings, затем найдите «Optional features»). Это относится к Windows 10+.

2. Проверьте переменную среды %PATH%, чтобы убедиться, что отображается собственное расположение Windows OpenSSH (например, C:WINDOWSSystem32 OpenSSH).

   Примечание. Если вы уже используете Git для Windows, убедитесь, что собственное расположение Windows OpenSSH указано перед расположением Git для Windows SSH в вашем %PATH% переменная. Это гарантирует, что Windows использует собственный агент Windows OpenSSH вместо агента Git для Windows SSH.

3. В терминале PowerShell запустите процесс ssh-agent и убедитесь, что он запускается автоматически:

   # Set the ssh-agent service to start automatically and manually start it now
Get-Service ssh-agent | Set-Service -StartupType Automatic
# Run the ssh-agent process to start the ssh-agent service
ssh-agent


4. Импортируйте свой ключ в ssh-agent, запустив ssh-add в командной строке и следуя инструкциям. По умолчанию агент добавляет ключ %USERPROFILE%.sshid_rsa и запрашивает пароль.

   # Import the key
ssh-add


   Чтобы использовать другой ключ, вы можете указать его в качестве аргумента:

   # Set the ssh-agent service to start automatically and manually start it now
ssh-add


   Если вы не можете вспомнить название своего ключа, вы можете попросить агента перечислить их:

   ssh-add -l

5. Если вы установили Git для Windows, сбросьте переменную среды %GIT-SSH%, чтобы убедиться, что Git всегда использует собственную версию ssh-agent для Windows OpenSSH:

   [Environment]::SetEnvironmentVariable("GIT_SSH", "$((Get-Command ssh).Source)", [System.EnvironmentVariableTarget]::User)


Добавление ключей SSH в агент SSH для macOS

Используйте следующую команду, чтобы добавить ключи SSH в ssh-agent, работающий на вашей macOS. система:

ssh-add -K ~/.ssh/

После выполнения этой команды терминал запрашивает пароль для разблокировки ключа SSH, а затем добавляет его в цепочку ключей macOS. Однако после перезагрузки системы все ключи, хранящиеся в ssh-agent, сбрасываются.

Чтобы предотвратить повторный ввод пароля после перезагрузки системы, откройте файл ~/.ssh/config (или создайте его, если вы его не найдете) и добавьте следующее:

Host *
UseKeychain yes
AddKeysToAgent yes
IdentityFile ~/.ssh/


Перезагрузите компьютер, чтобы применить эти изменения.

Can’t update Git version

Если вы пытаетесь обновить свою зависимость Git, диспетчер пакетов получает зависимости Git непосредственно из репозитория Git, а не из реестр пакетов. Зависимости Git используют ссылку URL-адреса Git вместо версии, и нет никаких гарантий относительно качества, стабильности, достоверности пакета или даже того, соответствует ли версия, указанная в его файле package.json. Правила семантического управления версиями в отношении официально опубликованных выпусков этого пакета. Дополнительная информация
Посмотрите в Словарь более новую версию из репозитория, но она не работает, вероятно, это связано с тем, что ваша зависимость от Git заблокирована. Если вы хотите обновить свою зависимость Git до более новой версии из репозитория, используйте кнопку Добавить пакет из URL-адреса git и введите URL-адрес Git. Дополнительные сведения см. в разделе Заблокированные зависимости Git.

‘Failed to parse Http response’ in My Assets context

Если вы видите следующее сообщение в окне консоли при попытке загрузить пакет Asset Store, возможно, возникла проблема с кешем Asset Store:

[PackageManager] Error Failed to parse response. UnityEditor.AsyncHTTPClient![:D](https://forum.unity.com/styles/default/xenforo/clear.png)one(State, Int32)

Чтобы решить эту проблему, удалите все загруженные ресурсы из каталога пакетов Asset Store, а затем повторите попытку загрузки ресурсов.

Предупреждение. Если ваш проект содержит много данных об объектах, повторная загрузка может занять много времени и трафика.

Missing ‘My Registries’ in the Package Manager window

Не все поставщики реестра совместимы с диспетчером пакетов Unity. Если добавленный вами сервер реестра пакетов не реализует конечные точки /-/v1/search или /-/all, ваш реестр с заданной областью не совместим с диспетчером пакетов Unity и не отображается в контексте My Registries в окне диспетчера пакетов.

Missing MonoBehaviour errors

Во время сборки, если возникает много ошибок, связанных с отсутствующим поведением, UnityLinker может по ошибке удалить компонент, который, по его мнению, не указан. Часто это происходит из-за слишком агрессивного уровня зачистки. Например, если у вас есть префабтип актива, который позволяет хранить GameObject вместе с компонентами и свойствами. Префаб действует как шаблон, из которого вы можете создавать новые экземпляры объектов на сцене. Подробнее
См. в Словарь в AssetBundle, который ссылается на компонент SpriteShape в пакете 2D SpriteShape. , объект может отсутствовать и вызывать предупреждения компилятора.

Чтобы исправить это, вы можете либо понизить уровень разделения для UnityLinker, либо объявить сборки пакета в файле link.xml, чтобы предотвратить их удаление:

<linker>
<assembly fullname="Unity.2D.SpriteShape.Runtime" preserve="all"/>
<assembly fullname="Unity.2D.Common.Runtime" preserve="all"/>
</linker>


Дополнительную информацию об уровнях удаления и UnityLinker см. в разделе Управляемое удаление кода.

Loading error for hostfxr.dll on Windows

Если консоль сообщает, что библиотека hostfxr.dll найдена, но Unity не удалось загрузить ее из C: hostfxr.dll, вы можете исправить эту ошибку в Windows 7 или Windows Server 2008 R2, установив обе KB2999226 и KB2533623 исправления.

The most basic thing you can do in programming is print a string onto the console. Unity is the same: You can write a string to Unity Editor’s console, and there are different types of log messages and ways you can customize to make debugging easier.

The most common logging method is the Debug.Log() method which prints a regular string onto the console in Unity in the default text color. There are also 2 other types of log types called Debug.LogWarning() and Debug.LogError() that prints a string in yellow and red, respectively.

Knowing how to use the logging methods and how they interact with the Unity console will make your life much easier. Read more below to learn how to customize debug messages.

Table of Contents

• Debug.Log
• Debug.LogWarning
• Debug.LogError
• Debug.LogException
• Format Debug Log Messages with Rich Text Markup
• Composite Formatting
• Ending Thoughts

The Debug.Log is the most basic and the easiest way to print a value to the Unity console.

Simply supply it with a string or any value that can be converted into a string and it will display the message on the console.

using System.Collections;
using System.Collections.Generic;
using UnityEngine;

public class TestScript : MonoBehaviour
{
    private void Start()
    {
        Debug.Log("This string will be printed to the console.");
    }
}
Code language: C# (cs)

The result will look something like this in the console:

Clicking on the message will bring up a small details section that tells you about where the message comes from.

For example, the message in the image above is at line number 9 in the script named TestScript.

Additionally, the latest console message will also display at the bottom left corner of Unity Editor.

The Debug.Log method can print the value of anything as long as it can be converted into a string.

using System.Collections;
using System.Collections.Generic;
using UnityEngine;

public class TestScript : MonoBehaviour
{
    private void Start()
    {
        float someNumber = 420.69f;
        bool isVeryCool = true;
        
        Debug.Log(someNumber);
        Debug.Log(someNumber + " BLAZE IT");
        Debug.Log(isVeryCool);
    }
}




  


                       
  



Code language: C# (cs)

The code above will print 3 lines of messages to the Unity console:

You can also link a related game object to a console message to make it easier to find where the message comes from by passing an object as the second parameter of the Debug.Log method.

using System.Collections;
using System.Collections.Generic;
using UnityEngine;

public class TestScript : MonoBehaviour
{
    private void Start()
    {
        int someNumber = 1234;
        
        Debug.Log("This is a number: " + someNumber, transform);
    }
}
Code language: C# (cs)

This will highlight the associated object in the hierarchy window when you click on the message in the console window.

Aside from logging messages to the Unity console, Debug.Log (and other logging methods) also logs messages to log files of your game. Information on where to find these log files for each platform can be found here.

Debug.LogWarning

The Debug.LogWarning works the same way as Debug.Log but the message printed will have a warning icon and the color of the message on the bottom left corner of the Unity Editor will be yellow instead.

This one is generally used to give a warning that something might not be working correctly or something is missing from the code but can still work. Something like that. You get the idea.

using System.Collections;
using System.Collections.Generic;
using UnityEngine;

public class TestScript : MonoBehaviour
{
    private void Start()
    {
        Debug.LogWarning("Setting the width to more than 300px will result in a drop in performance.");
    }
}
Code language: C# (cs)

This will log a message with a warning icon to the console.

The warning message shown at the bottom left corner of Unity Editor will be yellow.

An object can also be passed to the method to link the object with the warning message, just like Debug.Log.

Debug.LogError

The Debug.LogError method behaves in the same way as the Debug.Log method and the Debug.LogWarning method, but the message logged to the Unity console will have an error icon and the message at the bottom of the editor will be red.

This logging method is commonly used for displaying code-breaking error messages to the console.

using System.Collections;
using System.Collections.Generic;
using UnityEngine;

public class TestScript : MonoBehaviour
{
    private void Start()
    {
        Debug.LogError("Failed to initialize player's default parameters.");
    }
}
Code language: C# (cs)

The message printed to the console will have an error icon attached to it.

The message shown at the bottom left corner of Unity Editor will have a dark red text color.

An object can also be passed to the method to link the object with the error message, just like Debug.Log.

Debug.LogException

The Debug.LogException is used to log exceptions to the Unity console. It works the same way as the regular Debug.LogError except you supply it with an exception object instead of a string.

You use this when you want the error to be more specific, or you want to capture an exception and print it to the console manually.

using System.Collections;
using System.Collections.Generic;
using UnityEngine;

public class TestScript : MonoBehaviour
{
    private void Start()
    {
        Debug.LogException(
            new MissingComponentException(
                "RigidBody2D is missing in " + transform.gameObject.name +
                ". RigidBody2D is required for this script to work properly."
            ),
            transform
        );
    }
}




  


                       
  



Code language: C# (cs)

This will log an exception to the console with an error icon.

This message will display as dark red text at the bottom left corner of the Unity Editor.

It might be a little hard to see as I’m using dark mode, but it’s there.

Format Debug Log Messages with Rich Text Markup

All Debug.Log variants can be further customized using rich text markup. You can do various things such as making a word bold or changing the color of a message.

The rich text markup’s syntax is similar to HTML markup but not entirely the same.

using System.Collections;
using System.Collections.Generic;
using UnityEngine;

public class TestScript : MonoBehaviour
{
    private void Start()
    {
        Debug.Log("I do <b>NOT</b> like ducks.");

        Debug.LogWarning("Something <i>weird</i> might happen. Be careful.");

        Debug.LogError("This function stopped working <b><i>again</i></b>.");

        Debug.Log("<color=red>Red</color>/<color=blue>Blue</color>/<color=green>Green</color>");
    }
}
Code language: C# (cs)

If you’re familiar with HTML, this one should be easy to understand. For more information about the rich text, visit the Unity Rich Text Official Manual page.

Composite Formatting

All Debug.Log variants come with Format versions of themselves which allow more complex formatting called Composite Formatting.

These methods are:

• Debug.LogFormat
• Debug.LogWarningFormat
• Debug.LogErrorFormat

using System.Collections;
using System.Collections.Generic;
using UnityEngine;

public class TestScript : MonoBehaviour
{
    private void Start()
    {
        string[] names = { "Chloe", "Angelica", "Yufine", "Tamarinne" };
        float[] money = { 1250f, 777f, 240.5723f, 300f };

        for (int i = 0; i < names.Length; i++)
        {
            Debug.LogFormat("{0} | {1:C2}", names[i], money[i]);
        }
    }
}
Code language: C# (cs)

For more information about composite formatting, refer to MSDN documentation on Composite Formatting.

Ending Thoughts

Knowing how to log messages to the console in different ways can make your debugging process a lot easier, both to yourself and to those who work with you.

I recommend trying those logging methods out yourself in the editor so it’s easier to understand.

I hope this has been a good read for you. Leave a comment if you have suggestions or I’m missing something. And I’ll see you again in the next article!

Cheers!

Attribution

Console icon made by Freepik from www.flaticon.com

---

---

---

---

Вернуться в Почемучка

Кто сейчас на конференции

Сейчас этот форум просматривают: Google [Bot] и гости: 32