MSBuild-Transformationen

  • Artikel

Eine Transformation ist eine 1:1-Konvertierung von einer Elementliste in eine andere. Über Transformationen können nicht nur Elementlisten in einem Projekt transformiert werden, sondern auch direkte Zuordnungen zwischen Eingaben und Ausgaben eines Ziels identifiziert werden. In diesem Artikel werden Transformationen thematisiert, und es wird erläutert, wie sie von MSBuild zur effizienteren Erstellung von Projekten verwendet werden.

Transformationsmodifizierer

Transformationen werden nicht auf willkürliche Art und Weise erstellt, sondern sind auf eine spezielle Syntax beschränkt, in der alle Transformationsmodifizierer dem Format %(<Elementmetadatenname>) entsprechen müssen. Alle Elementmetadaten können als Transfomationsmodifizierer verwendet werden, einschließlich des bekannten Elementmetadatenelements, das jedem Element bei der Erstellung zugewiesen wird. Eine vollständige Liste bekannter Metadaten finden Sie unter Bekannte Elementmetadaten.

Im folgenden Beispiel wird eine Liste mit RESX-Dateien in eine Liste mit RESOURCES-Dateien transformiert. Der Transformationsmodifizierer %(dateiname) gibt an, dass jeder RESOURCES-Datei derselbe Dateiname wie der zugehörigen RESX-Datei zugeordnet wird.

@(RESXFile->'%(filename).resources')

Wenn die Elemente in der @(resxfile)-Elementliste beispielsweise Form1.resx, Form2.resx und Form3.resx sind, lauten die Ausgaben in der transformierten Liste Form1.resources, Form2.resources und Form3.resources.

Hinweis

Sie können eine benutzerdefinierte Trennlinie für eine transformierte Elementliste auf dieselbe Weise angeben, wie Sie eine Trennlinie für eine Standardelementliste angeben. Verwenden Sie beispielsweise das folgende XML, um eine transformierte Elementliste durch ein Komma („,“) anstatt durch das standardmäßige Semikolon („;“) zu trennen: @(RESXFile->'Toolset\%(filename)%(extension)', ',')

Verwenden mehrerer Modifizierer

Ein Tranformationsausdruck kann mehrere Modifizierer enthalten, die in einer beliebigen Reihenfolge kombiniert und wiederholt werden können. Im folgenden Beispiel wird der Name des Verzeichnisses geändert, das die Dateien enthält. Dabei behalten die Dateien allerdings ihren ursprünglichen Namen und ihre Erweiterungen.

@(RESXFile->'Toolset\%(filename)%(extension)')

Wenn die Elemente, die in der RESXFile-Elementliste enthalten sind, beispielsweise Project1\Form1.resx, Project1\Form2.resx und Project1\Form3.text sind, lauten die Ausgaben in der transformierten Liste Toolset\Form1.resx, Toolset\Form2.resx und Toolset\Form3.text.

Abhängigkeitsanalyse

Tansformationen garantieren eine 1:1-Zuordnung zwischen der transformierten und der ursprünglichen Elementliste. Wenn daher ein Ziel Ausgaben erzeugt, die Transformationen der Eingaben sind, kann MSBuild die Zeitstempel der Ein- und Ausgaben analysieren und entscheiden, ob ein Ziel übersprungen, erstellt oder teilweise neu erstellt werden soll.

In der Kopieraufgabe im folgenden Beispiel ist jede Datei in der BuiltAssemblies-Elementliste einer Datei im Zielordner der Aufgabe zugeordnet, die durch eine Transformation im Outputs-Attribut bestimmt wird. Wenn eine Datei in der BuiltAssemblies-Elementliste geändert wird, wird die Copy-Aufgabe nur für die geänderte Datei ausgeführt, und alle anderen Dateien werden übersprungen. Weitere Informationen zur Abhängigkeitsanalyse finden Sie unter Vorgehensweise: Inkrementelles Erstellen.

<Target Name="CopyOutputs"
    Inputs="@(BuiltAssemblies)"
    Outputs="@(BuiltAssemblies -> '$(OutputPath)%(Filename)%(Extension)')">

    <Copy
        SourceFiles="@(BuiltAssemblies)"
        DestinationFolder="$(OutputPath)"/>

</Target>

Beispiel

Beschreibung

Im folgenden Beispiel wird eine MSBuild-Projektdatei dargestellt, die die Transformationen verwendet. Es wird angenommen, dass nur eine XSD-Datei im Verzeichnis c:\sub0\sub1\sub2\sub3 vorhanden ist, und dass das Arbeitsverzeichnis c:\sub0 lautet.

Code

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <ItemGroup>
        <Schema Include="sub1\**\*.xsd"/>
    </ItemGroup>

    <Target Name="Messages">
        <Message Text="rootdir: @(Schema->'%(rootdir)')"/>
        <Message Text="fullpath: @(Schema->'%(fullpath)')"/>
        <Message Text="rootdir + directory + filename + extension: @(Schema->'%(rootdir)%(directory)%(filename)%(extension)')"/>
        <Message Text="identity: @(Schema->'%(identity)')"/>
        <Message Text="filename: @(Schema->'%(filename)')"/>
        <Message Text="directory: @(Schema->'%(directory)')"/>
        <Message Text="relativedir: @(Schema->'%(relativedir)')"/>
        <Message Text="extension: @(Schema->'%(extension)')"/>
    </Target>
</Project>

Kommentare

Dieses Beispiel erzeugt die folgende Ausgabe:

rootdir: C:\
fullpath: C:\sub0\sub1\sub2\sub3\myfile.xsd
rootdir + directory + filename + extension: C:\sub0\sub1\sub2\sub3\myfile.xsd
identity: sub1\sub2\sub3\myfile.xsd
filename: myfile
directory: sub0\sub1\sub2\sub3\
relativedir: sub1\sub2\sub3\
extension: .xsd

Zugehöriger Inhalt