콘솔 창
콘솔 창은 에디터에서 생성되는 오류, 경고, 기타 메시지를 표시합니다. 이러한 오류와 경고는 스크립트 컴파일 오류와 같은 프로젝트의 문제를 찾는 데 도움이 됩니다. 또한 누락된 메타 파일을 교체하는 등 에디터가 자동으로 수행하는 작업에 대해 경고합니다. 이는 프로젝트의 다른 곳에서 문제를 유발할 수 있습니다.
프로젝트 디버깅을 돕기 위해 Debug 클래스를 사용하여 자체 메시지를 콘솔에 출력할 수 있습니다. 예를 들어 스크립트의 특정 지점에서 변수 값을 출력하여 변수가 어떻게 변하는지 확인할 수 있습니다.
이 페이지에서는 콘솔 창으로 작업할 때 사용할 수 있는 옵션과 특정 키워드를 검색하여 메시지를 필터링하는 방법에 대해 설명합니다.
콘솔 창 인터페이스
콘솔 창을 열려면 Unity 메인 메뉴에서 Window > General > Console로 이동합니다.
A. 콘솔 툴바에는 메시지를 표시하는 방법을 제어하기 위한 옵션과 메시지를 검색 및 필터링하기 위한 옵션이 있습니다.
B. 콘솔 창 메뉴에는 로그 파일을 열고, 목록에 표시되는 각 메시지의 양을 제어하고, 스택 추적 옵션을 설정하기 위한 옵션이 있습니다.
C. 콘솔 목록에는 각 로깅된 메시지 항목이 표시됩니다. 전체 텍스트를 세부 정보 영역에 표시할 메시지를 선택합니다. 여기에서 표시할 각 메시지의 줄 수를 선택할 수 있습니다. 아래의 줄 수 조절을 참조하십시오.
D. 세부 정보 영역에는 선택한 메시지의 전체 텍스트가 표시됩니다. 스택 추적이 활성화된 경우에는 세부 정보 영역에 코드 파일의 특정 라인에 대한 레퍼런스가 클릭 가능한 링크로 표시됩니다.
콘솔 툴바 옵션
콘솔 창의 툴바에는 메시지를 표시하는 방법을 제어하기 위한 옵션과 메시지를 검색 및 필터링하기 위한 옵션이 있습니다.
| 옵션: | 기능: | |
|---|---|---|
| Clear | 컴파일러 오류를 제외하고 코드가 생성한 모든 메시지를 지웁니다. 지우기 옵션이 있는 드롭다운 메뉴를 엽니다. |
|
| Clear On Play | 플레이 모드를 실행할 때 콘솔 창의 내용을 자동으로 지웁니다. | |
| Clear on Build | 프로젝트를 빌드할 때 콘솔의 내용을 지웁니다. | |
| Clear on Recompile | 프로젝트를 다시 컴파일할 때 콘솔의 내용을 지웁니다. | |
| Collapse | 반복되는 오류 메시지의 첫 번째 인스턴스만 표시합니다. 각 프레임 업데이트마다 발생하는 null 레퍼런스와 같은 런타임 오류에 유용합니다. |
|
| Error Pause | 스크립트에서 Debug.LogError를 호출할 때마다 재생을 일시 중지합니다. 실행 시 특정 지점에서 재생을 고정하고 씬을 검사하는 데 사용합니다. 이 옵션은 스크립트에서 Debug.Log를 호출할 때 재생을 일시 중지하지 않습니다. |
|
| [Attach-to-Player] | 원격 기기에서 실행 중인 개발 빌드에 연결하고 해당 플레이어 로그를 콘솔에 표시하는 옵션이 있는 드롭다운 메뉴를 엽니다. 이 옵션은 타겟 개발 빌드(콘솔 창에 표시되는 로그의 빌드)의 이름으로 레이블이 지정됩니다. 콘솔이 원격 빌드에 연결되어 있지 않으면 콘솔 창에 표시된 로그가 로컬 Unity 에디터의 로그임을 표시하기 위해 Editor라고 레이블이 지정됩니다. |
|
| Player Logging | 콘솔이 원격 개발 빌드에 연결되어 있으면 빌드에 대한 플레이어 로깅이 활성화됩니다. 이 옵션을 비활성화하면 로깅이 일시 중지되지만 콘솔은 타겟 빌드에 계속 연결됩니다. 이 옵션을 비활성화하면 이 드롭다운 메뉴의 나머지 옵션도 숨겨집니다. 콘솔 창에 로그를 표시하려면 Player Logging 아래에 나열된 빌드를 선택합니다. |
|
| Editor | 콘솔이 원격 개발 빌드에 연결되면 이 옵션을 선택하여 원격 빌드의 로그 대신 로컬 Unity 플레이어의 로그를 표시하십시오. | |
<Enter IP> |
원격 기기에서 개발 빌드의 IP 주소를 지정할 수 있는 Enter Player IP 다이얼로그를 엽니다. 빌드에 연결하려면 다이얼로그에서 Connect를 선택하고 드롭다운 메뉴 하단의 개발 빌드 목록에 추가합니다. |
|
| [DEVELOPMENT BUILDS] | 사용 가능한 개발 빌드를 나열합니다. 여기에는 자동으로 감지된 빌드와 Enter IP 옵션을 통해 추가하는 빌드가 포함됩니다. |
콘솔 출력 검색 및 필터링
콘솔 검색창에서 특정 키워드에 대한 콘솔 메시지를 검색할 수 있습니다. 검색어를 입력하면 콘솔이 메시지를 필터링하여 일치하는 텍스트가 포함된 메시지만 표시합니다. 콘솔은 메시지 텍스트의 첫 번째 일치 항목만 강조 표시하며, 메시지가 보이는 부분에 있는 경우에만 강조 표시합니다(아래의 라인 수 조절 참조).
숫자, 특수 문자 등을 비롯하여 콘솔 메시지에 표시되는 모든 것을 검색할 수 있습니다. 예를 들어 콘솔이 메시지를 기록한 시간을 검색할 수 있습니다.
검색은 검색창에 입력한 항목과 정확히 일치하는 항목을 검색합니다. 두 개의 서로 다른 용어를 한 번에 검색하거나 일반적인 검색 엔진 연산자를 사용할 수는 없습니다.
콘솔 메시지를 유형별로 필터링할 수도 있습니다. 검색창 옆에 있는 버튼을 클릭하여 토글합니다.
| 버튼 | 기능 |
|---|---|
 Messages switch |
