속성 및 항목 비교하기
MSBuild 속성 및 항목은 둘 다 작업에 정보를 전달하고, 조건을 확인한 다음 프로젝트 파일 전체에서 참조할 수 있는 값을 저장하는 데 사용됩니다.
속성은 이름-값 쌍입니다. 자세한 내용은 MSBuild 속성을 참조하세요.
항목은 일반적으로 파일을 나타내는 개체입니다. 항목 개체에는 연결된 메타데이터 컬렉션이 있을 수 있습니다. 메타데이터는 이름-값 쌍입니다. 자세한 내용은 항목을 참조하세요.
스칼라 및 벡터
MSBuild 속성은 문자열 값이 하나만 있는 이름-값 쌍이므로 보통 스칼라로 설명됩니다. MSBuild 항목 종류는 항목의 목록이므로 보통 벡터로 설명됩니다. 그러나 실제로 속성이 여러 값을 나타낼 수 있으며 항목 종류에는 0개 또는 1개의 항목이 있을 수 있습니다.
대상 종속성 주입
속성에서 여러 값을 나타낼 수 있는 방법을 알아보려면 빌드할 대상의 목록에 대상을 추가하기 위한 일반적인 사용 패턴을 고려해 보세요. 이 목록은 일반적으로 대상 이름이 세미콜론으로 구분된 속성 값으로 표시됩니다.
<PropertyGroup>
<BuildDependsOn>
BeforeBuild;
CoreBuild;
AfterBuild
</BuildDependsOn>
</PropertyGroup>
BuildDependsOn 속성은 일반적으로 대상 DependsOnTargets 특성의 인수로 사용되며, 해당 특성을 효과적으로 항목 목록으로 변환합니다. 대상을 추가하거나 대상 실행 순서를 변경하기 위해 이 속성을 재정의할 수 있습니다. 예를 들면 다음과 같습니다.
<PropertyGroup>
<BuildDependsOn>
$(BuildDependsOn);
CustomBuild;
</BuildDependsOn>
</PropertyGroup>
위의 코드는 대상 목록에 CustomBuild 대상을 추가하면서 BuildDependsOn에 BeforeBuild;CoreBuild;AfterBuild;CustomBuild 값을 제공합니다.
MSBuild 4.0부터는 대상 종속성 주입이 더 이상 사용되지 않습니다. 대신 AfterTargets 및 BeforeTargets 특성을 사용하세요. 자세한 내용은 대상 빌드 순서를 참조하세요.
문자열과 항목 목록 간의 변환
MSBuild는 필요에 따라 항목 종류 및 문자열 값 간의 변환을 수행합니다. 항목 목록이 문자열 값이 되는 방법을 알아보려면 항목 종류가 MSBuild 속성의 값으로 사용되는 경우 발생하는 상황을 고려해야 합니다.
<ItemGroup>
<OutputDir Include="KeyFiles\;Certificates\" />
</ItemGroup>
<PropertyGroup>
<OutputDirList>@(OutputDir)</OutputDirList>
</PropertyGroup>
OutputDir 항목 종류에는 “KeyFiles\;Certificates\” 값을 가진 Include 특성이 있습니다. MSBuild는 이 문자열을 두 개의 항목인 KeyFiles\ 및 Certificates\로 구문 분석합니다. OutputDir 항목 종류가 OutputDirList 속성의 값으로 사용되면 MSBuild에서 항목 종류를 세미콜론으로 구분된 문자열 “KeyFiles\;Certificates\”로 변환하거나 “평면화”합니다.
작업의 속성 및 항목
속성 및 항목은 MSBuild 작업의 입력 및 출력으로 사용됩니다. 자세한 내용은 작업을 참조하세요.
속성은 특성으로 작업에 전달됩니다. 작업 내에서 MSBuild 속성은 값이 문자열 간에 변환될 수 있는 속성 형식으로 표시됩니다. 지원되는 속성 형식에는 bool, char, DateTime, Decimal, Double, int, string 및 ChangeType에서 처리할 수 있는 모든 형식이 포함되어 있습니다.
항목은 ITaskItem 개체로 작업에 전달됩니다. 작업 내에서 ItemSpec는 항목의 값을 나타내며 GetMetadata는 해당 메타데이터를 검색합니다.
항목 종류의 항목 목록은 ITaskItem 개체의 배열로 전달될 수 있습니다. .NET Framework 3.5부터는 Remove 특성을 사용하여 항목 목록에서 항목을 제거할 수 없습니다. 항목 목록에서 항목을 제거할 수 있으므로, 항목 종류의 항목이 0개일 수도 있습니다. 항목 목록이 작업에 전달되면 작업의 코드에서 이러한 가능성을 확인해야 합니다.
속성 및 항목 평가 순서
빌드의 평가 단계 중 가져온 파일은 표시되는 순서대로 빌드에 통합됩니다. 속성 및 항목이 다음과 같은 순서로 세 단계로 정의됩니다.
속성이 표시되는 순서대로 정의되고 수정됩니다.
항목 정의가 표시되는 순서대로 정의되고 수정됩니다.
항목이 표시되는 순서대로 정의되고 수정됩니다.
빌드 실행 단계 중 대상 내에 정의된 속성 및 항목은 표시되는 순서대로 단일 단계에서 함께 평가됩니다.
그러나 이것이 다는 아닙니다. 속성, 항목 정의 또는 항목이 정의될 때 값이 계산됩니다. 식 계산기가 값을 지정하는 문자열을 확장합니다. 문자열 확장은 빌드 단계에 따라 달라집니다. 더 자세한 속성 및 항목 평가 순서는 다음과 같습니다.
빌드의 평가 단계 중:
속성이 표시되는 순서대로 정의되고 수정됩니다. 속성 함수가 실행됩니다. $(PropertyName) 양식의 속성 값이 식 내에서 확장됩니다. 속성 값이 확장된 식으로 설정됩니다.
항목 정의가 표시되는 순서대로 정의되고 수정됩니다. 속성 함수는 식 내에서 이미 확장되었습니다. 메타데이터 값은 확장된 식으로 설정됩니다.
항목 종류가 표시되는 순서대로 정의되고 수정됩니다. @(ItemType) 양식의 항목 값이 확장됩니다. 항목 변환도 확장됩니다. 속성 함수 및 값은 식 내에서 이미 확장되었습니다. 항목 목록 및 메타데이터 값은 확장된 식으로 설정됩니다.
빌드의 실행 단계 중:
- 대상 내에 정의된 속성 및 항목이 표시되는 순서대로 함께 평가됩니다. 속성 함수가 실행되며, 속성 값이 식 내에서 확장됩니다. 항목 값 및 항목 변환도 확장됩니다. 속성 값, 항목 종류 값 및 메타데이터 값은 확장된 식으로 설정됩니다.
평가 순서의 미묘한 효과
빌드의 평가 단계에서 속성 확인이 항목 확인 앞에 옵니다. 그럼에도 불구하고 속성은 항목 값에 따라 다르게 표시되는 값을 가질 수 있습니다. 다음 스크립트를 살펴보세요.
<ItemGroup>
<KeyFile Include="KeyFile.cs">
<Version>1.0.0.3</Version>
</KeyFile>
</ItemGroup>
<PropertyGroup>
<KeyFileVersion>@(KeyFile->'%(Version)')</KeyFileVersion>
</PropertyGroup>
<Target Name="AfterBuild">
<Message Text="KeyFileVersion: $(KeyFileVersion)" />
</Target>
메시지 작업 실행에서 다음 메시지를 표시합니다.
KeyFileVersion: 1.0.0.3
KeyFileVersion의 값은 실제로 “@(KeyFile->‘%(Version)’)” 문자열이기 때문입니다. 속성을 처음에 정의할 때 항목 및 항목 변환이 확장되지 않으므로 KeyFileVersion 속성에는 확장되지 않은 문자열의 값이 할당되었습니다.
빌드의 실행 단계 중 메시지 작업을 처리할 때 MSBuild에서 “@(KeyFile->‘%(Version)’)” 문자열을 확장하여 “1.0.0.3”을 생성합니다.
속성 및 항목 그룹의 순서가 반대로 된 경우에도 동일한 오류 메시지가 표시됩니다.
두 번째 예제로, 속성 및 항목 그룹이 대상 내에 있는 경우 발생할 수 있는 상황을 고려해 보세요.
<Target Name="AfterBuild">
<PropertyGroup>
<KeyFileVersion>@(KeyFile->'%(Version)')</KeyFileVersion>
</PropertyGroup>
<ItemGroup>
<KeyFile Include="KeyFile.cs">
<Version>1.0.0.3</Version>
</KeyFile>
</ItemGroup>
<Message Text="KeyFileVersion: $(KeyFileVersion)" />
</Target>
메시지 작업에서 다음 메시지를 표시합니다.
KeyFileVersion:
빌드의 실행 단계 중 대상 내에 정의된 속성 및 항목 그룹이 위에서 아래로 동시에 평가되기 때문입니다. KeyFileVersion이 정의될 때 KeyFile은 알려져 있지 않습니다. 따라서 항목 변환은 빈 문자열로 확장됩니다.
이 경우에 속성 및 항목 그룹의 순서를 반대로 해도 원본 메시지가 그대로 표시됩니다.
<Target Name="AfterBuild">
<ItemGroup>
<KeyFile Include="KeyFile.cs">
<Version>1.0.0.3</Version>
</KeyFile>
</ItemGroup>
<PropertyGroup>
<KeyFileVersion>@(KeyFile->'%(Version)')</KeyFileVersion>
</PropertyGroup>
<Message Text="KeyFileVersion: $(KeyFileVersion)" />
</Target>
KeyFileVersion의 값이 “@(KeyFile->‘%(Version)’)”이 아닌 “1.0.0.3”으로 설정됩니다. 메시지 작업에서 다음 메시지를 표시합니다.
KeyFileVersion: 1.0.0.3
관련 콘텐츠
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기