MSBuild 작업

아티클
06/19/2023

다른 MSBuild 프로젝트에서 MSBuild 프로젝트를 빌드합니다.

매개 변수

다음 표에서는 MSBuild 작업의 매개 변수에 대해 설명합니다.

매개 변수	Description
`BuildInParallel`	선택적 `Boolean` 매개 변수입니다. `true`인 경우 `Projects` 매개 변수에 지정된 프로젝트가 가능한 경우 병렬로 빌드됩니다. 기본값은 `false`입니다.
`Projects`	필수 ITaskItem`[]` 매개 변수입니다. 빌드할 프로젝트 파일을 지정합니다.
`Properties`	선택적 `String` 매개 변수입니다. 자식 프로젝트에 전역 속성으로 적용할 속성 이름/값 쌍의 세미콜론으로 구분된 목록입니다. 이 매개 변수는 지정하는 경우 MSBuild.exe를 사용하여 빌드할 때 -property 스위치가 포함된 속성을 설정하는 것과 동일한 기능을 제공합니다. 예시: `Properties="Configuration=Debug;Optimize=$(Optimize)"` `Properties` 매개 변수를 통해 프로젝트에 속성을 전달하면 MSBuild에서는 프로젝트 파일이 이미 로드되었더라도 프로젝트의 새 인스턴스를 만들 수 있습니다. MSBuild에서는 지정된 프로젝트 경로의 단일 프로젝트 인스턴스와 고유한 전역 속성 집합을 만듭니다. 예를 들어 이 동작을 사용하여 myproject.proj를 호출하는 여러 MSBuild 작업을 만들 수 있으며, Configuration=Release를 지정하여 myproject.proj의 단일 인스턴스를 가져옵니다(작업에서 고유한 속성을 지정하지 않은 경우). MSBuild에 아직 표시되지 않은 속성을 지정하면 MSBuild에서는 프로젝트의 다른 인스턴스와 병렬로 빌드될 수 있는 프로젝트의 새 인스턴스를 만듭니다. 예를 들어 릴리스 구성을 디버그 구성과 동시에 빌드할 수 있습니다.
`RebaseOutputs`	선택적 `Boolean` 매개 변수입니다. `true`인 경우 빌드한 프로젝트의 대상 출력 항목 상대 경로가 호출 프로젝트를 기준으로 조정됩니다. 기본값은 `false`입니다.
`RemoveProperties`	선택적 `String` 매개 변수입니다. 제거할 전역 속성의 집합을 지정합니다.
`RunEachTargetSeparately`	선택적 `Boolean` 매개 변수입니다. `true`인 경우 MSBuild 작업이 MSBuild에 전달된 목록의 각 대상을 동시에 호출하는 대신 한 번에 하나씩 호출합니다. 이 매개 변수를 `true`로 설정하면 이전에 호출된 대상에 오류가 발생하더라도 후속 대상이 호출됩니다. 그렇지 않은 경우에는 빌드 오류로 인해 모든 후속 대상의 호출이 중지됩니다. 기본값은 `false`입니다.
`SkipNonexistentProjects`	선택적 `Boolean` 매개 변수입니다. `true`인 경우 디스크에 없는 프로젝트 파일을 건너뜁니다. 그렇지 않은 경우 이러한 프로젝트로 인해 오류가 발생합니다. 기본값은 `false`입니다.
`SkipNonexistentTargets`	선택적 `Boolean` 매개 변수입니다. `true`이면 존재하지만 명명된 `Targets`를 포함하지 않는 프로젝트 파일을 건너뜁니다. 그렇지 않은 경우 이러한 프로젝트로 인해 오류가 발생합니다. 기본값은 `false`입니다. MSBuild 15.5에서 도입되었습니다.
`StopOnFirstFailure`	선택적 `Boolean` 매개 변수입니다. `true`인 경우 프로젝트 중 하나를 빌드하지 못하면 더 이상 프로젝트를 빌드하지 않습니다. 현재 여러 프로세서를 사용하여 병렬로 빌드할 때는 이 매개 변수가 지원되지 않습니다.
`TargetAndPropertyListSeparators`	선택적 `String[]` 매개 변수입니다. 대상 및 속성의 목록을 `Project` 항목 메타데이터로 지정합니다. 처리 전에 구분 기호를 이스케이프 해제합니다. 예를 들어 %3B(이스케이프된 ';')는 이스케이프 해제된 ';'로 처리됩니다.
`TargetOutputs`	선택적 ITaskItem`[]` 읽기 전용 출력 매개 변수입니다. 모든 프로젝트 파일에서 작성된 대상의 출력을 반환합니다. 해당 대상이 종속된 대상에 있을 수 있는 출력이 아닌, 지정된 대상의 출력만 반환됩니다. `TargetOutputs` 매개 변수는 다음 메타데이터도 포함합니다. - `MSBuildSourceProjectFile`: 출력을 설정하는 대상이 포함된 MSBuild 프로젝트 파일입니다. - `MSBuildSourceTargetName`: 출력을 설정하는 대상입니다. 참고: 각 프로젝트 파일이나 대상의 출력을 개별적으로 식별하려는 경우 각 프로젝트 파일 또는 대상에 대해 `MSBuild`를 개별적으로 실행합니다. `MSBuild` 작업을 한 번만 실행하여 모든 프로젝트 파일을 빌드하는 경우에는 모든 대상의 출력이 배열 하나에 수집됩니다.
`Targets`	선택적 `String` 매개 변수입니다. 프로젝트 파일에서 빌드할 하나 이상의 대상을 지정합니다. 세미콜론을 사용하여 대상 이름 목록을 구분합니다. `MSBuild` 작업에 대상이 지정되어 있지 않으면 프로젝트 파일에 지정된 기본 대상이 빌드됩니다. 참고: 모든 프로젝트 파일에는 대상이 있어야 합니다. 대상이 없으면 빌드 오류가 발생합니다.
`ToolsVersion`	선택적 `String` 매개 변수입니다. 이 작업에 전달된 프로젝트를 빌드할 때 사용할 `ToolsVersion`을 지정합니다. MSBuild 작업이 프로젝트에 지정된 것과 다른 .NET Framework 버전을 대상으로 하는 프로젝트를 빌드할 수 있도록 설정합니다. 유효한 값은 `2.0`, `3.0` 및 `3.5`입니다. 기본값은 `3.5`여야 합니다.

