작업 작성
태스크는 빌드 프로세스 중에 실행되는 코드를 제공합니다. 작업은 목표에 포함됩니다. 일반적인 작업의 라이브러리는 MSBuild에 포함되며 사용자 고유의 작업을 만들 수도 있습니다. MSBuild에 포함된 태스크 라이브러리에 대한 자세한 내용은 작업 참조참조하세요.
작업
작업의 예로는 하나 이상의 파일을 복사하는 복사, 디렉터리를 만드는 MakeDir, C# 소스 코드 파일을 컴파일하는 Csc 등이 있습니다. 각 작업은 Microsoft.Build.Framework.dll 어셈블리에 정의된 ITask 인터페이스를 구현하는 .NET 클래스로 구현됩니다.
작업을 구현할 때 사용할 수 있는 두 가지 방법은 다음과 같습니다.
ITask 인터페이스를 직접 구현합니다.
도우미 클래스 Task에서 귀하의 클래스를 파생시키십시오. 이 클래스는 Microsoft.Build.Utilities.dll 어셈블리에 정의되어 있습니다. 태스크는 ITask를 구현하고 일부 ITask 멤버의 기본 구현을 제공합니다. 또한 로깅이 더 쉽습니다.
두 경우 모두 작업이 실행되면 호출되는 메서드인 Execute메서드를 클래스에 추가해야 합니다. 이 메서드는 매개 변수를 사용하지 않고 Boolean 값을 반환합니다. true 작업이 성공했는지 또는 실패한 경우 false. 다음 예제에서는 아무 작업도 수행하지 않고 성공적으로 완료되는 작업을 보여 줍니다(true반환).
using System;
using Microsoft.Build.Framework;
using Microsoft.Build.Utilities;
namespace MyTasks
{
public class SimpleTask : Task
{
public override bool Execute()
{
return true;
}
}
}
다음 프로젝트 파일은 이 작업을 실행합니다.
<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
<Target Name="MyTarget">
<SimpleTask />
</Target>
</Project>
태스크가 실행되면 작업 클래스에서 .NET 속성을 만드는 경우 프로젝트 파일에서 입력을 받을 수도 있습니다. MSBuild는 작업의 Execute 메서드를 호출하기 직전에 이러한 속성을 설정합니다. 문자열 속성을 만들려면 다음과 같은 작업 코드를 사용합니다.
using System;
using Microsoft.Build.Framework;
using Microsoft.Build.Utilities;
namespace MyTasks
{
public class SimpleTask : Task
{
public override bool Execute()
{
return true;
}
public string MyProperty { get; set; }
}
}
다음 프로젝트 파일은 이 작업을 실행하고 지정된 값으로 MyProperty 설정합니다.
<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
<Target Name="MyTarget">
<SimpleTask MyProperty="Value for MyProperty" />
</Target>
</Project>
작업 등록
프로젝트가 작업을 실행하려는 경우 MSBuild는 작업 클래스가 포함된 어셈블리를 찾아서 실행하는 방법을 알고 있어야 합니다. 작업은 UsingTask 요소(MSBuild)를 사용하여 등록됩니다.
작업에 런타임 관련 종속성이 있는 경우, UsingTask 에서으로 Architecture 및/또는 Runtime를 나타내 특정 환경에서 작업을 실행해야 함을 MSBuild에 알려야 합니다.
Microsoft.Common.tasks MSBuild 파일은 MSBuild 함께 제공되는 모든작업을 등록하는 UsingTask 요소 목록을 포함하는 프로젝트 파일입니다. 이 파일은 프로젝트를 빌드할 때 자동으로 포함됩니다. microsoft.Common.tasks 등록된 작업도 현재 프로젝트 파일에 등록되어 있는 경우 현재 프로젝트 파일의 우선 순위가 지정되므로 이름이 같은 사용자 고유의 작업으로 기본 작업을 재정의할 수 있습니다.
팁
microsoft.Common.tasks 내용을 확인하여 특정 버전의 MSBuild와 함께 제공되는 작업 목록을 볼 수 있습니다.
작업에서 이벤트를 발생시키기
작업이 Task 도우미 클래스에서 파생된 경우, Task 클래스의 다음 도우미 메서드를 사용하여 등록된 로거가 잡아내고 표시할 이벤트를 발생시킬 수 있습니다.
public override bool Execute()
{
Log.LogError("messageResource1", "1", "2", "3");
Log.LogWarning("messageResource2");
Log.LogMessage(MessageImportance.High, "messageResource3");
...
}
태스크에서 ITask을 직접 구현하는 경우, 여전히 이러한 이벤트를 발생시킬 수 있지만 반드시 IBuildEngine 인터페이스를 사용해야 합니다. 다음 예제에서는 ITask를 구현하고 사용자 지정 이벤트를 발생시키는 작업을 보여 줍니다.
public class SimpleTask : ITask
{
public IBuildEngine BuildEngine { get; set; }
public override bool Execute()
{
TaskEventArgs taskEvent =
new TaskEventArgs(BuildEventCategory.Custom,
BuildEventImportance.High, "Important Message",
"SimpleTask");
BuildEngine.LogBuildEvent(taskEvent);
return true;
}
}
작업 매개 변수를 설정해야 합니다.
작업을 실행하는 모든 프로젝트 파일이 이러한 속성에 대한 값을 설정해야 하거나 빌드가 실패하도록 특정 작업 속성을 "필수"로 표시할 수 있습니다. 다음과 같이 작업의 .NET 속성에 [Required] 특성을 적용합니다.
[Required]
public string RequiredProperty { get; set; }
[Required] 특성은 Microsoft.Build.Framework 네임스페이스의 RequiredAttribute 의해 정의됩니다.
MSBuild에서 작업을 호출하는 방법
작업을 호출할 때 MSBuild는 먼저 작업 클래스를 인스턴스화한 다음 프로젝트 파일의 작업 요소에 설정된 작업 매개 변수에 대해 해당 개체의 속성 setter를 호출합니다. 작업 요소가 매개 변수를 지정하지 않거나 요소에 지정된 식이 빈 문자열로 평가되면 속성 setter가 호출되지 않습니다.
예를 들어 프로젝트에서
<Project>
<Target Name="InvokeCustomTask">
<CustomTask Input1=""
Input2="$(PropertyThatIsNotDefined)"
Input3="value3" />
</Target>
</Project>
Input3의 setter만 호출됩니다.
작업은 매개 변수 속성 setter 호출의 상대 순서에 따라 달라지지 않아야 합니다.
작업 매개 변수 형식
MSBuild는 기본적으로 string, bool, ITaskItem 및 ITaskItem[]형식의 속성을 처리합니다. 태스크에서 다른 형식의 매개 변수를 수락하는 경우 MSBuild는 ChangeType 호출하여 string(모든 속성 및 항목 참조가 확장됨)에서 대상 형식으로 변환합니다. 입력 매개 변수에 대한 변환이 실패하면 MSBuild는 오류를 내보내고 작업의 Execute() 메서드를 호출하지 않습니다.
작업 패키징
작업을 배포하는 권장 방법은 NuGet 패키지에 있습니다. 패키지는 모든 종속성을 번들로 묶어야 합니다. 이 항목은 사용자 지정 작업을 만드는 단계를 안내하는 자습서에서 자세히 설명합니다. NuGet 패키지 생성을(를) 참조하세요.
예제 1
묘사
다음 C# 클래스는 Task 도우미 클래스에서 파생되는 작업을 보여 줍니다. 이 작업은 성공했음을 나타내는 true반환합니다.
코드
using System;
using Microsoft.Build.Utilities;
namespace SimpleTask1
{
public class SimpleTask1: Task
{
public override bool Execute()
{
// This is where the task would presumably do its work.
return true;
}
}
}
예제 2
설명
다음 C# 클래스는 ITask 인터페이스를 구현하는 작업을 보여 줍니다. 이 작업은 성공했음을 나타내는 true반환합니다.
코드
using System;
using Microsoft.Build.Framework;
namespace SimpleTask2
{
public class SimpleTask2: ITask
{
//When implementing the ITask interface, it is necessary to
//implement a BuildEngine property of type
//Microsoft.Build.Framework.IBuildEngine. This is done for
//you if you derive from the Task class.
public IBuildEngine BuildEngine { get; set; }
// When implementing the ITask interface, it is necessary to
// implement a HostObject property of type object.
// This is done for you if you derive from the Task class.
public object HostObject { get; set; }
public bool Execute()
{
// This is where the task would presumably do its work.
return true;
}
}
}
예제 3
설명
이 C# 클래스는 Task 도우미 클래스에서 파생되는 작업을 보여 줍니다. 필수 문자열 속성이 있으며 등록된 모든 로거가 표시하는 이벤트를 발생합니다.
코드
using System;
using Microsoft.Build.Framework;
using Microsoft.Build.Utilities;
namespace SimpleTask3
{
public class SimpleTask3 : Task
{
private string myProperty;
// The [Required] attribute indicates a required property.
// If a project file invokes this task without passing a value
// to this property, the build will fail immediately.
[Required]
public string MyProperty
{
get
{
return myProperty;
}
set
{
myProperty = value;
}
}
public override bool Execute()
{
// Log a high-importance comment
Log.LogMessage(MessageImportance.High,
"The task was passed \"" + myProperty + "\".");
return true;
}
}
}
예제 4
묘사
다음 예제에서는 이전 예제 작업인 SimpleTask3을 호출하는 프로젝트 파일을 보여줍니다.
코드
<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
<UsingTask TaskName="SimpleTask3.SimpleTask3"
AssemblyFile="SimpleTask3\bin\debug\simpletask3.dll"/>
<Target Name="MyTarget">
<SimpleTask3 MyProperty="Hello!"/>
</Target>
</Project>