콘솔의 메시지 수를 표시합니다. 클릭하면 메시지를 표시하거나 숨길 수 있습니다. |
 Warnings switch |
콘솔의 경고 수를 표시합니다. 클릭하면 경고를 표시하거나 숨길 수 있습니다. |
 Errors switch |
콘솔의 오류 수를 표시합니다. 클릭하면 오류를 표시하거나 숨길 수 있습니다. |
줄 수 조절
각 콘솔 항목의 최대 줄 수는 10줄입니다.
목록에 표시되는 각 항목의 줄 수를 제어하려면 콘솔 메뉴 버튼을 클릭한 후 Log Entry > [X] Lines를 선택하십시오. 여기서 [X]는 각 항목에 대해 표시할 줄 수입니다.
줄 수가 많으면 각 항목당 더 많은 텍스트를 표시하지만, 한 번에 표시되는 항목 수가 줄어듭니다. 줄 수는 항상 전체 메시지 텍스트를 검색하는 콘솔 검색 함수에 영향을 주지 않습니다. 일치하는 텍스트가 숨겨진 줄에 있는 경우 검색 결과에 메시지가 반환되지만, 일치하는 텍스트를 표시하거나 강조 표시하기 위해 확장되지는 않습니다. 세부 정보 영역에서 전체 메시지 텍스트를 볼 수 있지만, 해당 텍스트가 강조 표시되지는 않습니다.
스택 추적 로깅
Unity 콘솔 메시지와 로그 파일에는 자세한 스택 추적 정보가 포함될 수 있습니다. 스택 추적 로깅 설정을 사용하여 스택 추적 정보의 양을 제어할 수 있습니다.
콘솔에서 로그 파일 열기
Unity 또는 코드가 콘솔 창에 작성하는 모든 내용도 로그 파일에 기록됩니다. 콘솔 창 메뉴에서 로그 파일을 열 수 있습니다. Open Player Log 또는 Open Editor Log를 선택합니다.