Microsoft 빌드 엔진은 애플리케이션을 빌드하기 위한 플랫폼입니다. MSBuild라고도 하는 이 엔진은 빌드 플랫폼이 소프트웨어를 처리하고 빌드하는 방법을 제어하는 프로젝트 파일에 대한 XML 스키마를 제공합니다. Visual Studio는 MSBuild를 사용하지만 MSBuild는 Visual Studio에 의존하지 않습니다. 프로젝트 또는 솔루션 파일에서 msbuild.exe 또는 dotnet 빌드 호출하면 Visual Studio가 설치되지 않은 환경에서 제품을 오케스트레이션하고 빌드할 수 있습니다.
Visual Studio는 MSBuild를 사용하여 관리되는 프로젝트를 로드하고 빌드합니다. Visual Studio(.csproj, .vbproj, .vcxproj등)의 프로젝트 파일에는 IDE에서 프로젝트를 빌드할 때 실행되는 MSBuild XML 코드가 포함되어 있습니다. Visual Studio 프로젝트는 일반적인 개발 작업을 수행하는 데 필요한 모든 설정과 빌드 프로세스를 가져오지만 Visual Studio 내에서 또는 텍스트 편집기를 사용하여 확장하거나 수정할 수 있습니다.
MSBuild 설치
MSBuild를 설치하려면, Visual Studio가 없는 Windows 시스템에서 다운로드 페이지의 Visual Studio용 빌드 도구로 이동합니다. 이 방법으로 MSBuild를 설치하면 MSBuild.exe.
.NET Core 및 .NET 5 이상의 경우 MSBuild에 해당하는 다른 방법은 .NET SDK설치하는 것입니다. .NET 빌드 명령 dotnet build
macOS, Windows 또는 Linux의 .NET SDK에서 사용할 수 있습니다. .NET 빌드 명령 dotnet build
은 .NET Core 버전의 MSBuild.exe위에 얇게 얹혀진 래퍼입니다. MSBuild를 사용하는 .NET Core CLI(명령줄 인터페이스)사용하여 .NET Core 및 .NET 5 이상을 대상으로 하는 프로젝트를 빌드할 수 있습니다.
MSBuild 정보
Visual Studio 2022부터 Visual Studio에서 빌드할 때 64비트 버전의 MSBuild가 사용됩니다.
C++용 MSBuild에 대한 자세한 내용은 MSBuild(C++)참조하세요.
다음 예제에서는 Visual Studio IDE 대신 명령줄에서 MSBuild를 호출하여 빌드를 실행할 수 있는 경우를 보여 줍니다.
Visual Studio가 설치되지 않았습니다.
64비트 버전의 MSBuild를 사용하려고 하며 Visual Studio 2019 이하 버전을 사용하고 있습니다. 이 버전의 MSBuild는 일반적으로 불필요하지만 MSBuild에서 더 많은 메모리에 액세스할 수 있습니다.
여러 프로세스에서 빌드를 실행하려고 합니다. 그러나 IDE를 사용하여 C++ 및 C#의 프로젝트에서 동일한 결과를 얻을 수 있습니다.
빌드 시스템을 수정하려고 합니다. 예를 들어 다음 작업을 사용하도록 설정할 수 있습니다.
파일이 컴파일러에 도달하기 전에 전처리합니다.
빌드 출력을 다른 위치에 복사합니다.
빌드 출력에서 압축된 파일을 만듭니다.
사후 처리 단계를 수행합니다. 예를 들어 다른 버전으로 어셈블리에 스탬프를 찍을 수 있습니다.
Visual Studio IDE에서 코드를 작성할 수 있지만 MSBuild를 사용하여 빌드를 실행할 수 있습니다. 또 다른 대안으로, 개발 컴퓨터의 IDE에서 코드를 빌드할 수 있지만 명령줄에서 MSBuild를 실행하여 여러 개발자의 공동 작업과 소스 리포지토리에서 통합된 코드를 빌드할 수 있습니다.
메모
Azure Pipelines를 사용하여 애플리케이션을 자동으로 컴파일, 테스트 및 배포할 수 있습니다. 개발자가 코드를 체크 인할 때(예: 연속 통합 전략의 일환으로) 또는 일정(예: 야간 빌드 확인 테스트 빌드)에 따라 빌드 시스템을 자동으로 실행할 수 있습니다. Azure Pipelines는 MSBuild를 사용하여 코드를 컴파일합니다. 자세한 내용은 Azure Pipelines 참조하세요.
Windows의 MSBuild에 대한 소개 자습서는 연습: MSBuild사용을 참조하세요.
명령 프롬프트에서 MSBuild 사용
명령 프롬프트에서 MSBuild를 실행하려면 적절한 명령줄 옵션과 함께 프로젝트 파일을 MSBuild.exe전달합니다. 명령줄 옵션을 사용하면 속성을 설정하고, 특정 대상을 실행하고, 빌드 프로세스를 제어하는 다른 옵션을 설정할 수 있습니다. 예를 들어 다음 명령줄 구문을 사용하여 속성이 Configuration
설정된 MyProj.proj Debug
파일을 빌드합니다.
MSBuild.exe MyProj.proj -property:Configuration=Debug
MSBuild는 파일 확장자를 기반으로 동작을 변경하지 않지만 규칙은 "프로젝트 파일"이라고 하는 주 MSBuild 입력 파일에 대해 proj
, .csproj
또는 .vcxproj
같은 .vbproj
끝나는 확장을 사용하는 것입니다.
MSBuild 명령줄 옵션에 대한 자세한 내용은 명령줄 참조참조하세요.
중요하다
프로젝트를 다운로드하기 전에 코드의 신뢰성을 확인합니다.
.NET Core 및 .NET 5 이상의 경우 일반적으로 dotnet build
사용하여 MSBuild를 호출합니다.
을 참조하여 dotnet 빌드을 실행하세요. Visual Studio 또는 Visual Studio 빌드 도구가 아닌 .NET SDK만 설치하는 경우 dotnet build
통해서만 MSBuild가 있습니다.
명령줄 dotnet build --help
dotnet build
옵션이 아닌 관련된 명령줄 옵션을 나열하지만 MSBuild 명령줄 참조에 나열된 모든 명령줄 옵션을 계속 사용할 수 있습니다.
dotnet build
처리되지 않는 옵션은 MSBuild에 전달됩니다.
프로젝트 파일
MSBuild는 간단하고 확장 가능한 XML 기반 프로젝트 파일 형식을 사용합니다. MSBuild 프로젝트 파일 형식을 통해 개발자는 빌드할 항목과 다양한 운영 체제 및 구성을 위해 빌드되는 방법을 설명할 수 있습니다. 또한 프로젝트 파일 형식을 사용하면 개발자가 제품의 여러 프로젝트에서 빌드를 일관되게 수행할 수 있도록 별도의 파일로 팩터될 수 있는 재사용 가능한 빌드 규칙을 작성할 수 있습니다.
Visual Studio 빌드 시스템은 프로젝트 파일 자체에 프로젝트별 논리를 저장하고, .props
및 .targets
같은 확장명과 함께 가져온 MSBuild XML 파일을 사용하여 표준 빌드 논리를 정의합니다.
.props
파일은 MSBuild 속성을 정의하고 .targets
파일은 MSBuild 대상을 정의합니다. 이러한 가져오기는 Visual Studio 프로젝트 파일에 표시되는 경우도 있지만 .NET Core(및 .NET 5 이상)에서 사용되는 .NET SDK 프로젝트에서는 프로젝트 파일에 가져오기가 표시되지 않습니다. 대신 다음과 같은 SDK 참조가 표시됩니다.
<Project Sdk="Microsoft.Net.Sdk">
이를 SDK 스타일 프로젝트라고합니다. .NET SDK와 같은 SDK를 참조하는 경우 .props
및 .target
파일의 가져오기는 SDK에서 암시적으로 지정됩니다.
다음 섹션에서는 MSBuild 프로젝트 파일 형식의 몇 가지 기본 요소에 대해 설명합니다. 기본 프로젝트 파일을 만드는 방법에 대한 자습서는 연습: 처음부터 MSBuild 프로젝트 파일 만들기참조하세요.
속성
속성은 빌드를 구성하는 데 사용할 수 있는 키/값 쌍을 나타냅니다. 속성은 속성 이름이 PropertyGroup 요소의 자식인 요소를 만들어 선언됩니다. 예를 들어, 다음 코드는 BuildDir
이라는 속성을 생성하며, 그 값은 Build
입니다.
<PropertyGroup>
<BuildDir>Build</BuildDir>
</PropertyGroup>
요소에 Condition
특성을 배치하여 속성을 조건부로 정의할 수 있습니다. 조건이 true
평가되지 않는 한 조건부 요소의 내용은 무시됩니다. 다음 예제에서는 Configuration
속성이 아직 정의되지 않은 경우 정의됩니다.
<Configuration Condition=" '$(Configuration)' == '' ">DefaultValue</Configuration>
$(<PropertyName>)라는 구문을 사용하여 프로젝트 파일 전체에서 속성을 참조할 수 있습니다. 예를 들어 $(BuildDir)
및 $(Configuration)
사용하여 이전 예제의 속성을 참조할 수 있습니다.
속성에 대한 자세한 내용은 msBuild 속성 참조하세요.
항목
항목은 빌드 시스템에 입력되며 일반적으로 파일을 나타냅니다. 항목은 사용자 정의 항목 이름에 따라 항목 유형으로 그룹화됩니다. 이러한 항목 형식은 개별 항목을 사용하여 빌드 프로세스의 단계를 수행하는 작업에 대한 매개 변수로 사용할 수 있습니다.
항목은 항목 형식의 이름을 가진 요소를 ItemGroup 요소의 자식으로 만들어 프로젝트 파일에 선언됩니다. 예를 들어 다음 코드는 Compile
라는 항목 형식을 만듭니다. 여기에는 두 개의 파일이 포함됩니다.
<ItemGroup>
<Compile Include = "file1.cs"/>
<Compile Include = "file2.cs"/>
</ItemGroup>
@(<ItemType>)라는 구문을 사용하여 프로젝트 파일 전체에서 항목 형식을 참조할 수 있습니다. 예를 들어 예제의 항목 형식은 @(Compile)
사용하여 참조됩니다.
MSBuild에서 요소 및 특성 이름은 대/소문자를 구분합니다. 그러나 속성, 항목 및 메타데이터 이름은 그렇지 않습니다. 다음 예제에서는 항목 유형 Compile
, comPile
또는 기타 대/소문자 변형을 생성하고, 항목 유형에 "one.cs;two.cs" 값을 할당합니다.
<ItemGroup>
<Compile Include="one.cs" />
<Compile Include="two.cs" />
</ItemGroup>
와일드카드 문자를 사용하여 항목을 선언할 수 있으며 고급 빌드 시나리오에 대한 추가 메타데이터를 포함할 수 있습니다. 항목에 대한 자세한 내용은 항목참조하세요.
업무
작업은 MSBuild 프로젝트에서 빌드 작업을 수행하는 데 사용하는 실행 코드 단위입니다. 예를 들어 태스크는 입력 파일을 컴파일하거나 외부 도구를 실행할 수 있습니다. 작업을 다시 사용할 수 있으며 다른 프로젝트의 여러 개발자가 공유할 수 있습니다.
태스크의 실행 논리는 관리 코드로 작성되고 UsingTask 요소를 사용하여 MSBuild에 매핑됩니다. ITask 인터페이스를 구현하는 관리되는 형식을 작성하여 고유한 작업을 작성할 수 있습니다. 작업을 작성하는 방법에 대한 자세한 내용은 작업 쓰기참조하세요.
MSBuild에는 요구 사항에 맞게 수정할 수 있는 일반적인 작업이 포함되어 있습니다. 예를 들어 파일을 복사하는 복사, 디렉터리를 만드는 MakeDir, Visual C# 소스 코드 파일을 컴파일하는 Csc . 사용량 정보와 함께 사용 가능한 작업 목록은 작업 참조참조하세요.
태스크 이름이 Target 요소의 자식인 요소를 만들어 MSBuild 프로젝트 파일에서 작업이 실행됩니다. 태스크는 일반적으로 요소의 특성으로 전달되는 매개 변수를 허용합니다. MSBuild 속성과 항목은 모두 매개 변수로 사용할 수 있습니다. 예를 들어 다음 코드는 MakeDir 작업을 호출하고 이전 예제에서 선언된 BuildDir
속성의 값을 전달합니다.
<Target Name="MakeBuildDirectory">
<MakeDir Directories="$(BuildDir)" />
</Target>
작업에 대한 자세한 내용은 작업참조하세요.
대상
특정 순서로 작업을 그룹화하고 프로젝트 파일의 섹션을 빌드 프로세스에 진입점으로 노출합니다. 대상은 가독성을 높이고 확장을 허용하기 위해 논리적 섹션으로 그룹화되는 경우가 많습니다. 빌드 단계를 대상으로 분할하면 해당 코드 섹션을 모든 대상에 복사하지 않고도 다른 대상에서 빌드 프로세스의 한 부분을 호출할 수 있습니다. 예를 들어 빌드 프로세스의 여러 진입점에 참조를 빌드해야 하는 경우 참조를 빌드하는 대상을 만든 다음 필요한 모든 진입점에서 해당 대상을 실행할 수 있습니다.
대상은 Target 요소를 사용하여 프로젝트 파일에 선언됩니다. 예를 들어 다음 코드는 Compile
라는 대상을 만든 다음, 이전 예제에서 선언된 항목 목록이 있는 Csc 작업을 호출합니다.
<Target Name="Compile">
<Csc Sources="@(Compile)" />
</Target>
고급 시나리오에서는 대상을 사용하여 서로의 관계를 설명하고 종속성 분석을 수행하여 해당 대상이 up-to경우 빌드 프로세스의 전체 섹션을 건너뛸 수 있습니다. 대상에 대한 자세한 내용은 대상참조하세요.
빌드 로그
빌드 오류, 경고 및 메시지를 콘솔 또는 다른 출력 디바이스에 기록할 수 있습니다. 자세한 내용은 MSBuild 사용하여 빌드 로그 가져오기참조하세요.
Visual Studio에서 MSBuild 사용
Visual Studio는 MSBuild 프로젝트 파일 형식을 사용하여 관리되는 프로젝트에 대한 빌드 정보를 저장합니다. Visual Studio 인터페이스를 사용하여 추가되거나 변경된 프로젝트 설정은 모든 프로젝트에 대해 생성된 .*proj 파일에 반영됩니다. Visual Studio는 MSBuild의 호스트된 인스턴스를 사용하여 관리되는 프로젝트를 빌드합니다. 즉, Visual Studio 또는 명령 프롬프트에서 관리되는 프로젝트를 빌드할 수 있으며(Visual Studio가 설치되지 않은 경우에도) 결과는 동일합니다.
Visual Studio에서 MSBuild를 사용하는 방법에 대한 자습서는 연습: MSBuild사용을 참조하세요.
다중 대상 지정
Visual Studio를 사용하면 .NET 5 이상을 포함하여 여러 버전의 .NET Framework 또는 .NET Core 중 하나에서 실행할 애플리케이션을 컴파일할 수 있습니다. 예를 들어 32비트 플랫폼의 .NET Framework 3.5 SP1에서 실행되도록 애플리케이션을 컴파일할 수 있으며, 64비트 플랫폼의 .NET Framework 4.8에서 실행되도록 동일한 애플리케이션을 컴파일할 수 있습니다. 둘 이상의 프레임워크로 컴파일하는 기능은 멀티 타기팅이라고 합니다.
다음은 다중 대상 지정의 이점 중 일부입니다.
이전 버전의 .NET Framework(예: 버전 3.5 및 4.7.2)를 대상으로 하는 애플리케이션을 개발할 수 있습니다.
대상 프레임워크의 미리 정의된 하위 집합인 프레임워크 프로필대상으로 지정할 수 있습니다.
.NET Framework의 현재 버전에 대한 서비스 팩이 릴리스된 경우 대상으로 지정할 수 있습니다.
다중 대상 지정은 애플리케이션이 대상 프레임워크 및 플랫폼에서 사용할 수 있는 기능만 사용하게 합니다.
자세한 내용은 다중 대상 지정참조하세요.
빌드 사용자 지정
MSBuild는 광범위한 사용자 지정 빌드 시나리오를 지원합니다. 대부분의 기본 제공 기능은 재정의하거나 확장할 수 있습니다. 을 참조하여을 사용자 지정합니다.
프로그래밍 방식으로 MSBuild에 액세스
빌드 도구를 개발하는 경우 .NET 애플리케이션에서 프로그래밍 방식으로 MSBuild를 호출할 수 있습니다. MSBuild API를 사용하여 복잡한 빌드 시스템의 모든 측면을 제어할 수 있습니다. MSBuild는 이러한 용도로 .NET 애플리케이션에서 사용할 수 있는 전체 API(Microsoft.Build 네임스페이스)가 포함된 NuGet 패키지를 제공합니다. 을(를) 참조하여 MSBuild API을(를) 사용하세요.
MSBuild는 오픈 소스입니다.
MSBuild는 MSBuild GitHub 리포지토리사용자 기여를 허용하는 오픈 소스 프로젝트입니다.
참고 사항
타이틀 | 묘사 |
---|---|
안내: 처음부터 MSBuild 프로젝트 파일 만들기 | 텍스트 편집기만 사용하여 기본 프로젝트 파일을 증분 방식으로 만드는 방법을 보여 줍니다. |
방법 안내: MSBuild을 사용하기 | MSBuild의 구성 요소를 소개하고 Visual Studio IDE를 닫지 않고 MSBuild 프로젝트를 작성, 조작 및 디버그하는 방법을 보여 줍니다. |
MSBuild 개념 | MSBuild의 네 가지 구성 요소인 속성, 항목, 대상 및 작업을 표시합니다. |
항목 | MSBuild 파일 형식의 일반적인 개념과 조각이 어떻게 결합되는지 설명합니다. |
MSBuild 속성 | 속성과 속성 컬렉션을 소개합니다. 속성은 빌드를 구성하는 데 사용할 수 있는 키/값 쌍입니다. |
대상 | 특정 순서로 작업을 그룹화하고 명령줄에서 빌드 프로세스의 섹션을 호출하도록 설정하는 방법을 설명합니다. |
작업 | MSBuild에서 원자성 빌드 작업을 수행하는 데 사용할 수 있는 실행 코드 단위를 만드는 방법을 보여 줍니다. |
조건 | MSBuild 요소에서 Condition 특성을 사용하는 방법에 대해 설명합니다. |
일괄 처리 | MSBuild가 작업 및 대상에서 실행하기 위해 메타데이터별로 항목 목록을 분류하는 방법을 설명합니다. |
다중 대상 지정 | 여러 .NET 버전 및/또는 여러 플랫폼을 대상으로 지정하는 방법을 보여 줍니다. |
빌드 로그 가져오기 | 빌드 이벤트, 메시지 및 오류를 기록하는 방법을 설명합니다. |
MSBuild에서 프로젝트 빌드하는 방법 | MSBuild 내에서 사용되는 내부 빌드 프로세스에 대해 설명합니다. |
보안 MSBuild 사용 모범 사례 | MSBuild를 사용하여 빌드를 구성하고 실행하는 모범 사례를 설명합니다. |
코드 생성 대한 사용자 지정 작업 만들기 | 코드 예제를 사용하여 사용자 지정 작업을 만드는 방법을 보여줍니다. |
MSBuild를 사용하여 REST API 클라이언트 생성 | 코드 예제를 사용하여 REST API 클라이언트 생성을 처리하도록 빌드를 확장하는 방법을 보여 줍니다. |
추가 리소스 | MSBuild에 대한 자세한 내용은 커뮤니티 및 지원 리소스를 나열합니다. |
참조
MSBuild 참조
참조 정보를 포함하는 항목에 대한 링크입니다.용어집
일반적인 MSBuild 용어를 정의합니다.