MSBuild 変換

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

変換は、1 つの項目のコレクションを別の項目のコレクションにする、1 対 1 の変換です。プロジェクトで項目コレクションを変換できます。さらにこれらの変換により、ターゲットは入出力間の直接割り当てを指定できるようになります。このトピックでは、変換と MSBuild で変換を使用してより効率的にプロジェクトをビルドする方法について説明します。

変換の修飾子

変換は任意ではなく、特別な構文で制限されています。すべての変換の修飾子は、%(ItemMetaDataName) という形式である必要があります。作成時にすべての項目に割り当てられた既知のアイテムメタデータなど、任意のアイテムメタデータを変換の修飾子として使用できます。既知のアイテムメタデータの一覧については、「MSBuild 既知のアイテムメタデータ」を参照してください。

次の例では、.resx ファイルの一覧を .resources ファイルの一覧に変換します。変換の修飾子 %(filename) は、各 .resources ファイルが対応する .resx ファイルと同じファイル名を持つことを指定します。

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

メモ :
変換された項目のコレクションでは、通常の項目のコレクションと同じように、カスタムの区切り文字を指定できます。たとえば、変換された項目のコレクションを、既定のセミコロン (;) の代わりにコンマ (,) で区切るには、次の XML を使用します。 @(RESXFile->'Toolset\%(filename)%(extension)', ',')

変換された項目のコレクションでは、通常の項目のコレクションと同じように、カスタムの区切り文字を指定できます。たとえば、変換された項目のコレクションを、既定のセミコロン (;) の代わりにコンマ (,) で区切るには、次の XML を使用します。

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

たとえば、@(RESXFile) 項目のコレクション内の項目が Form1.resx、Form2.resx、および Form3.resx の場合、変換された一覧の出力は Form1.resources、Form2.resources、および Form3.resources となります。

複数の修飾子の使用

変換には複数の修飾子を含めることができます。修飾子は任意の順序で組み合わせることができ、変換式で繰り返すことができます。次の例では、ファイルを含むディレクトリは名前が変更されますが、ファイルは元の名前および拡張子を保持します。

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

たとえば、RESXFile 項目のコレクション内の項目が Project1\Form1.resx、Project1\Form2.resx、および Project1\Form3.text の場合、変換された一覧の出力は Toolset\Form1.resx、Toolset\Form2.resx、および Toolset\Form3.text となります。

依存関係の分析

変換は、変換された項目のコレクションと元の項目のコレクションとの間の、1 対 1 の割り当てを保証します。このため、ターゲットが入力の変換である出力を作成した場合、MSBuild は入力および出力のタイムスタンプを分析して、ターゲットをスキップ、ビルド、または部分的に再ビルドするかどうかを判断できます。

次の例の Copy タスクでは、BuiltAssemblies 項目コレクションにある各ファイルは、Outputs 属性の変換で指定されている、コピー先フォルダのファイルに割り当てられます。BuiltAssemblies 項目コレクションのいずれかのファイルが変更されると、変更されたファイルに対してのみ Copy タスクが実行され、その他のすべてのファイルはスキップされます。依存関係の分析および変換の使い方の詳細については、「方法 : インクリメンタルビルドを実行する」を参照してください。

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

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

</Target>

サンプル

説明

次の例に、変換を使用する MSBuild プロジェクトファイルを示します。この例では、c:\sub0\sub1\sub2\sub3 ディレクトリに単一の .xsd ファイルがあり、作業ディレクトリが c:\sub0 であるものとします。

コード

<Project xmlns="https://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>

この例を実行すると、次の出力が生成されます。

rootdir: C:\

fullpath: C:\xmake\sub1\sub2\sub3\myfile.xsd

rootdir + directory + filename + extension: C:\xmake\sub1\sub2\sub3\myfile.xsd

identity: sub1\sub2\sub3\myfile.xsd

filename: myfile

directory: xmake\sub1\sub2\sub3\

relativedir: sub1\sub2\sub3\

extension: .xsd

参照

処理手順

方法 : インクリメンタルビルドを実行する

その他の技術情報

MSBuild の概念

MSBuild リファレンス

次の方法で共有