visual-studio - MSBuild:如何在构建时创建和使用任务来转换内容项？

Question

我有一个类似这样的 Silverlight 3 项目:

<ItemGroup>
  <Content Include="Content\image1.png">
  </Content>
</ItemGroup>

基本上我已经在我的项目中添加了一个 PNG 文件并将其构建操作设置为“内容”。这很好用。

现在我想做的是能够将不同格式的图像添加到我的项目中，并拥有它们 在构建时转换为 PNG - 这样最终结果就好像我首先在项目中添加了一个 PNG 图像(作为内容)。

换句话说 - 我希望图像以 PNG 格式出现在我的 XAP 包中。

理想情况下，我希望它可以与 Visual Web Developer 2008 Express 一起使用(因此我可以通过将图像文件拖到 IDE 中并可能更改它们的构建操作来将图像文件添加到我的项目中)，并且无需制作任何系统- 广泛的变化。

我要转换的具体格式是 XCF——我已经有了 .NET 代码来转换为 PNG。我假设我必须 create a MSBuild Task .

我真的没有太多的 MSBuild 经验，我想知道如何把这样的东西放在一起。

根据我对 MSBuild 工作原理的粗略理解，我认为我需要知道:

如何通过从 @(Content) 中(重新)移动它们来创建项目集合(或其他)集合，基于它们的文件扩展名？

或:创建可在 Visual Web Developer 2008 Express

中使用的自定义构建操作

如何在 Task 中接收输入项的路径?

在哪里(.NET 或 MSBuild？)以及如何指定 Task 生成的输出文件的位置?

如果输入文件发生更改，如何确保重新构建文件？

在哪里(可能是 BeforeBuild ？)以及如何将转换后的项目重新注入(inject) @(Content) ? (或者我应该使用其他收藏吗？)

或者:让他们进入 XAP 的其他方式？

如果这似乎是一种合理的做事方式，或者我错过了什么？

Answer 1

您已经提出了具体的子问题以实现您的总体目标，我想您想了解 MSBuild，而不是对您的整体任务获得死记硬背的答案(由于您的赏金)，所以我将回答您的个人问题，然后尝试将它们全部汇总到一个解决方案中。

因此，假设您要将所有 .jpg 文件转换为 .png。

根据扩展名从内容项列表中创建子列表:

<ItemGroup>
    <Sublist Include="@(Content)" Condition=" '%(Extension)' == '.jpg' " />
</ItemGroup>

Receive the path of the item in a task.

两种方式 - 取决于您的任务可以接受的输入。这种方式就像对子列表中每个项目的“foreach”，我倾向于将它与 Exec 任务一起使用:

<Exec Command="convert.exe /Input:%(Sublist.FullPath)" />

Specifying an output path also depends on the .exe or the task that you are and what an output path means to a particular task:

它是一个目录，还是只是一个具有不同扩展名的文件名。但我假设您要输出具有相同名称但扩展名不同的文件:

<Exec Command="convert.exe &quot;%(Sublist.FullPath)&quot;  &quot;%(Sublist.RootDir)%(Sublist.Directory)%(Sublist.Filename).png&quot;" />    

How to rebuild the png if the jpg changes (or is cleaned).

嗯，这是使用包含目标元素的 Inputs 和 Outputs 属性，我们的转换命令在其中执行。输入指定源文件是什么，输出指定目标将产生什么。 MSBuild 然后将输入的日期时间与输出的日期时间进行比较，如果它们已过期，则重新构建输出

<Target Name="ConvertJpg"  
        Inputs="@(Content)"
        Outputs="@(Content -> '%(RootDir)%(Directory)%(Filename).png' )"
        Condition=" '%(Extension)' == '.jpg' "

Inputs 表示我们要使用“内容”项目组

Condition 属性确保我们只使用以 .jpg 扩展名结尾的内容项

Outputs 属性表示我们正在使用的输入中，我们将生成具有相似路径和文件名但以 .png 扩展名

结尾的文件

最后，您正确地发现您需要将生成的 .png 文件重新注入(inject)到 @Content 项目组中——嗯，这很简单，您只需将它们包含到 Content 项目中。回想一下，子列表包含 .jpg 文件——我们想要这些文件，但以 .png 结尾。一旦生成了 png，我们也不希望内容项组中的 .jpg 文件

<Content Remove="@(Sublist)" />
<Content Include="@(Sublist -> '%(RootDir)%(Directory)%(Filename).png' )" />

综上所述，我相信你的目标看起来像这样:

<Target Name="ConvertJpg"  
        Inputs="@(Content)"
        Outputs="@(Content -> '%(RootDir)%(Directory)%(Filename).png' )"
        Condition=" '%(Extension)' == '.jpg' "
    <ItemGroup>
        <Sublist Include="@(Content)" Condition=" '%(Extension)' == '.jpg' " />
    </ItemGroup>

    <Exec Command="convert.exe /Input:%(Sublist.FullPath) Output=%(Sublist.RootDir)%(Sublist.Directory)%(Sublist.Filename).png" />

    <Content Remove="@(Sublist)" />
    <Content Include="@(Sublist -> '%(RootDir)%(Directory)%(Filename).png' )" />
</Target>

顺便说一句，ImageMagik 有一个命令行工具，可以将 jpg 转换为 png...