MSBuild 인라인 작업

아티클
10/31/2023

MSBuild 작업은 일반적으로 ITask 인터페이스를 구현하는 클래스를 컴파일하여 생성됩니다. 자세한 내용은 작업을 참조하세요.

.NET Framework 버전 4부터 프로젝트 파일에서 인라인으로 작업을 만들 수 있습니다. 작업을 호스트할 별도의 어셈블리를 만들 필요가 없습니다. 따라서 소스 코드를 추적하기 위해 더 쉽고 작업을 배포하기도 더 쉽습니다. 소스 코드는 스크립트에 통합됩니다.

MSBuild 15.8 에서 RoslynCodeTaskFactory 가 추가되었습니다. 현재 개발의 경우 CodeTaskFactory가 아닌 RoslynCodeTaskFactory를 사용해야 합니다. CodeTaskFactory는 최대 4.0의 C# 버전만 지원합니다.

인라인 작업의 구조

인라인 작업은 UsingTask 요소에 의해 포함됩니다. 인라인 작업 및 이 작업을 포함하는 UsingTask 요소는 일반적으로 .targets 파일에 포함되며 필요할 때 다른 프로젝트 파일로 가져옵니다. 다음은 기본 인라인 작업입니다. 이 작업은 아무 것도 수행하지 않습니다.

<Project ToolsVersion="15.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <!-- This simple inline task does nothing. -->
  <UsingTask
    TaskName="DoNothing"
    TaskFactory="CodeTaskFactory"
    AssemblyFile="$(MSBuildToolsPath)\Microsoft.Build.Tasks.Core.dll" >
    <ParameterGroup />
    <Task>
      <Reference Include="" />
      <Using Namespace="" />
      <Code Type="Fragment" Language="cs">
      </Code>
    </Task>
  </UsingTask>
</Project>

이 예제의 UsingTask 요소에는 작업 및 해당 작업을 컴파일하는 인라인 작업 팩터리를 설명하는 세 가지 특성이 있습니다.

TaskName 특성은 작업의 이름을 지정합니다(이 경우 DoNothing).
TaskFactory 특성은 인라인 작업 팩터리를 구현하는 클래스의 이름을 지정합니다.
AssemblyFile 특성은 인라인 작업 팩터리를 위치를 지정합니다. 또는 AssemblyName 특성을 사용하여 일반적으로 $(MSBuildToolsPath)\Microsoft.Build.Tasks.Core.dll에 있는 인라인 작업 팩터리 클래스의 정규화된 이름을 지정할 수 있습니다.

DoNothing 작업의 나머지 요소는 비어 있으며 인라인 작업의 순서 및 구조를 보여 주기 위해 제공됩니다. 이 항목의 뒷부분에 보다 강력한 예제가 제공됩니다.

ParameterGroup 요소는 선택적입니다. 이 요소를 지정하면 작업에 대한 매개 변수를 선언합니다. 입력 및 출력 매개 변수에 대한 자세한 내용은 이 항목 뒷부분에 나오는 입력 및 출력 매개 변수를 참조하세요.
Task 요소는 작업 소스 코드를 설명하고 포함합니다.
Reference 요소는 코드에서 사용하는 .NET 어셈블리에 대한 참조를 지정합니다. 이 요소를 사용하는 것은 Visual Studio에서 프로젝트에 대한 참조를 추가하는 것과 같습니다. Include 특성은 참조된 어셈블리의 경로를 지정합니다.
Using 요소는 액세스하려는 네임스페이스를 나열합니다. 이 요소는 Visual C#의 Using 문과 비슷합니다. Namespace 특성은 포함할 네임스페이스를 지정합니다.

