Visual Studio IDE(Interactive Development Environment)에서 프로젝트를 빌드한 후 Visual Studio 출력 창에서 빌드에 대한 기록된 정보를 볼 수 있습니다. 출력 데이터는 Visual Studio 및 기타 편집기에서 볼 수 있는 로그 파일에 저장할 수 있습니다.
로그는 빌드의 문제를 해결하는 데 도움이 될 수 있습니다. 모든 빌드 도구에 사용되는 정확한 명령줄을 찾고 전체 빌드 프로세스에 대한 전체 진단 데이터를 가져올 수 있습니다. Visual Studio는 빌드 출력 및 빌드 로그 파일에 표시할 정보의 종류를 지정하는 옵션을 제공합니다.
이 문서에서는 Visual Studio에서 빌드 로그 파일을 생성, 구성 및 보는 방법을 설명합니다.
빌드 로그 파일 생성 및 보기
다음 절차를 사용하여 시나리오에 대한 빌드 로그 파일을 생성하고 봅니다.
C++ 프로젝트:
Visual Studio는 프로젝트를 빌드할 때 로그 파일을 저장합니다. 로그 파일의 일반적인 위치에는 Release\<ProjectName>.log, Debug\<ProjectName>.log및 <ProjectName>.txt포함됩니다. 모든 파일 위치는 프로젝트 루트 폴더를 기준으로 하며 특정 구성을 기반으로 합니다.
Windows 탐색기 또는 파일 탐색기 사용하여 로그 파일을 찾습니다.
기본 설정 편집기에서 로그 파일을 엽니다.
.NET 프로젝트:
.NET 프로젝트의 경우 로그 파일을 저장하도록 Visual Studio에 지시합니다.
Visual Studio에서 빌드>솔루션 빌드를선택합니다.
출력 창에서 텍스트를 선택하고 Ctrl+S 바로 가기 키를 사용합니다.
Visual Studio에서 빌드 출력을 저장할 위치를 묻는 메시지를 표시합니다. 그런 다음 Visual Studio 또는 다른 편집기에서 해당 위치에서 로그 파일을 열 수 있습니다.
MSBuild :
-fileLogger(-fl) 명령줄 옵션을 사용하여 명령줄에서 직접 MSBuild를 실행하여 빌드 로그를 생성할 수 있습니다. 자세한 내용은 MSBuild 사용하여 빌드 로그 가져오기참조하세요.MSBuild를 사용하면 이진 로그(
-binaryLogger또는-bl명령줄 옵션)를 생성할 수도 있습니다. 구조적 로그 뷰어이진 로그를 볼 수 있습니다. 구조화된 로그 뷰어는 복잡한 빌드 프로세스를 더 쉽게 이해할 수 있는 보다 풍부한 UI를 제공합니다.
환경 변수를 설정하여 파일 시스템에 이진 로그를 쓰도록 Visual Studio를 구성할 수 있습니다.
MSBuildDebugEngine을 1로 설정하고 MSBUILDDEBUGPATH를 빌드 로그 파일의 원하는 위치로 설정합니다. 변수는 Visual Studio가 시작되는 환경에서 설정해야 합니다. 이러한 설정은 모든 Visual Studio 빌드에 영향을 주므로 빌드의 특정 호출에 대한 로그만 원하는 경우에는 좋지 않을 수 있습니다.
.NET 프로젝트의 빌드 로깅에 대한 고급 UI 지원을 위해 Project System Tools 확장설치하는 것이 좋습니다. 확장을 설치하면 UI에서 이진 로깅을 켜고 끌 수 있으며 로그 목록에서 선택할 수 있습니다. 그러나 Visual Studio 빌드 시스템과 통합되는 방식 때문에 로그는 출력 창 또는 환경 변수에서 가져오는 로그와 약간 다릅니다.
빌드 로그에 대한 데이터 상세 수준 지정
빌드 로그 파일에 포함할 정보의 양을 지정할 수 있습니다. 로그 파일 열의 데이터 양은 로거의 세부 정보 수준 로 측정됩니다. 로그 파일 행 수는 메시지가수집된 것을 나타냅니다. 로그 수준(열 값)은 기록된 메시지 유형(행 값)에 영향을 줍니다. Quiet 설정은 빌드 출력에서 로그 생성을 최소화합니다. 진단 가장 자세한 설정이며 가능한 모든 데이터를 사용하여 로그 파일을 생성합니다.
다음 표에서는 로거 세부 정보를 기반으로 수집되는 메시지 유형을 보여 줍니다.
| 메시지 유형/세부 정보 표시 | 조용한 | 최소 | 보통 | 상세한 | 진단 |
|---|---|---|---|---|---|
| 오류 | ✅ | ✅ | ✅ | ✅ | ✅ |
| 경고 | ✅ | ✅ | ✅ | ✅ | ✅ |
| 중요도가 높은 메시지 | ✅ | ✅ | ✅ | ✅ | |
| 일반 중요도 메시지 | ✅ | ✅ | ✅ | ||
| 중요도가 낮은 메시지 | ✅ | ✅ | |||
| 기타 MSBuild 엔진 정보 | ✅ |
다음 단계를 통해 로거의 자세히 보기 수준 설정을 구성할 수 있습니다.
Visual Studio에서 도구>옵션 선택하여 옵션 대화 상자를 엽니다.
대화 상자에서 프로젝트 및 솔루션 섹션을 확장하고 빌드 및 실행 탭을 선택합니다.
MSBuild 프로젝트 빌드 출력 수위 드롭다운 목록을 사용하여 빌드 출력 기본 설정을 선택합니다.
MSBuild 프로젝트 빌드 로그 파일 상세 수준 드롭다운 목록을 사용하여 로거의 상세 수준 기본 설정을 선택합니다.
팁
컴파일러 및 기타 도구에 사용되는 명령줄을 보려면 최소 자세한 수준의 정보 표시 수준을 선택하세요.
변경 내용을 적용하려면 확인선택합니다.
중요하다
출력 창에서 변경 내용을 적용하려면 프로젝트를 다시 빌드해야 합니다. C++ 프로젝트의 경우 프로젝트를 다시 빌드하면 변경 내용이 <ProjectName>.txt 파일에 반영됩니다.
자세한 내용은 옵션 대화 상자, 프로젝트 및 솔루션, 빌드 및 실행 및 LoggerVerbosity참조하세요.
큰 로그 파일에 이진 로그 사용
이진 로그는 큰 로그에서 정보를 더 쉽게 찾을 수 있는 보다 풍부한 로그 검색 환경을 제공하는 .NET 프로젝트의 선택적 기능입니다. 이진 로그를 사용하려면 Project System Tools설치합니다. 자세한 내용은 https://msbuildlog.com 및 이진 로그참조하세요.
이진 로그는 큰 로그에서 정보를 더 쉽게 찾을 수 있는 보다 풍부한 로그 검색 환경을 제공하는 .NET 프로젝트의 선택적 기능입니다. 이진 로그를 사용하려면 Project System Tools 2022설치합니다. 자세한 내용은 https://msbuildlog.com 및 이진 로그참조하세요.
관련 콘텐츠
- Visual Studio 프로젝트 및 솔루션 빌드 및 정리
- 컴파일 및 빌드
- MSBuild 사용하여 빌드 로그 가져오기