很难准确地说出引擎盖下发生了什么。我不在 MSBuild 上,所以我对实际的实现只是松散地熟悉。我们需要一个 MSBuild 开发人员来回答 100% 正确的答案。但这是我假设正在发生的事情(阅读:其余部分包含我的猜测)。
使用语句时的目标内部
Projects="$(BaseDirectory)\DebugConsoleApp\DebugConsoleApp.csproj"
MSBuild 注意到您使用了属性扩展 $(BaseDirectory) 并且 MSBuild 上的 Projects 的参数类型是一个数组。MSBuild 还注意到 BaseDirectory 是一个包含项目的属性。这些属性的行为与普通属性不同。您可以将它们视为“虚拟属性”(是的,我只是编造了这个术语)。当使用这些属性而不是查找值时,会进行内联替换。因此,您的 Projects 属性更改为:
Projects="@(Base->'%(FullPath)')\DebugConsoleApp\DebugConsoleApp.csproj"
由于 Projects 是一个数组,MSBuild 将尝试对提供的表达式执行转换。由于这不是有效的转换,因此会发生错误。这是您收到的错误。
现在要解决这个问题,您可以将构建目标更改为:
<Target Name="Build">
<PropertyGroup>
<_BaseDir>$(BaseDirectory)</_BaseDir>
<_DeployDir>@(Base->'%(FullPath)')</_DeployDir>
</PropertyGroup>
<Message Text="_BaseDir: $(_BaseDir)"/>
<Message Text="DeployDirectory: $(DeployDirectory)"/>
<MSBuild Projects="$(_BaseDir)\DebugConsoleApp\DebugConsoleApp.csproj"
Properties="Configuration=$(Configuration);OutputPath=$(_Tmp2)"
ContinueOnError="false" />
<!--<MSBuild Projects="$(BaseDirectory)\DebugConsoleApp\DebugConsoleApp.csproj"
Properties="Configuration=$(Configuration);OutputPath=$(DeployDirectory)"
ContinueOnError="false" />-->
</Target>
通过这种方法,我在目标本身内创建了一个属性组,并将这些“虚拟属性”的值分配给新属性。这些新属性不是虚拟属性,而是真实属性,因此您可以按预期使用它们而不会出现问题。
现在回答您的问题,“为什么消息任务有效 WTF?!!!”
在 Hello 目标中,您有以下内容:
<Message Text="Hello world. BaseDirectory=$(BaseDirectory), DeployDirectory=$(DeployDirectory)" />
哪个工作没有问题。之前我提到这些虚拟属性本质上将被替换为支持它们的定义,所以这实际上会变成。
<Message Text="Hello world. BaseDirectory=@(Base->'%(FullPath)'), DeployDirectory=@(Base->'%(FullPath)')\Deploy" />
好的,保持这个想法。
MSBuild 任务上的Text
属性被定义为一个字符串,它是一个标量值。如果您还记得 MSBuild 任务上的 Projects 属性被定义为 ITaskItem[],因为这是一个数组,它是一个向量值。当@(...)
在向量值属性中找到 a 时,整个表达式将用作项转换。在这种情况下,该语句@(Base->'%(FullPath)')\DebugConsoleApp\DebugConsoleApp.csproj
不是有效的转换表达式。当在标量值属性声明中找到“@(..)”时,值将被展平为字符串。因此,'@(...)' 的每个实例都被处理并展平为单个字符串值。如果有多个值,则使用分隔符。
所以希望这能解释你所看到的行为,它实际上可能是一个错误。您可以在http://connect.microsoft.com/上记录它, MSBuild 团队将对其进行分类。
更多关于虚拟属性
前面我提到,这些虚拟属性的行为与普通属性不同,因为不查找值,而是使用属性表达式替换了 $(...) 的用法。不要相信我的话,你自己看看。这是我创建的示例文件
<?xml version="1.0" encoding="utf-8"?>
<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003" ToolsVersion="4.0">
<ItemGroup>
<MyItem Include="C:\temp\01.txt"></MyItem>
</ItemGroup>
<PropertyGroup>
<MyProperty>@(MyItem->'%(FullPath)')</MyProperty>
</PropertyGroup>
<Target Name="Demo">
<Message Text="MyProperty: $(MyProperty)" />
<!-- Add to the item -->
<ItemGroup>
<MyItem Include="C:\temp\01.txt"></MyItem>
</ItemGroup>
<Message Text="MyProperty: $(MyProperty)" />
</Target>
</Project>
在这里,我声明了一个项目列表MyItem和一个依赖属性MyProperty。在 Demo 目标中,我打印 MyProperty 的值,然后将另一个值添加到 MyItem 项列表并再次打印出 MyProperty 的值。这是结果。
PS C:\temp\MSBuild\SO> msbuild .\Build.proj /nologo
Build started 4/26/2011 10:17:08 PM.
Project "C:\temp\MSBuild\SO\Build.proj" on node 1 (default targets).
First:
MyProperty: C:\temp\01.txt
MyProperty: C:\temp\01.txt;C:\temp\01.txt
Done Building Project "C:\temp\MSBuild\SO\Build.proj" (default targets).
如您所见,它的行为方式与我所说的一样。