방법: 동일한 소스 파일을 다른 옵션을 사용하여 빌드
자주 프로젝트를 빌드할 때 동일한 구성 요소를를 각기 다른 빌드 옵션을 컴파일합니다. 예를 들어, 기호 정보를 사용하여 디버그 빌드를 만들거나 기호 정보를 사용하지 않고 최적화가 설정된 릴리스 빌드를 만들 수 있습니다. 또는 x86이나 x64 같은 특정 플랫폼에서 실행할 프로젝트를 빌드할 수도 있습니다. 이 모든 경우 대부분의 빌드 옵션은 동일하고, 빌드 구성을 제어하기 위해 몇 가지 옵션만 변경됩니다. MSBuild에서는 속성과 조건을 사용하여 다양한 빌드 구성을 만듭니다.
속성을 사용하여 프로젝트 수정
Property 요소는 임시 디렉터리의 위치처럼 프로젝트 파일에서 여러 번 참조되는 변수 또는 디버그 빌드와 릴리스 빌드처럼 여러 구성에서 사용되는 속성의 값을 설정하는 변수를 정의합니다. 속성에 대한 자세한 내용은 MSBuild 속성을 참조하십시오.
프로젝트 파일을 변경하지 않아도 속성을 사용하여 빌드의 구성을 변경할 수 있습니다. Property 요소와 PropertyGroup 요소의 Condition 특성을 사용하여 속성의 값을 변경할 수 있습니다. MSBuild 조건에 대한 자세한 내용은 MSBuild 조건을 참조하십시오.
다른 속성을 기반으로 속성 그룹을 설정하려면
다음과 같이 PropertyGroup 요소에 Condition 특성을 사용합니다.
<PropertyGroup Condition="'$(Flavor)'=='DEBUG'"> <DebugType>full</DebugType> <Optimize>no</Optimize> </PropertyGroup>
다른 속성을 기반으로 속성을 정의하려면
다음과 같이 Property 요소에 Condition 특성을 사용합니다.
<DebugType Condition="'$(Flavor)'=='DEBUG'">full</DebugType>
명령줄에서 속성 지정
여러 구성을 사용하도록 프로젝트 파일을 작성한 경우 프로젝트를 빌드할 때마다 해당 구성을 변경할 수 있어야 합니다. MSBuild에서는 이러한 기능을 제공하기 위해 /property 또는 /p 스위치를 사용하여 속성을 명령줄에 지정하도록 합니다.
명령줄에서 프로젝트 속성을 설정하려면
속성 및 속성 값과 함께 /property 스위치를 사용합니다. 예를 들면 다음과 같습니다.
msbuild file.proj /property:Flavor=Debug-또는-
Msbuild file.proj /p:Flavor=Debug
명령줄에서 프로젝트 속성을 두 개 이상 지정하려면
속성 및 속성 값과 함께 /property 또는 /p 스위치를 여러 번 사용하거나 하나의 /property 또는 /p 스위치에 여러 속성을 세미콜론(;)으로 구분하여 사용합니다. 예를 들면 다음과 같습니다.
msbuild file.proj /p:Flavor=Debug;Platform=x86-또는-
msbuild file.proj /p:Flavor=Debug /p:Platform=x86
환경 변수 역시 속성으로 처리되며 MSBuild에 의해 자동으로 통합됩니다. 환경 변수 사용에 대한 자세한 내용은 방법: 빌드 시 환경 변수 사용을 참조하십시오.
명령줄에 지정된 속성 값은 동일한 속성에 대해 프로젝트 파일에 설정된 모든 값보다 우선하고, 프로젝트 파일의 값은 환경 변수의 값보다 우선합니다.
사용 하 여이 동작을 변경할 수 있는 TreatAsLocalProperty 프로젝트 태그에서 특성. 해당 특성에 나열 된 속성 이름에 값은 프로젝트 파일에서 명령줄에 지정 된 속성 값 보다를 우선 하지 않습니다. 예를 들어가이 항목의 뒷부분에서 찾을 수 있습니다.
예제
다음 코드 예제에서는 "Hello World" 프로젝트에는 디버그 빌드와 릴리스 빌드를 만드는 데 사용할 수 있는 두 개의 새 속성 그룹이 포함 되어 있습니다.
이 프로젝트의 디버그 버전을 빌드하려면 다음을 입력합니다.
msbuild consolehwcs1.proj /p:flavor=debug
이 프로젝트의 일반 정품 버전을 빌드하려면 다음을 입력합니다.
msbuild consolehwcs1.proj /p:flavor=retail
<Project DefaultTargets = "Compile"
xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
<!-- Sets the default flavor of an environment variable called
Flavor is not set or specified on the command line -->
<PropertyGroup>
<Flavor Condition="'$(Flavor)'==''">DEBUG</Flavor>
</PropertyGroup>
<!-- Define the DEBUG settings -->
<PropertyGroup Condition="'$(Flavor)'=='DEBUG'">
<DebugType>full</DebugType>
<Optimize>no</Optimize>
</PropertyGroup>
<!-- Define the RETAIL settings -->
<PropertyGroup Condition="'$(Flavor)'=='RETAIL'">
<DebugType>pdbonly</DebugType>
<Optimize>yes</Optimize>
</PropertyGroup>
<!-- Set the application name as a property -->
<PropertyGroup>
<appname>HelloWorldCS</appname>
</PropertyGroup>
<!-- Specify the inputs by type and file name -->
<ItemGroup>
<CSFile Include = "consolehwcs1.cs"/>
</ItemGroup>
<Target Name = "Compile">
<!-- Run the Visual C# compilation using input files
of type CSFile -->
<CSC Sources = "@(CSFile)"
DebugType="$(DebugType)"
Optimize="$(Optimize)"
OutputAssembly="$(appname).exe" >
<!-- Set the OutputAssembly attribute of the CSC
task to the name of the executable file that is
created -->
<Output TaskParameter="OutputAssembly"
ItemName = "EXEFile" />
</CSC>
<!-- Log the file name of the output file -->
<Message Text="The output file is @(EXEFile)"/>
</Target>
</Project>
다음 예제에서는 사용 방법을 보여 줍니다 있는 TreatAsLocalProperty 특성입니다. Color 속성의 값은 Blue 프로젝트 파일에서 및 Green 명령줄에서. 와 TreatAsLocalProperty="Color" 명령줄 속성 프로젝트 태그에 (Green) 프로젝트 파일에 정의 된 속성을 재정의 하지 않는 (Blue).
프로젝트를 빌드하려면 다음 명령을 입력 하십시오.
msbuild colortest.proj /t:go /property:Color=Green
<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003"
ToolsVersion="4.0" TreatAsLocalProperty="Color">
<PropertyGroup>
<Color>Blue</Color>
</PropertyGroup>
<Target Name="go">
<Message Text="Color: $(Color)" />
</Target>
</Project>
<!--
Output with TreatAsLocalProperty="Color" in project tag:
Color: Blue
Output without TreatAsLocalProperty="Color" in project tag:
Color: Green
-->