GenerateTemporaryTargetAssembly タスク

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

更新 : 2007 年 11 月

GenerateTemporaryTargetAssembly タスクは、プロジェクト内の少なくとも 1 つの Extensible Application Markup Language (XAML) ページが、そのプロジェクトでローカルに宣言されている型を参照している場合に、アセンブリを生成します。生成されるアセンブリは、ビルド処理が完了するか、またはビルド処理が失敗すると削除されます。

タスクパラメータ

パラメータ	説明
AssemblyName	必須の String 型のパラメータ。プロジェクトのために生成されるアセンブリの短い名前を指定します。この名前は、一時的に生成されるターゲットアセンブリの名前にもなります。たとえば、プロジェクトが WinExeAssembly.exe という名前の Windows 実行可能ファイルを生成する場合、AssemblyName パラメータの値は WinExeAssembly になります。
CompileTargetName	必須の String 型のパラメータ。ソースコードファイルからアセンブリを生成するために使用される Microsoft ビルドエンジン (MSBuild) ターゲットの名前を指定します。CompileTargetName の一般的な値は、CoreCompile です。
CompileTypeName	必須の String 型のパラメータ。 CompileTargetName パラメータで指定したターゲットによって実行されるコンパイルの種類を指定します。CoreCompile ターゲットでは、この値は Compile です。
CurrentProject	必須の String 型のパラメータ。一時ターゲットアセンブリを必要とするプロジェクトの、MSBuild プロジェクトファイルの完全なパスを指定します。
GeneratedCodeFiles	省略可能な ITaskItem[] 型のパラメータ。 MarkupCompilePass1 タスクによって生成される言語固有のマネージコードファイルの一覧を指定します。
IntermediateOutputPath	必須の String 型のパラメータ。生成される一時ターゲットアセンブリが格納されるディレクトリを指定します。
MSBuildBinPath	必須の String 型のパラメータ。一時ターゲットアセンブリをコンパイルするために必要な MSBuild.exe の場所を指定します。
ReferencePath	省略可能な ITaskItem[] 型のパラメータ。一時ターゲットアセンブリにコンパイルされる型によって参照されるアセンブリの一覧を、パスおよびファイル名を使用して指定します。
ReferencePathTypeName	必須の String 型のパラメータ。コンパイルターゲット (CompileTargetName) パラメータによって使用される、アセンブリ参照の一覧 (ReferencePath) を指定するパラメータを指定します。適切な値は、ReferencePath です。

解説

MarkupCompilePass1 タスクによって実行される最初のマークアップコンパイルパスでは、XAML ファイルがバイナリ形式にコンパイルされます。したがって、コンパイラでは、XAML ファイルで使用される型を含んでいる参照アセンブリの一覧が必要になります。ただし、同じプロジェクト内で定義されている型が XAML ファイルで使用されていると、そのプロジェクトの対応するアセンブリは、プロジェクトがビルドされるまで作成されません。このため、最初のマークアップコンパイルパスの間にアセンブリ参照を用意することができません。

代わりに、MarkupCompilePass1 は、同じプロジェクト内の型への参照を含む XAML ファイルの変換を、MarkupCompilePass2 タスクによって実行される 2 番目のマークアップコンパイルパスまで延期します。MarkupCompilePass2 が実行される前に、一時アセンブリが生成されます。このアセンブリには、マークアップコンパイルパスが延期された XAML ファイルによって使用される型が含まれます。MarkupCompilePass2 の実行時には、生成された一時アセンブリへの参照を指定します。これにより、コンパイルが延期された XAML ファイルをバイナリ形式にコンパイルできるようになります。

使用例

次の例では、Page1.xaml が同じプロジェクト内の型への参照を含んでいるため、一時アセンブリが作成されます。

<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
  <UsingTask
    TaskName="Microsoft.Build.Tasks.Windows.GenerateTemporaryTargetAssembly" 
    AssemblyFile="C:\Program Files\Reference Assemblies\Microsoft\Framework\v3.0\PresentationBuildTasks.dll" />
  <Target Name="GenerateTemporaryTargetAssemblyTask">
    <GenerateTemporaryTargetAssembly
      AssemblyName="WPFMSBuildSample"
      CompileTargetName="CoreCompile"
      CompileTypeName="Compile"
      CurrentProject="FullBuild.proj"
      GeneratedCodeFiles="obj\debug\app.g.cs;obj\debug\Page1.g.cs;obj\debug\Page2.g.cs"
      ReferencePath="c:\windows\Microsoft.net\Framework\v2.0.50727\System.dll;C:\Program Files\Reference Assemblies\Microsoft\WinFx\v3.0\PresentationCore.dll;C:\Program Files\Reference Assemblies\Microsoft\WinFx\v3.0\PresentationFramework.dll;C:\Program Files\Reference Assemblies\Microsoft\WinFx\v3.0\WindowsBase.dll"
      IntermediateOutputPath=".\obj\debug\"
      MSBuildBinPath="$(MSBuildBinPath)"
      ReferencePathTypeName="ReferencePath"/>
  </Target>
</Project>