설명

이 작업은 위에 나와 있는 매개 변수 외에 Task 클래스에서 직접 상속하는 TaskExtension 클래스의 매개 변수도 상속합니다. 이러한 추가 매개 변수 및 해당 설명이 포함된 목록은 TaskExtension 기본 클래스를 참조하세요.

Exec 작업을 사용하여 MSBuild.exe를 시작하는 경우와 달리 이 작업에서는 동일한 MSBuild 프로세스를 사용하여 자식 개체를 빌드합니다. 건너뛸 수 있는 이미 빌드된 대상의 목록은 부모 빌드와 자식 빌드 간에 공유됩니다. 또한 새 MSBuild 프로세스가 만들어지지 않으므로 이 작업은 속도도 더 빠릅니다.

이 작업에서는 프로젝트 파일뿐 아니라 솔루션 파일도 처리할 수 있습니다.

MSBuild에서 여러 프로젝트를 동시에 빌드하는 데 필요한 모든 구성(해당 구성이 포트, 프로토콜, 시간 제한, 다시 시도 등의 원격 인프라를 사용하는 경우도 포함됨)은 구성 파일을 통해 구성 가능하도록 지정해야 합니다. 가능한 경우에는 MSBuild 작업에 대한 작업 매개 변수로 구성 항목을 지정할 수 있어야 합니다.

MSBuild 3.5부터는 솔루션 프로젝트가 이제 빌드하는 모든 하위 프로젝트에서 TargetOutputs를 표시합니다.

프로젝트에 속성 전달

MSBuild 3.5 이전 MSBuild 버전에서는 MSBuild 항목에 나열된 각 프로젝트에 서로 다른 속성 집합을 전달하기가 어려웠습니다. MSBuild 작업의 Properties 특성을 사용한 경우에는 MSBuild 작업을 일괄 처리하고 항목 목록의 각 프로젝트에 대해 각기 다른 속성을 조건부로 제공한 경우가 아니면 빌드 중인 모든 프로젝트에 해당 설정이 적용되었습니다.

그러나 MSBuild 3.5에서는 두 가지 새 예약된 메타데이터 항목인 Properties와 AdditionalProperties가 제공됩니다. 이러한 항목을 사용하면 MSBuild 작업을 통해 빌드 중인 각 프로젝트에 대해 서로 다른 속성을 유동적으로 전달할 수 있습니다.

참고 항목

이러한 새 메타데이터 항목은 MSBuild 작업의 Projects 특성에 전달된 항목에만 적용됩니다.

다중 프로세서 빌드의 이점

이러한 새 메타데이터를 사용하는 경우의 주요 이점 중 하나는 다중 프로세서 시스템에서 병렬로 프로젝트를 빌드할 때 제공됩니다. 메타데이터를 사용하면 일괄 처리 또는 조건부 MSBuild 작업을 수행하지 않고도 모든 프로젝트를 단일 MSBuild 작업 호출에 통합할 수 있습니다. 그리고 단일 MSBuild 작업만 호출하면 Projects 특성에 나열된 모든 프로젝트가 병렬로 빌드됩니다. 그러나 특성이 BuildInParallel=true MSBuild 작업에 있는 경우에만 해당합니다. 자세한 내용은 병렬로 여러 프로젝트 빌드를 참조하세요.

