콘솔 창

콘솔 창에는 오류, 경고, 에디터가 생성하는 기타 메시지가 표시됩니다. 이러한 오류와 경고는 스크립트 컴파일 오류와 같은 프로젝트의 문제를 찾는 데 도움이 됩니다. 또한 누락된 메타 파일을 교체하는 것과 같이 에디터가 자동으로 수행한 행동에 대해 경고합니다. 이러한 행동은 프로젝트의 다른 곳에서 문제를 일으킬 수도 있습니다.

프로젝트를 디버그하는 데 도움이 되는 디버그 클래스를 사용하여 콘솔에 고유한 메시지를 출력할 수 있습니다. 예를 들어 스크립트의 특정 지점에서 변수 값을 출력하여 변수가 어떻게 변경되는지 확인할 수 있습니다.

이 페이지에서는 콘솔 창으로 작업할 때 사용할 수 있는 옵션과 특정 키워드를 검색하여 메시지를 필터링하는 방법에 대해 설명합니다.

콘솔 창 인터페이스

콘솔 창을 열려면 Unity 메인 메뉴에서 Window > General > Console로 이동합니다.

A. 콘솔 툴바에는 메시지를 표시하는 방법을 제어하기 위한 옵션과 메시지를 검색 및 필터링하기 위한 옵션이 있습니다.

B. 콘솔 창 메뉴에는 로그 파일을 열고, 리스트에 표시되는 각 메시지의 양을 제어하고, 스택 추적 옵션을 설정하기 위한 옵션이 있습니다.

C. 콘솔 리스트는 기록된 각 메시지에 대한 항목을 표시합니다. 상세 영역에 전체 텍스트를 표시할 메시지를 선택하십시오. 여기에서 표시할 각 메시지의 줄 수를 선택할 수 있습니다. 아래의 줄 수 조절을 참조하십시오.

D. 상세 영역에는 선택한 메시지의 전체 텍스트가 표시됩니다. 스택 추적이 활성화된 경우에는 상세 영역에 코드 파일의 특정 라인에 대한 레퍼런스가 클릭 가능한 링크로 표시됩니다.

콘솔 툴바 옵션

콘솔 창의 툴바에는 메시지를 표시하는 방법을 제어하기 위한 옵션과 메시지를 검색 및 필터링하기 위한 옵션이 있습니다.

옵션		기능
Clear		컴파일러 오류를 제외하고 코드가 생성한 모든 메시지를 지웁니다.br/> 지우기 옵션이 있는 드롭다운 메뉴를 엽니다.
	Clear On Play	플레이 모드를 실행할 때 콘솔 창의 내용을 자동으로 지웁니다.
	Clear on Build	프로젝트를 빌드할 때 콘솔의 내용을 지웁니다.
	Clear on Recompile	프로젝트를 다시 컴파일할 때 콘솔의 내용을 지웁니다.
Collapse		반복해서 발생하는 오류 메시지를 모두 표시하는 대신 첫 번째 인스턴스만 Display. 각 프레임 업데이트마다 발생하는 null 레퍼런스와 같은 런타임 오류를 간결하게 보고 싶을 때 매우 유용합니다.
Error Pause		Debug.LogError를 스크립트에서 호출할 때마다 재생을 일시 정지합니다. 실행 중인 특정 시점에서 재생을 멈추고 씬을 검사하고 싶을 때 사용합니다. 스크립트에서 Debug.Log를 호출할 때는 재생을 일시 정지하지 않습니다.
[Attach-to-Player]		원격 기기에서 실행 중인 개발 빌드에 연결하고 해당 플레이어 로그를 콘솔에 표시하기 위한 옵션이 들어 있는 드롭다운 메뉴를 엽니다. 이 옵션에는 타겟 개발 빌드(콘솔 창에 표시되는 로그의 빌드)의 이름이 레이블로 지정되어 있습니다. 콘솔이 원격 빌드에 연결되지 않으면 Editor라는 레이블이 지정됩니다. 이는 로컬 Unity 에디터의 콘솔 창에 표시된 로그라는 의미입니다.
	Player Logging	콘솔이 원격 개발 빌드에 연결되면 해당 빌드에 대한 플레이어 로깅이 활성화됩니다. 이 옵션을 비활성화하면 로깅이 일시 중단되지만, 콘솔은 타겟 빌드에 계속 연결된 상태를 유지합니다. 또한 이 옵션을 비활성화하면 이 드롭다운 메뉴의 나머지 옵션을 숨깁니다. Player Logging 아래에 나열된 빌드를 선택하여 해당 로그를 콘솔 창에 표시합니다.
	에디터	콘솔이 원격 ** 개발 빌드에 연결되면 이 옵션을 선택하여 원격 빌드의 로그 대신 로컬 Unity 플레이어의 로그를 표시합니다. | | | <Enter IP> | Enter Player IP** 다이얼로그를 엽니다. 여기에서 원격 기기의 개발 빌드에 대한 IP 주소를 지정할 수 있습니다. 빌드에 연결하려면 다이얼로그에서 Connect를 선택하고 드롭다운 메뉴의 하단에 있는 개발 빌드 리스트에 추가합니다.
	[DEVELOPMENT BUILDS]	이용 가능한 개발 빌드를 나열합니다. 여기에는 자동으로 감지된 빌드와 Enter IP 옵션을 통해 추가하는 빌드가 포함됩니다.

