Unity 개발 중에는 실시간 디버그 메시지 확인과 명령어 실행이 효율성을 높이는 데 중요합니다. IngameDebugConsole은 uGUI 기반의 디버그 도구로, 게임 실행 중에 로그를 쉽게 확인하고 명령을 실행할 수 있어 디버깅 과정을 크게 간소화합니다. 이 가이드에서는 이 유용한 도구를 빠르게 통합하는 방법을 알아보겠습니다.

IngameDebugConsole이란?

IngameDebugConsole은 Unity를 위해 특별히 설계된 게임 내 디버그 콘솔입니다. 개발자가 게임 실행 중에 디버그 정보를 직접 확인하고, 로그 유형을 필터링하며, 사용자 정의 명령을 실행할 수 있도록 지원합니다. uGUI를 사용하여 구축되었으며, 깔끔하고 직관적인 인터페이스를 제공하며 여러 플랫폼을 지원합니다. Unity 개발에서 필수적인 디버깅 도우미입니다.

5분 만에 통합하기

1. 소스 코드 가져오기

먼저 프로젝트를 로컬로 복제해야 합니다. 터미널에서 다음 명령을 실행합니다:

git clone https://gitcode.com/gh_mirrors/un/UnityIngameDebugConsole
  

2. Unity 프로젝트에 가져오기

복제한 프로젝트의 Plugins 폴더를 Unity 프로젝트의 Assets 디렉토리로 복사합니다. 가져오기가 완료되면 Unity가 관련 종속성과 리소스를 자동으로 처리합니다.

3. 씬에 프리팹 추가하기

프로젝트 창에서 Plugins/IngameDebugConsole/IngameDebugConsole.prefab 프리팹을 찾아 현재 씬으로 드래그합니다. 이 프리팹에는 디버그 콘솔의 모든 UI 요소와 로직 컴포넌트가 포함되어 있습니다.

4. 디버그 콘솔 구성 (선택 사항)

콘솔의 모양과 동작을 사용자 정의하려면 Inspector 패널에서 DebugLogConsole 컴포넌트의 매개변수(예: 콘솔 위치, 크기, 단축키 등)를 조정할 수 있습니다. 기본적으로 백틱(`) 키를 누르면 콘솔이 나타납니다.

주요 기능 사용법

로그 보기 및 필터링

콘솔 상단에는 일반 정보, 경고, 오류를 포함한 다양한 로그 유형에 대한 필터 버튼이 있습니다. 해당 버튼을 클릭하여 특정 유형의 로그를 표시하거나 숨겨 문제를 신속하게 파악할 수 있습니다.

명령 실행

콘솔 하단의 입력 상자에 명령어를 입력하고 Enter 키를 누르면 실행됩니다. 시스템은 help (사용 가능한 모든 명령 표시), clear (로그 지우기)와 같은 몇 가지 일반적인 명령어를 기본적으로 제공합니다. 코드를 통해 사용자 정의 명령을 추가하여 콘솔 기능을 확장할 수도 있습니다.

로그 복사 및 내보내기

콘솔은 로그 복사 기능을 제공하여 중요한 로그 정보를 클립보드에 저장하는 데 편리합니다. WebGL 플랫폼의 경우 DebugLogItemCopyWebGL.cs 스크립트를 통해 로그 복사 기능을 구현할 수 있습니다.

일반적인 문제 해결

콘솔이 표시되지 않는 경우

IngameDebugConsole.prefab이 씬에 올바르게 추가되었는지, DebugLogManager 스크립트가 정상적으로 실행되는지 확인합니다. 다른 UI 요소가 콘솔 창을 가리고 있는지 확인하거나 콘솔의 표시 계층을 조정해 보세요.

사용자 정의 명령은 어떻게 만드나요?

[ConsoleMethod] 속성을 사용하여 정적 메서드를 표시하면 해당 메서드를 콘솔 명령으로 등록할 수 있습니다. 예를 들어:

[ConsoleMethod("mycommand", "This is a custom command")]
public static void MyCustomCommand()
{
    Debug.Log("Custom command executed successfully!");
}
  

IngameDebugConsole은 가볍고 강력한 Unity 디버깅 도구로서 개발 효율성을 크게 향상시킵니다. 이 가이드에서 설명한 5분 통합 방법을 사용하면 프로젝트에서 즉시 이 도구를 활용하여 개발 과정에서 발생하는 디버깅 요구 사항을 쉽게 처리할 수 있습니다. 로그 확인, 정보 필터링, 사용자 정의 명령 실행 등 IngameDebugConsole은 Unity 개발 작업에 큰 편리함을 제공합니다.

더 고급 기능을 자세히 알아보고 싶다면 프로젝트의 README.txt 파일을 참조하세요. 이 파일에는 도구의 모든 기능과 사용법이 자세히 설명되어 있습니다.