Properties 메타데이터

지정된 경우 속성 메타 데이터는 작업의 properties 매개 변수를 재정의하고, AdditionalProperties 메타데이터는 매개 변수의 정의에 추가됩니다.

일반적인 시나리오는 빌드 구성만 다르게 적용하여 MSBuild 작업을 통해 여러 솔루션 파일을 빌드하는 것입니다. 예를 들어 a1 솔루션은 디버그 구성을 사용하여 빌드하고 a2 솔루션은 릴리스 구성을 사용하여 빌드할 수 있습니다. MSBuild 2.0에서 이 프로젝트 파일은 다음과 같이 표시됩니다.

참고 항목

다음 예제에서 “...”는 추가 솔루션 파일을 나타냅니다.

a.proj

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <Target Name="Build">
        <MSBuild Projects="a1.sln..." Properties="Configuration=Debug"/>
        <MSBuild Projects="a2.sln" Properties="Configuration=Release"/>
    </Target>
</Project>

그러나 Properties 메타데이터를 사용하면 아래에 나와 있는 것처럼 단일 MSBuild 작업을 사용하여 이 작업을 간소화할 수 있습니다.

a.proj

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <ItemGroup>
        <ProjectToBuild Include="a1.sln...">
            <Properties>Configuration=Debug</Properties>
        </ProjectToBuild>
        <ProjectToBuild Include="a2.sln">
            <Properties>Configuration=Release</Properties>
        </ProjectToBuild>
    </ItemGroup>
    <Target Name="Build">
        <MSBuild Projects="@(ProjectToBuild)"/>
    </Target>
</Project>

- 또는 -

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <ItemGroup>
        <ProjectToBuild Include="a1.sln..."/>
        <ProjectToBuild Include="a2.sln">
            <Properties>Configuration=Release</Properties>
        </ProjectToBuild>
    </ItemGroup>
    <Target Name="Build">
        <MSBuild Projects="@(ProjectToBuild)"
          Properties="Configuration=Debug"/>
    </Target>
</Project>

AdditionalProperties 메타데이터

MSBuild 작업을 사용하여 두 솔루션 파일을 빌드하는 시나리오를 가정해 보겠습니다. 이 두 파일은 모두 릴리스 구성을 사용하지만 한 파일은 x86 아키텍처를 사용하고 다른 파일은 ia64 아키텍처를 사용합니다. MSBuild 2.0에서는 이러한 솔루션 파일을 빌드하려면 MSBuild 작업의 여러 인스턴스를 만들어야 했습니다. 즉, x86 아키텍처가 포함된 릴리스 구성을 사용하는 프로젝트를 빌드하는 인스턴스 하나와 ia64 아키텍처가 포함된 릴리스 구성을 사용하는 또 다른 인스턴스를 만들어야 했습니다. 이 경우 프로젝트 파일은 다음과 같이 표시됩니다.

a.proj

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <Target Name="Build">
        <MSBuild Projects="a1.sln..." Properties="Configuration=Release;
          Architecture=x86"/>
        <MSBuild Projects="a2.sln" Properties="Configuration=Release;
          Architecture=ia64"/>
    </Target>
</Project>

AdditionalProperties 메타데이터를 사용하는 경우에는 다음 코드를 사용하여 단일 MSBuild 작업을 사용하도록 이 작업을 간소화할 수 있습니다.

a.proj

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <ItemGroup>
        <ProjectToBuild Include="a1.sln...">
            <AdditionalProperties>Architecture=x86
              </AdditionalProperties>
        </ProjectToBuild>
        <ProjectToBuild Include="a2.sln">
            <AdditionalProperties>Architecture=ia64
              </AdditionalProperties>
        </ProjectToBuild>
    </ItemGroup>
    <Target Name="Build">
        <MSBuild Projects="@(ProjectToBuild)"
          Properties="Configuration=Release"/>
    </Target>
</Project>

예시

다음 예제에서는 MSBuild 작업을 사용하여 ProjectReferences 항목 컬렉션으로 지정된 프로젝트를 빌드합니다. 결과 대상 출력은 AssembliesBuiltByChildProjects 항목 컬렉션에 저장됩니다.

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">

    <ItemGroup>
        <ProjectReferences Include="*.*proj" />
    </ItemGroup>

    <Target Name="BuildOtherProjects">
        <MSBuild
            Projects="@(ProjectReferences)"
            Targets="Build">
            <Output
                TaskParameter="TargetOutputs"
                ItemName="AssembliesBuiltByChildProjects" />
        </MSBuild>
    </Target>

</Project>

MSBuild 작업

매개 변수

설명

프로젝트에 속성 전달

다중 프로세서 빌드의 이점

Properties 메타데이터

a.proj

a.proj

AdditionalProperties 메타데이터

a.proj

a.proj

예시

참고 항목

피드백

피드백

추가 리소스