Reference 및 Using 요소는 언어와 관련이 없습니다. 인라인 작업은 지원되는 .NET CodeDom 언어 중 하나(예: Visual Basic 또는 Visual C#)로 작성할 수 있습니다.

참고

Task 요소에 의해 포함된 요소는 작업 팩터리(이 경우 코드 작업 팩터리)마다 고유합니다.

Code 요소

Task 요소 내에 마지막으로 나타나는 자식 요소는 Code 요소입니다. Code 요소는 작업으로 컴파일하려는 코드를 포함하거나 이러한 코드를 찾습니다. Code 요소에 포함하는 내용은 작업을 작성하려는 방법에 따라 다릅니다.

Language 특성은 코드가 작성된 언어를 지정합니다. 허용되는 값은 C#의 경우 cs, Visual Basic의 경우 vb입니다.

Type 특성은 Code 요소에서 발견되는 코드의 형식을 지정합니다.

Type 값이 Class이면 Code 요소는 ITask 인터페이스에서 파생되는 클래스에 대한 코드를 포함합니다.
Type 값이 Method이면 코드는 ITask 인터페이스의 Execute 메서드에 대한 재정의를 정의합니다.
Type 값이 Fragment이면 코드는 서명 또는 return 문이 아니라 Execute 메서드의 내용을 정의합니다.

코드 자체는 일반적으로 <![CDATA[ 표식 및 ]]> 표식 사이에 나타납니다. 코드가 CDATA 섹션에 있으므로 “<” 또는 “>”와 같은 예약 문자 이스케이프에 신경쓰지 않아도 됩니다.

또는 Code 요소의 Source 특성을 사용하여 작업에 대한 코드를 포함하는 파일의 위치를 지정할 수 있습니다. 소스 파일의 코드는 Type 특성으로 지정된 형식이어야 합니다. Source 특성이 있으면 Type의 기본값은 Class입니다. Source가 없으면 기본값은 Fragment입니다.

참고

소스 파일에서 클래스 이름을 정의할 때 클래스 이름은 UsingTask 요소의 TaskName 특성에 부합되어야 합니다.

HelloWorld

다음은 좀 더 강력한 인라인 작업입니다. HelloWorld 작업은 Visual Studio 출력 창에 해당하는 기본 오류 로깅 디바이스에 “Hello, world!”를 표시합니다. 이 예제의 Reference 요소는 단지 설명을 위해 포함되었습니다.

<Project ToolsVersion="15.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <!-- This simple inline task displays "Hello, world!" -->
  <UsingTask
    TaskName="HelloWorld"
    TaskFactory="CodeTaskFactory"
    AssemblyFile="$(MSBuildToolsPath)\Microsoft.Build.Tasks.Core.dll" >
    <ParameterGroup />
    <Task>
      <Reference Include="System.Xml"/>
      <Using Namespace="System"/>
      <Using Namespace="System.IO"/>
      <Code Type="Fragment" Language="cs">
<![CDATA[
// Display "Hello, world!"
Log.LogError("Hello, world!");
]]>
      </Code>
    </Task>
  </UsingTask>
</Project>

HelloWorld.targets라는 파일에 HelloWorld 작업을 저장한 다음, 다음과 같이 프로젝트에서 호출할 수 있습니다.

<Project ToolsVersion="15.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <Import Project="HelloWorld.targets" />
  <Target Name="Hello">
    <HelloWorld />
  </Target>
</Project>

입력 및 출력 매개 변수

인라인 작업 매개 변수는 ParameterGroup 요소의 자식 요소입니다. 모든 매개 변수는 해당 매개 변수를 정의하는 요소의 이름을 사용합니다. 다음 코드는 매개 변수 Text를 정의합니다.

<ParameterGroup>
  <Text />
</ParameterGroup>

매개 변수는 다음과 같은 특성을 하나 이상 포함할 수 있습니다.

Required는 기본적으로 false인 선택적 특성입니다. true이면 매개 변수는 필수이며 작업을 호출하기 전에 값을 지정해야 합니다.
ParameterType는 기본적으로 System.String인 선택적 특성입니다. System.Convert.ChangeType을 사용하여 특정 문자열로 변환되거나 이러한 문자열에서 변환될 수 있는 항목 또는 값에 해당하는 어떤 정규화된 형식으로도 설정될 수 있습니다. (즉, 외부 작업과 주고받을 수 있는 모든 형식을 나타냅니다.)
Output는 기본적으로 false인 선택적 특성입니다. true이면 먼저 매개 변수에 값이 지정되어야 Execute 메서드에서 반환될 수 있습니다.

예를 들면 다음과 같습니다.

<ParameterGroup>
  <Expression Required="true" />
  <Files ParameterType="Microsoft.Build.Framework.ITaskItem[]" Required="true" />
  <Tally ParameterType="System.Int32" Output="true" />
</ParameterGroup>

다음과 같은 세 개의 매개 변수를 정의합니다.

Expression은 System.String 형식의 필수 입력 매개 변수입니다.
Files는 필수 항목 목록 입력 매개 변수입니다.
Tally는 System.Int32 형식의 출력 매개 변수입니다.

Code 요소에 Fragment 또는 Method의 Type 특성이 있는 경우 모든 매개 변수에 대해 자동으로 속성이 만들어집니다. 그렇지 않으면 작업 소스 코드에서 속성을 명시적으로 선언해야 하며 이러한 속성은 해당 매개 변수 정의와 정확히 일치해야 합니다.

예시

다음 인라인 작업은 지정된 파일에서 나오는 모든 토큰을 지정된 값으로 바꿉니다.

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

  <UsingTask TaskName="TokenReplace" TaskFactory="CodeTaskFactory" AssemblyFile="$(MSBuildToolsPath)\Microsoft.Build.Tasks.Core.dll">
    <ParameterGroup>
      <Path ParameterType="System.String" Required="true" />
      <Token ParameterType="System.String" Required="true" />
      <Replacement ParameterType="System.String" Required="true" />
    </ParameterGroup>
    <Task>
      <Code Type="Fragment" Language="cs"><![CDATA[
string content = File.ReadAllText(Path);
content = content.Replace(Token, Replacement);
File.WriteAllText(Path, content);

]]></Code>
    </Task>
  </UsingTask>

  <Target Name='Demo' >
    <TokenReplace Path="C:\Project\Target.config" Token="$MyToken$" Replacement="MyValue"/>
  </Target>
</Project>

MSBuild 인라인 작업

인라인 작업의 구조

Code 요소

HelloWorld

입력 및 출력 매개 변수

예시

피드백

피드백

추가 리소스

MSBuild 인라인 작업

인라인 작업의 구조

Code 요소

HelloWorld

입력 및 출력 매개 변수

예시

관련 콘텐츠

피드백

피드백

추가 리소스