浅谈VS编译自定义编译任务—MSBuild Task(csproject)

  在上一篇浅谈.NET编译时注入（C#-->IL）中我们简单的反编译查看了几种c#语法糖和PostSharp在编译成IL时为我做的MSIL注入。紧接着在这节，要来看的就是MSBuild Task。在我们的代码预编译过程中我们可以创建我们自己的任务Task。下面我们就开始做一个简单的Task。

1：首先需要添加Microsoft.Build.Utilities.v3.5.dll和Microsoft.Build.Framework.dll中引用。在Microsoft.Build.Framework中为我们定义了接口ITask，自定义任务需要去实现这个契约。其定义如下： 

 
 


  
  
public interface ITask   

  
  
    {   

  
  
       IBuildEngine BuildEngine { get; set; }   

  
  
       ITaskHost HostObject { get; set; }   

  
  
       bool Execute();   

  
  
    } 
 
 

IBuildEngine 从字义上说是编译引擎，他主要承载了我们的编译生成时的信息和消息，警告，错误等事件注册。而Execute这是我们Task执行体。HostObject 任务关联宿主信息。

在Microsoft.Build.Utilities下Task为我们实现了基本的ITask信息。我们可以从这里继承开始。

下面是一个简单的实现：

 
 


  
  
using System;   

  
  
using System.Collections.Generic;   

  
  
using System.Linq;   

  
  
using System.Text;   

  
  
 

  
  
namespace FirstBuildTask   

  
  
{   

  
  
    public class MyBuildTask : Microsoft.Build.Utilities.Task   

  
  
    {   

  
  
        private string outputFile;   

  
  
 

  
  
        [Microsoft.Build.Framework.Required]   

  
  
        public string OutputFile   

  
  
        {   

  
  
            get { return outputFile; }   

  
  
            set { outputFile = value; }   

  
  
        }   

  
  
 

  
  
        public override bool Execute()   

  
  
        {   

  
  
            Log.LogWarning("test message:" + this.outputFile);   

  
  
            return true;   

  
  
        }   

  
  
    }   

  
  
} 
 
 

下面我们需要关联Task，本人不喜欢污染，所以加到csproject（也可全局所有项目使用）。

下面我们创建一个简单的控制台

 
 


  
  
程序  

  
  
 

  
  
using System;   

  
  
using System.Collections.Generic;   

  
  
using System.Linq;   

  
  
using System.Text;   

  
  
 

  
  
namespace BlogSample   

  
  
{   

  
  
    class Program   

  
  
    {   

  
  
        static void Main(string[] args)   

  
  
        {   

  
  
            Console.WriteLine("ok");   

  
  
            Console.Read();   

  
  
        }   

  
  
    }   

  
  
} 
 
 

用记事本形式打开csproject文件：

添加我们的Task声明和任务。（xml标记含义将在后续，这里先看看效果。）

声明Task：

添加任务：

修改后的csproject文件形如：

上边红线注释的就是我们的Task所做的警告和输出路径的提示。

我们已经完成了一个简单Task，但还遗留这MsBuild配置，下面将简单的描述。

1：UsingTask：定义：<UsingTask TaskName="TaskName" AssemblyName = "AssemblyName" TaskFactory = "ClassName" Condition="'String A'=='String B'" />

描述我们的任务的程序集，任务类等信息，具体参见http://msdn.microsoft.com/zh-cn/library/t41tzex2.aspx。

在系统中为我们定义了很多Task，有：

AL（程序集链接器）任务:描述  AL 任务及其参数。

AspNetCompiler 任务:包装 aspnet_compiler.exe，它是预编译 ASP.NET 应用程序的实用工具。

AssignCulture 任务:为项分配区域性标识符。

CallTarget 任务:调用项目文件中的目标。

Copy 任务:描述  Copy 任务及其参数。

CreateItem 任务:描述  CreateItem 任务及其参数。

CreateProperty 任务:描述  CreateProperty 任务及其参数。

Csc 任务:描述  Csc 任务及其参数。

Delete 任务:描述  Delete 任务及其参数。

Error 元素 (MSBuild):根据计算的条件语句停止生成操作并记录错误。

Exec 任务:描述  Exec 任务及其参数。

FindUnderPath 任务:确定指定项集合中的哪些项存在于指定的文件夹及其所有子文件夹中。

GenerateApplicationManifest 任务:描述  GenerateApplicationManifest 任务及其参数。

GenerateBootstrapper 任务:提供一种自动化方式来检测、下载和安装应用程序及其必备组件。

GenerateDeploymentManifest 任务:描述  GenerateDeployManifest 任务及其参数。

GenerateResource 任务:将 .txt 和 .resx 文件转换为公共语言运行库二进制 .resources 文件。

GetAssemblyIdentity 任务:从指定的文件检索程序集标识并输出标识信息。

GetFrameworkPath 任务:检索 .NET Framework 程序集的路径。

GetFrameworkSdkPath 任务:检索 .NET Framework SDK 的路径。

LC 任务:描述  LC 任务及其参数。

MakeDir 任务:描述  MakeDir 任务及其参数。

Message 元素 (MSBuild):在生成期间记录消息。

MSBuild 任务:描述 MSBuild 任务及其参数。

ReadLinesFromFile 任务:从文本文件读取项列表。

RegisterAssembly 任务:描述  RegisterAssembly 任务及其参数。

RemoveDir 任务:描述  RemoveDir 任务及其参数。

ResGen 任务:描述  ResGen 任务及其参数。

ResolveAssemblyReference 任务:描述  ResolveAssemblyReference 任务及其参数。

ResolveComReference 任务：描述  ResolveCOMReference 任务及其参数。

ResolveKeySource 任务：确定强名称密钥源

ResolveNativeReference 任务：解析本机引用。

SGen 任务：为指定程序集中的类型创建一个 XML 序列化程序集。

SignFile 任务：使用指定证书对指定文件进行签名。

Touch 任务：描述  Touch 任务及其参数。

UnregisterAssembly 任务：描述  UnregisterAssembly 任务及其参数。

Vbc 任务”描述  Vbc 任务及其参数。

VCBuild 任务“描述  VCBuild 任务及其参数。

Warning 元素 (MSBuild)：根据计算的条件语句在生成期间记录警告。

WriteLinesToFile 任务：将指定项写入指定的文本文件。

其实很多我都不知道，我经常是用的时候在去查MSDN： http://msdn.microsoft.com/zh-cn/library/7z253716(v=VS.80).aspx

2：Target：定义

描述了我们的目标：可以包含0个多个任务。

属性

msdn：http://msdn.microsoft.com/zh-cn/library/t50z2hka(VS.80).aspx

参考文献：

http://msdn.microsoft.com/zh-cn/library/t41tzex2.aspx

http://msdn.microsoft.com/zh-cn/library/t50z2hka(VS.80).aspx

http://msdn.microsoft.com/zh-cn/library/ms171466(v=VS.80).aspx

http://msdn.microsoft.com/zh-cn/library/7z253716(v=VS.80).aspx

http://msdn.microsoft.com/zh-cn/library/ms164313(v=VS.80).aspx

http://msdn.microsoft.com/zh-cn/library/t9883dzc(v=VS.80).aspx

http://msdn.microsoft.com/zh-cn/library/ms171464(v=VS.80).aspx

MSBuild概念：http://msdn.microsoft.com/zh-cn/library/ms171451(v=VS.80).aspx