在写 msbuild 脚本的时候，或修改项目文件的时候，将会使用到很多的微软提供的 Task 命令。在需要复杂的编译的时候，可以通过自己定义一个任务用来定义编译
如何入门开发请看 如何创建一个基于 MSBuild Task 的跨平台的 NuGet 工具包 - walterlv 本文只会补充一些开发的过程会遇到的坑
版本选择
开发的 Task 需要引用以下两个库
- Microsoft.Build.Framework
- Microsoft.Build.Utilities.Core
这也就默认要求使用 .NET Framework 4.7.2 和 .NET Standard 2.0 以上
判断当前编译器平台
在跨平台的开发可能用户使用的是 dotnet core 版本，于是需要一个 dotnet core 版本的 Task 让他进行编译
使用下面代码可以判断当前点编译器是运行在哪个平台
代码语言：javascript复制'$(MSBuildRuntimeType)' == 'Core'如果上面代码返回 true 那么编译器是 dotnet core 平台
以上面代码判断可以写出对使用 dotnet core 和 .NET Framework 两个平台的不同的程序集文件
调用方法
假定在程序集 UsingMSBuildCopyOutputFileToFastDebug.dll 里面包含 UsingMSBuildCopyOutputFileToFastDebug.SafeOutputFileCopyTask 类，这个类继承 Task 类
而 UsingMSBuildCopyOutputFileToFastDebug.dll 存放在 NuGet 包的 AssemblyFile 属性下，这个属性的定义请看代码
代码语言：javascript复制 <PropertyGroup>
<!-- 我们使用 $(MSBuildRuntimeType) 来判断编译器是 .NET Core 的还是 .NET Framework 的。
然后选用对应的文件夹。-->
<NuGetUsingMSBuildCopyOutputFileToFastDebugTaskFolder Condition=" '$(MSBuildRuntimeType)' == 'Core'">$(MSBuildThisFileDirectory)..toolsnetcoreapp2.2</NuGetUsingMSBuildCopyOutputFileToFastDebugTaskFolder>
<NuGetUsingMSBuildCopyOutputFileToFastDebugTaskFolder Condition=" '$(MSBuildRuntimeType)' != 'Core'">$(MSBuildThisFileDirectory)..toolsnet48</NuGetUsingMSBuildCopyOutputFileToFastDebugTaskFolder>
<AssemblyFile>$(NuGetUsingMSBuildCopyOutputFileToFastDebugTaskFolder)UsingMSBuildCopyOutputFileToFastDebug.dll</AssemblyFile>
</PropertyGroup>在调用之前需要先引用
代码语言：javascript复制 <UsingTask TaskName="UsingMSBuildCopyOutputFileToFastDebug.SafeOutputFileCopyTask"
AssemblyFile="$(AssemblyFile)" />之后可以在 Target 里面使用 SafeOutputFileCopyTask 类名
代码语言：javascript复制 <Target Name="CopyOutputLibToFastDebug" AfterTargets="AfterBuild"
Condition="$(MainProjectPath)!=''">
<ItemGroup>
<OutputFileToCopy Include="$(OutputPath)$(AssemblyName).dll"></OutputFileToCopy>
<OutputFileToCopy Include="$(OutputPath)$(AssemblyName).pdb"></OutputFileToCopy>
</ItemGroup>
<SafeOutputFileCopyTask SourceFiles="@(OutputFileToCopy)" DestinationFolder="$(MainProjectPath)"></SafeOutputFileCopyTask>
</Target>如何添加属性
在继承 Microsoft.Build.Utilities.Task 的类里面添加属性就可以在直接使用，如我添加了 DestinationFolder 和 SourceFiles 属性
代码语言：javascript复制 public class SafeOutputFileCopyTask : Microsoft.Build.Utilities.Task
{
public string[] SourceFiles { set; get; }
public string DestinationFolder { set; get; }
public override bool Execute()
{
return true;
}
}从上面代码可以看到，在 Task 里面添加列表数组的方法使用的是数组，如果使用的是列表那么在编译时将会提示
代码语言：javascript复制C:Userslindexi.github.io.nugetpackagesdotnetcampus.usingmsbuildcopyoutputfiletofastdebug1.1.352BuilddotnetCampus.UsingMSBuildCopyOutputFileToFastDebug.targets(18,33): error MSB4069: MSBuild 不支持“SafeOutputFileCopyTask”任务的“SourceFiles”参数的“System.Collections.Generic.List`1[[System.String, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]”类型。
C:Userslindexi.github.io.nugetpackagesdotnetcampus.usingmsbuildcopyoutputfiletofastdebug1.1.352BuilddotnetCampus.UsingMSBuildCopyOutputFileToFastDebug.targets(18,33): error MSB4026: “SafeOutputFileCopyTask”任务的“SourceFiles=@(OutputFileToCopy)”参数无效。 [f:tempHogalcageBeganeqealeHogalcageBeganeqeale.csproj]
C:Userslindexi.github.io.nugetpackagesdotnetcampus.usingmsbuildcopyoutputfiletofastdebug1.1.352BuilddotnetCampus.UsingMSBuildCopyOutputFileToFastDebug.targets(18,9): error MSB4063: 未能使用“SafeOutputFileCopyTask”任务的输入参数初始化该任务。输出消息
输出消息请使用 Console.WriteLine 就可以输出
输出警告和错误也使用 Console.WriteLine 方法，只是需要添加前缀 warning 如下面代码
Console.WriteLine("warning: 用户没有传入需要复制的文件");更多请看 如何在 MSBuild Target（Exec）中报告编译错误和编译警告 - walterlv
本文用到的代码开源在 Github 欢迎关注 UsingMSBuildCopyOutputFileToFastDebug 如有问题欢迎讨论