콘솔 출력 검색 및 필터링

콘솔 검색창에서 특정 키워드에 대한 콘솔 메시지를 검색할 수 있습니다. 검색어를 입력하면 콘솔이 메시지를 필터링하여 일치하는 텍스트가 포함된 결과만 표시합니다. 콘솔은 메시지 텍스트의 첫 번째 매치가 메시지의 가시 범위 내에 있을 때만 이를 강조하여 표시합니다(아래의 줄 수 조절 참조).

숫자, 특수 문자 등을 비롯하여 콘솔 메시지에 표시되는 모든 것을 검색할 수 있습니다. 예를 들어 콘솔이 메시지를 기록한 시간을 검색할 수 있습니다.

검색은 검색창에 입력된 검색어와 정확히 일치하는 매치를 찾습니다. 한 번에 두 개의 다른 검색어를 검색하거나 일반 검색 엔진 연산자를 사용할 수 없습니다.

또한 타입별로 콘솔 메시지를 필터링할 수도 있습니다. 검색창 옆에 있는 버튼을 클릭하여 토글할 수 있습니다.

버튼	기능
Messages switch	콘솔의 메시지 수를 표시합니다. 클릭하면 메시지를 표시하거나 숨깁니다.
Warnings switch	콘솔의 경고 수를 표시합니다. 클릭하면 경고를 표시하거나 숨깁니다.
Errors switch	콘솔의 오류 수를 표시합니다. 클릭하면 오류를 표시하거나 숨깁니다.

줄 수 조절

각 콘솔 항목의 최대 줄 수는 10줄입니다.

리스트에 표시되는 각 항목의 줄 수를 제어하려면 Console 메뉴 버튼을 클릭한 후 Log Entry > [X] Lines를 선택하십시오. 여기서 [X]는 각 항목에 대해 표시할 줄 수입니다.

줄 수가 많으면 각 항목당 더 많은 텍스트를 표시하지만, 한 번에 표시되는 항목 수가 줄어듭니다. 줄 수는 콘솔 검색 기능에는 영향을 주지 않습니다. 콘솔 검색 기능은 항상 전체 메시지 텍스트를 검색합니다. 일치하는 텍스트가 숨겨진 줄에 있으면 해당 메시지를 결과로 반환하지만 일치하는 텍스트를 노출하거나 강조 표시하기 위해 확장하지는 않습니다. 전체 메시지 텍스트는 상세 영역에서 볼 수 있으며, 일치하는 텍스트는 상세 영역에서 강조 표시되지 않습니다.

스택 추적 로깅

Unity 콘솔 메시지와 로그 파일에는 상세한 스택 추적 정보를 포함할 수 있습니다. 스택 추적 로깅 설정을 통해 스택 추적 정보의 양을 제어할 수 있습니다.

콘솔에서 로그 파일 열기

콘솔 창에 기록하는 모든 Unity 또는 코드는 로그 파일에도 기록됩니다. 콘솔 창 메뉴에서 로그 파일을 열 수 있습니다. Open Player Log 또는 Open Editor Log를 선택합니다.