WPF アプリケーション (WPF) のビルド

[アーティクル]
08/16/2008

更新 : 2008 年 7 月

Windows Presentation Foundation (WPF) アプリケーションは、.NET Framework の実行可能ファイル (.exe)、ライブラリ (.dll)、またはこれらの両方のタイプのアセンブリの組み合わせとしてビルドできます。ここでは、まずコマンドプロンプトから単純な WPF アプリケーションをビルドする方法を示します。その次に、WPF で Microsoft ビルドエンジン (MSBuild) の機能拡張を利用して複雑なアプリケーションをビルドする方法を示します。最後に、MSBuild ビルドプロセスの主要な手順の詳細も説明します。

このトピックには次のセクションが含まれています。

コマンドラインコンパイルによる WPF アプリケーションのビルド
MSBuild による WPF アプリケーションのビルド
WPF の MSBuild プロジェクトファイル
Visual Studio を使用した WPF の MSBuild プロジェクトの作成
WPF の MSBuild プロジェクトのビルド
Windows Presentation Foundation のビルドパイプライン
インクリメンタルビルドのサポート
関連トピック

コマンドラインコンパイルによる WPF アプリケーションのビルド

すべてコードで記述された (マークアップがない) WPF アプリケーションは、コマンドラインコンパイラを使用してビルドできます。たとえば、次のソースコードファイルを含む C# の WPF スタンドアロンアプリケーションについて考えます。

アプリケーション定義ファイル (app.cs)。
ウィンドウ (mainwindow.cs)。

このアプリケーションは、次の例のようにコマンドプロンプトから C# コンパイラの csc.exe を使用してビルドできます。

csc.exe
  /out:WPFApplication.exe
  /target:winexe 
  app.cs mainwindow.cs 
  /reference:"C:\Program Files\Reference Assemblies\Microsoft\Framework\v3.0\presentationframework.dll" 
  /reference:"C:\Program Files\Reference Assemblies\Microsoft\Framework\v3.0\windowsbase.dll" 
  /reference:"C:\Program Files\Reference Assemblies\Microsoft\Framework\v3.0\presentationcore.dll"

この例では、次のように記述されています。

/out パラメータでは、ビルドされる実行可能アセンブリの名前を指定します (WPFApplication.exe)。
/target パラメータでは、コンパイルするアセンブリの種類を指定します (Microsoft Windows 実行可能ファイル)。
アプリケーションを構成する C# ソースコードファイルを指定します (app.cs および mainwindow.cs)。
/reference パラメータでは、アプリケーションで使用する型を実装する参照アセンブリを識別します。

コマンドラインコンパイルを使用すると、さらに複雑なアプリケーションをビルドできますが、コンパイラは、Extensible Application Markup Language (XAML) ソースコードを含む WPF アプリケーションをサポートしていません。さらに、コマンドラインコンパイルは、構成管理、ClickOnce マニフェストの生成など、一般的な WPF アプリケーションのすべてのビルド要件をサポートしているわけではありません。さらに複雑なビルド要件をサポートするために、WPF は MSBuild を統合し、拡張しています。

メモ :
コマンドラインコンパイルの詳細については、「csc.exe を使用したコマンドラインからのビルド」または「コマンドラインからのビルド (Visual Basic)」を参照してください。

MSBuild による WPF アプリケーションのビルド

MSBuild は、.NET Framework に含まれている、信頼性の高い拡張可能なテクノロジです。MSBuild テクノロジのコアは、次の表に示すアセンブリ全体で実装されています。

アセンブリ	説明
Microsoft.Build.Engine.dll	MSBuild プロジェクトファイルを読み取って処理します。
Microsoft.Build.Tasks.dll	C# の csc.exe、Visual Basic の vbc.exe などのコマンドラインコンパイラの呼び出しを含む、すべての MSBuild プロジェクトに共通の機能を実装します。
Microsoft.Build.Utilities.dll	カスタムビルド機能によって MSBuild を拡張するユーティリティクラスを公開します。
Microsoft.Build.Framework.dll	MSBuild 機能と MSBuild エンジンの対話方法を定義するインターフェイスを実装します。
Microsoft.Build.Conversion.dll	従来の Microsoft Visual Studio .NET 2002 プロジェクトファイルおよび Microsoft Visual Studio .NET 2003 プロジェクトファイルの形式から Microsoft Visual Studio 2005 MSBuild プロジェクトファイルの形式への変換をサポートします。

メモ :
MSBuild アセンブリの詳細については、「MSBuild リファレンス」を参照してください。

WPF の MSBuild プロジェクトファイル

MSBuild を構成するアセンブリは、MSBuild エンジンと呼ばれています。アプリケーションをビルドするために、MSBuild エンジンには一般に次の情報が必要です。

ソースコードファイルの参照
依存アセンブリの参照
構成の詳細
ビルド要件

この情報は、MSBuild によって処理されるように、カスタム MSBuild スキーマに準拠した XML ファイルに含まれています (「MSBuild プロジェクトファイルスキーマリファレンス」を参照)。このようなファイルを、MSBuild プロジェクトファイルと呼びます。コマンドラインコンパイラでビルドした WPF アプリケーションに、Extensible Application Markup Language (XAML) ソースコードファイルを追加したバージョン用の MSBuild プロジェクトファイルを次に示します。

<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
     <PropertyGroup>
         <AssemblyName>WPFApplication</AssemblyName>
         <OutputType>winexe</OutputType>
     </PropertyGroup>
     <ItemGroup>
         <Reference Include="System" />
         <Reference Include="WindowsBase" />
         <Reference Include="PresentationCore" />
         <Reference Include="PresentationFramework" />
     </ItemGroup>
     <ItemGroup>
         <ApplicationDefinition Include="App.xaml" />
         <Compile Include="App.xaml.cs" />
         <Page Include="MainWindow.xaml" />
         <Compile Include="MainWindow.xaml.cs" />
     </ItemGroup>
     <Import Project="$(MSBuildBinPath)\Microsoft.CSharp.targets" />
     <Import Project="$(MSBuildBinPath)\Microsoft.WinFX.targets" />
</Project>

この例には、Project タグ、プロパティ、項目、ターゲット、タスクなど、多くの MSBuild プロジェクトファイルに共通する要素が含まれています。

Project 要素

MSBuild プロジェクトファイルスキーマで指定されているとおり、MSBuild プロジェクトファイルは、トップレベルの要素である Project を持つ XML ファイルです。

<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
     ...
</Project>

MSBuild エンジンは、Project 要素からプロジェクトファイルの処理を開始します。MSBuild プロジェクトファイルが対象とする MSBuild のバージョンを指定するために、適切な XML 名前空間宣言が提供されます。

プロパティ

プロパティは、MSBuild プロジェクトを構成し、ビルド固有の情報を MSBuild エンジンに提供するために使用する変数です。次の例に示すように、プロパティが PropertyGroup 要素内に含まれています。

<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
     <PropertyGroup>
         <AssemblyName>WPFApplication</AssemblyName>
         <OutputType>winexe</OutputType>
     </PropertyGroup>
     ...
</Project>

AssemblyName や OutputType など、すべての種類のアプリケーションに共通するプロパティの一部については、「MSBuild プロジェクトの共通プロパティ」を参照してください。WPF に固有の MSBuild プロパティを次の表に示します。

OutputType

ビルドされるアセンブリの種類を指定します。次のいずれかの値になります。

winexe: 実行可能なアセンブリ (.exe) をビルドします。スタンドアロンアプリケーションと XBAP は、この種類の出力で構成されます。
library: ライブラリアセンブリ (.dll) をビルドします。共有アセンブリとカスタムコントロールライブラリは、この種類の出力で構成されます。

HostInBrowser

WPF アプリケーションが、ブラウザ内にホストされているかどうかを指定します。次のいずれかの値になります。

true: メインアプリケーションアセンブリ (.exe)、配置マニフェスト (applicationName.xbap)、およびアプリケーションマニフェスト (applicationName.exe.manifest) を含む XBAP を作成します。
false: スタンドアロンアプリケーションを作成します。

HostInBrowser が true の場合、OutputType は winexe である必要があります。

Install

XBAP がクライアントにインストールされているかどうかを指定します。Install は true または false であり、HostInBrowser と反対の値である必要があります。

GenerateManifests

スタンドアロンアプリケーションが、ClickOnce 配置を使用して公開されるかどうかを指定します。次のいずれかの値になります。

true: メインアプリケーションの実行可能ファイル、配置マニフェスト (applicationName.application)、およびアプリケーションマニフェスト (applicationName.exe.manifest) を作成します。
false: アプリケーションの実行可能ファイル (.exe) のみを作成します。

GenerateManifests は、Install の値が true の場合にのみ使用します。

UICulture

アセンブリをビルドするロケールを指定します。指定すると、Resource プロジェクト項目として宣言されたファイルと言語固有のリソースは、目的のロケールのサテライトアセンブリにコンパイルされます。一方、言語に依存しないコンテンツは、メインアセンブリにコンパイルされます。既定では、アプリケーションはローカライズされないため、リソースファイルはメインアセンブリに組み込まれます。

メモ :
UICulture を設定する場合は、NeutralResourcesLanguageAttribute を使用してニュートラルリソース言語を指定する必要があります。この属性は、WPF アプリケーションの AssemblyInfo ファイルに追加する必要があります。

項目

項目は、ビルドプロセス中に MSBuild エンジンによって処理される MSBuild の入力です。項目は、ItemGroup 要素内に配置します。

<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
     ...
     <ItemGroup>
         <Reference Include="System" />
         <Reference Include="WindowsBase" />
         <Reference Include="PresentationCore" />
         <Reference Include="PresentationFramework" />
     </ItemGroup>
     <ItemGroup>
         <ApplicationDefinition Include="App.xaml" />
         <Compile Include="App.xaml.cs" />
         <Page Include="MainWindow.xaml" />
         <Compile Include="MainWindow.xaml.cs" />
     </ItemGroup>
     ...
</Project>

項目の型は、メタデータを使用して構成できます。前の例では、アセンブリ参照は Reference 項目として構成され、ソースコードファイルは Compile 項目として構成されます。Reference 項目と Compile 項目は、すべての .NET Framework アプリケーションに共通する項目です。これらの項目の詳細については、「MSBuild プロジェクトの共通項目」を参照してください。

WPF に固有の MSBuild 項目を次の表に示します。

プロパティ	説明
ApplicationDefinition	アプリケーション定義 (ルート要素が Application である XAML マークアップファイル) を含む XAML マークアップファイルを指定します。ApplicationDefinition は、Install が true で、OutputType が winexe の場合に必須です。WPF アプリケーション、つまり MSBuild プロジェクトごとに指定できる ApplicationDefinition は 1 つのみです。
Page	コンテンツがバイナリ形式に変換され、アセンブリにコンパイルされる XAML マークアップファイルを指定します。Page 項目は、一般に分離コードクラスと共に実装されます。最も一般的な Page 項目は、次のいずれかのトップレベルの要素を持つ XAML ファイルです。 Window (System.Windows.Window) Page (System.Windows.Controls.Page) PageFunction (System.Windows.Navigation.PageFunction<T>) ResourceDictionary (System.Windows.ResourceDictionary) FlowDocument (System.Windows.Documents.FlowDocument) UserControl (System.Windows.Controls.UserControl)
Resource	アプリケーションアセンブリにコンパイルされるリソースファイルを指定します。前に述べたように、UICulture は Resource 項目を処理します。
Content	アプリケーションと共に配布するコンテンツファイルを指定します。コンテンツファイルを記述するメタデータは、AssemblyAssociatedContentFileAttribute を使用してアプリケーションにコンパイルされます。
SplashScreen	アプリケーションのスタートアップウィンドウで使用するイメージファイルを指定します。PresentationBuildTasks アセンブリは、SplashScreen インスタンスを生成する App.g.cs または Application.g.vb のコードを生成し、アプリケーションの読み込みの間、そのコードを表示します。この項目は、Visual Studio 2008 SP1 以降で使用できます。

ターゲット

ターゲットは、プロジェクトをビルドする方法を指定し、プロパティと項目の両方に依存します。WPF アプリケーションには、言語固有のターゲットと WPF 固有のターゲットがあります。

<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
     ...
     <Import Project="$(MSBuildBinPath)\Microsoft.CSharp.targets" />
     <Import Project="$(MSBuildBinPath)\Microsoft.WinFX.targets" />
</Project>

ターゲットは、.targets の拡張子の付いた個別のファイルです。.NET Framework に含まれるターゲットファイルは、次の場所にインストールされています。

%WINDIR%\Microsoft.NET\Framework\vX.X.X

言語固有のターゲットは、言語固有のソースコードをビルドします。C# の言語固有のターゲットは Microsoft.CSharp.targets で、Visual Basic の言語固有のターゲットは Microsoft.VisualBasic.targets です。いずれのターゲットも、Microsoft.Common.targets ターゲットから派生して拡張されたもので、共通する言語非依存のビルド作業の大部分を実行します。共通および言語固有の MSBuild ターゲットの詳細については、「MSBuild .Targets ファイル」を参照してください。

WPF 固有のビルド作業は、Microsoft.WinFX.targets ターゲットによって実行されます。この作業には、XAML マークアップコンパイル、XBAP アプリケーションのマニフェスト生成、WPF リソースとコンテンツファイルの処理などがあります。

処理手順

タスクは、特定のビルドアクションを実行するクラスです。ターゲットによって 1 つ以上のタスクが結合されて、ビルドプロセスが定義されます。MSBuild はターゲットを処理するときに、ターゲットによって結合されたタスクを実行します。共通および言語固有のターゲットが使用するタスクは Microsoft.Build.Tasks アセンブリによって実装され、WPF に固有のタスクは PresentationBuildTasks アセンブリによって実装されます。

ターゲットは、標準的なすべての WPF アプリケーションのビルドのサポートを提供します。タスクの組み合わせを変えて、カスタムビルドの動作を実装することもできます。たとえば、次の MSBuild の GetWinFXPath タスクを使用して、タスクが 64 ビットプロセッサ上で実行されているかどうかに依存する、.NET Framework ランタイムへのネイティブパスを検出します。

<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
     <UsingTask 
         TaskName="Microsoft.Build.Tasks.Windows.GetWinFXPath" 
         AssemblyFile="C:\Program Files\Reference Assemblies\Microsoft\Framework\v3.0\PresentationBuildTasks.dll" />
     <Target Name="GetWinFXPathTask">
         <GetWinFXPath
             WinFXNativePath="c:\DOTNet3Native" 
             WinFXWowPath="c:\DOTNet3WowNative" />
     </Target>
     <Import Project="$(MSBuildBinPath)\Microsoft.WinFX.targets" />
</Project>

一般的な MSBuild タスクの詳細については、「MSBuild タスクリファレンス」を参照してください。

Windows Presentation Foundation MSBuild プロジェクトサンプル

Windows ソフトウェア開発キット (SDK) には、一般的な種類の WPF アプリケーションの数種類のサンプル MSBuild プロジェクトファイルが付属しています。

Visual Studio を使用した WPF の MSBuild プロジェクトの作成

Visual Studio プロジェクトテンプレートを使用して新しい WPF アプリケーションを作成すると、Visual Studio によって MSBuild プロジェクトファイルが自動的に生成されます。たとえば、WPF アプリケーションのプロジェクトテンプレートは、次のプロジェクトファイルを生成します (C# の場合)。

<?xml version="1.0" encoding="utf-8"?>
<Project ToolsVersion="3.5" DefaultTargets="Build" xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
  <PropertyGroup>
    <Configuration Condition=" '$(Configuration)' == '' ">Debug</Configuration>
    <Platform Condition=" '$(Platform)' == '' ">AnyCPU</Platform>
    <ProductVersion>9.0.20726</ProductVersion>
    <SchemaVersion>2.0</SchemaVersion>
    <ProjectGuid>{E0EA3EBA-718C-4122-B20C-EB97B7DC6604}</ProjectGuid>
    <OutputType>WinExe</OutputType>
    <AppDesignerFolder>Properties</AppDesignerFolder>
    <RootNamespace>WpfApplication1</RootNamespace>
    <AssemblyName>WpfApplication1</AssemblyName>
    <TargetFrameworkVersion>v3.5</TargetFrameworkVersion>
    <FileAlignment>512</FileAlignment>
    <ProjectTypeGuids>
      {60dc8134-eba5-43b8-bcc9-bb4bc16c2548};
      {FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}
    </ProjectTypeGuids>
    <WarningLevel>4</WarningLevel>
  </PropertyGroup>
  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|AnyCPU' ">
    <DebugSymbols>true</DebugSymbols>
    <DebugType>full</DebugType>
    <Optimize>false</Optimize>
    <OutputPath>bin\Debug\</OutputPath>
    <DefineConstants>DEBUG;TRACE</DefineConstants>
    <ErrorReport>prompt</ErrorReport>
    <WarningLevel>4</WarningLevel>
  </PropertyGroup>
  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|AnyCPU' ">
    <DebugType>pdbonly</DebugType>
    <Optimize>true</Optimize>
    <OutputPath>bin\Release\</OutputPath>
    <DefineConstants>TRACE</DefineConstants>
    <ErrorReport>prompt</ErrorReport>
    <WarningLevel>4</WarningLevel>
  </PropertyGroup>
  <ItemGroup>
    <Reference Include="System" />
    <Reference Include="System.Core">
      <RequiredTargetFramework>3.5</RequiredTargetFramework>
    </Reference>
    <Reference Include="System.Xml.Linq">
      <RequiredTargetFramework>3.5</RequiredTargetFramework>
    </Reference>
    <Reference Include="System.Data.DataSetExtensions">
      <RequiredTargetFramework>3.5</RequiredTargetFramework>
    </Reference>
    <Reference Include="System.Data" />
    <Reference Include="System.Xml" />
    <Reference Include="WindowsBase" />
    <Reference Include="PresentationCore" />
    <Reference Include="PresentationFramework" />
  </ItemGroup>
  <ItemGroup>
    <ApplicationDefinition Include="App.xaml">
      <Generator>MSBuild:Compile</Generator>
      <SubType>Designer</SubType>
    </ApplicationDefinition>
    <Page Include="Window1.xaml">
      <Generator>MSBuild:Compile</Generator>
      <SubType>Designer</SubType>
    </Page>
    <Compile Include="App.xaml.cs">
      <DependentUpon>App.xaml</DependentUpon>
      <SubType>Code</SubType>
    </Compile>
    <Compile Include="Window1.xaml.cs">
      <DependentUpon>Window1.xaml</DependentUpon>
      <SubType>Code</SubType>
    </Compile>
  </ItemGroup>
  <ItemGroup>
    <Compile Include="Properties\AssemblyInfo.cs">
      <SubType>Code</SubType>
    </Compile>
    <Compile Include="Properties\Resources.Designer.cs">
      <AutoGen>True</AutoGen>
      <DesignTime>True</DesignTime>
      <DependentUpon>Resources.resx</DependentUpon>
    </Compile>
    <Compile Include="Properties\Settings.Designer.cs">
      <AutoGen>True</AutoGen>
      <DependentUpon>Settings.settings</DependentUpon>
      <DesignTimeSharedInput>True</DesignTimeSharedInput>
    </Compile>
    <EmbeddedResource Include="Properties\Resources.resx">
      <Generator>ResXFileCodeGenerator</Generator>
      <LastGenOutput>Resources.Designer.cs</LastGenOutput>
      <SubType>Designer</SubType>
    </EmbeddedResource>
    <None Include="Properties\Settings.settings">
      <Generator>SettingsSingleFileGenerator</Generator>
      <LastGenOutput>Settings.Designer.cs</LastGenOutput>
    </None>
    <AppDesigner Include="Properties\" />
  </ItemGroup>
  <Import Project="$(MSBuildBinPath)\Microsoft.CSharp.targets" />
  <!-- To modify your build process, add your task inside one of the targets below and uncomment it. 
       Other similar extension points exist, see Microsoft.Common.targets.
  <Target Name="BeforeBuild">
  </Target>
  <Target Name="AfterBuild">
  </Target>
  -->
</Project>

生成された MSBuild プロジェクトファイル拡張子には、ソースコード言語の名前が反映されます。

C# プロジェクトでは、拡張子は .csproj です。
Visual Basic プロジェクトでは、拡張子は .vbproj です。

プロジェクトファイルは、前の例よりも大きくなります。これには、いくつかのプロパティが追加されていることも影響しています。ただし、追加情報は Visual Studio 固有で、次の情報が含まれます。

プロジェクト構成
ビルド構成
ソースコードファイルの関連付け
既定のプロジェクトプロパティ、リソース、および設定の管理

プロジェクト構成

プロジェクト構成の詳細には、プロジェクトを表す一意の識別子、プロジェクトの種類を表す一意の識別子、および .NET Framework と Visual Studio のバージョンを識別するさまざまなデータが含まれます。

<Project 
  ToolsVersion="3.5"
  DefaultTargets="Build"
  xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
  <PropertyGroup>
    <ProductVersion>9.0.20726</ProductVersion>
    <SchemaVersion>2.0</SchemaVersion>
    <ProjectGuid>{E0EA3EBA-718C-4122-B20C-EB97B7DC6604}</ProjectGuid>
    <TargetFrameworkVersion>v3.5</TargetFrameworkVersion>
    <ProjectTypeGuids>
      {60dc8134-eba5-43b8-bcc9-bb4bc16c2548};
      {FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}
    </ProjectTypeGuids>
  </PropertyGroup>
  ...
</Project>

ビルド構成

既定の Visual Studio プロジェクトには Debug と Release の 2 つのビルド構成があります (「ビルド構成」を参照)。ビルド構成は、MSBuild プロジェクトファイルで次のプロパティを使用して構成されます。

<Project ... >
  <PropertyGroup>
    <Configuration Condition=" '$(Configuration)' == '' ">
      Debug
    </Configuration>
    <Platform Condition=" '$(Platform)' == '' ">AnyCPU</Platform>
    <OutputType>WinExe</OutputType>
    <AppDesignerFolder>Properties</AppDesignerFolder>
    <RootNamespace>WpfApplication1</RootNamespace>
    <AssemblyName>WpfApplication1</AssemblyName>
    <FileAlignment>512</FileAlignment>
    <WarningLevel>4</WarningLevel>
    ...
  </PropertyGroup>
  ...
</Project>

現在のビルド構成は、Configuration プロパティで指定されます。

<Project ... >
  <PropertyGroup>
    <Configuration Condition=" '$(Configuration)' == '' ">
      Debug
    </Configuration>
    ...
  </PropertyGroup>
  ...
</Project>

ソースコードファイルの関連付け

Visual Studio は、マークアップファイルや分離コードファイルなど、関連するソースコードファイル間の関連付けを保持します。これにより、Visual Studio では、次に示すように Visual Studio の [ソリューションエクスプローラ] ウィンドウで関連付けを視覚化できます。

ソリューションエクスプローラのスクリーンショット

関連するソースコードファイル間の関連付けは、次に示すように DependentUpon および SubType メタデータによって作成されます。

<Project ... >
  ...
  <ItemGroup>
    <ApplicationDefinition Include="App.xaml">
      <Generator>MSBuild:Compile</Generator>
      <SubType>Designer</SubType>
    </ApplicationDefinition>
    <Page Include="Window1.xaml">
      <Generator>MSBuild:Compile</Generator>
      <SubType>Designer</SubType>
    </Page>
    <Compile Include="App.xaml.cs">
      <DependentUpon>App.xaml</DependentUpon>
      <SubType>Code</SubType>
    </Compile>
    <Compile Include="Window1.xaml.cs">
      <DependentUpon>Window1.xaml</DependentUpon>
      <SubType>Code</SubType>
    </Compile>
  </ItemGroup>
  ...
</Project>

このプロジェクトでは、App.xaml (マークアップ) は App.xaml.cs (分離コード) に関連付けられ、Window1.xaml (マークアップ) は Window1.xaml.cs (分離コード) に関連付けられます。

既定のプロジェクトプロパティ、リソース、および設定の管理

Visual Studio では、Visual Studio プロジェクトのプロパティを視覚的に編集できます。このプロパティの大部分はビルドプロセスに影響を与え、Visual Studio が管理する Visual Studio プロジェクトファイルに格納されます。また、Windows Presentation Foundation (WPF) プロジェクトテンプレートはファイルを生成して、厳密に型指定された設定やリソースのサポートを提供します。これを次の図に示します。

ソリューションエクスプローラのスクリーンショット

これは、次のようにして、MSBuild プロジェクトファイルによって管理されます。

<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
  ...
  <ItemGroup>
    <Compile Include="Properties\AssemblyInfo.cs">
      <SubType>Code</SubType>
    </Compile>
    <Compile Include="Properties\Resources.Designer.cs">
      <AutoGen>True</AutoGen>
      <DesignTime>True</DesignTime>
      <DependentUpon>Resources.resx</DependentUpon>
    </Compile>
    <Compile Include="Properties\Settings.Designer.cs">
      <AutoGen>True</AutoGen>
      <DependentUpon>Settings.settings</DependentUpon>
      <DesignTimeSharedInput>True</DesignTimeSharedInput>
    </Compile>
    <EmbeddedResource Include="Properties\Resources.resx">
      <Generator>ResXFileCodeGenerator</Generator>
      <LastGenOutput>Resources.Designer.cs</LastGenOutput>
      <SubType>Designer</SubType>
    </EmbeddedResource>
    <None Include="Properties\Settings.settings">
      <Generator>SettingsSingleFileGenerator</Generator>
      <LastGenOutput>Settings.Designer.cs</LastGenOutput>
    </None>
    <AppDesigner Include="Properties\" />
  </ItemGroup>
  ...
</Project>

WPF の MSBuild プロジェクトのビルド

MSBuild プロジェクトは、コマンドプロンプトまたは Visual Studio からビルドできます。

コマンドプロンプトからの WPF の MSBuild プロジェクトのビルド

MSBuild プロジェクトは、Windows のコマンドプロンプトまたは Windows ソフトウェア開発キット (SDK) のコマンドプロンプトから msbuild.exe を呼び出してビルドできます。

プロジェクトのビルド

MSBuild プロジェクトをビルドするには、目的の MSBuild プロジェクトのファイル名を渡して msbuild.exe を実行します。

msbuild.exe msbuildprojectfile.proj

Visual Studio で生成された言語固有のプロジェクトのビルド

Visual Studio で生成された言語固有の MSBuild プロジェクトファイルには、次のような特徴があります。

ファイル拡張子 (.csproj、.vbproj) が関連付けられている。
言語固有のターゲット (Microsoft.CSharp.targets、Microsoft.VisualBasic.targets) が含まれている。

コマンドプロンプトから C# プロジェクトをビルドする方法を次に示します。

msbuild.exe VSGeneratedProjectFileForCSharp.csproj

コマンドプロンプトから Visual Basic プロジェクトをビルドする方法を次に示します。

msbuild.exe VSGeneratedProjectFileForVisualBasic.vbproj

Visual Studio で生成されたソリューションのビルド

msbuild.exe は、Visual Studio で生成されたソリューションファイル (.sln) もビルドします。

msbuild.exe VSGeneratedSolutionFile.sln

Visual Studio での WPF の MSBuild プロジェクトのビルド

Visual Studio を使用している場合は、プロジェクトとソリューションをコマンドプロンプトからビルドする必要はありません。Visual Studio では、プロジェクトとソリューションを IDE からビルドできます。

Visual Studio でのプロジェクトのビルド

Visual Studio でプロジェクトをビルドするには、[ソリューションエクスプローラ] ウィンドウでプロジェクトを右クリックし、[ビルド] をクリックします。

Visual Studio でのソリューションのビルド

ソリューションをビルドするには、次のいずれかの操作を行います。

F6 キーを押してソリューションをビルドします。
F5 キーを押してソリューションのデバッグを開始します。
[ビルド]、[ソリューションのビルド] の順にクリックします。
[デバッグ]、[デバッグ開始] の順にクリックします。
[デバッグ]、[デバッグなしで開始] の順にクリックします。

プロジェクトまたはソリューションに対してこのいずれかを実行すると、Visual Studio によって msbuild.exe が実行され、適切な MSBuild ファイルがビルドされます。

Windows Presentation Foundation のビルドパイプライン

WPF プロジェクトがビルドされると、言語固有のターゲットと WPF 固有のターゲットの組み合わせが呼び出されます。これらのターゲットを実行するプロセスをビルドパイプラインと呼びます。主要な手順を次の図に示します。

WPF ビルド処理

これらの手順の詳細については以降のセクションで説明します。

ビルド前の初期化

ビルドを実行する前に、MSBuild は、次のような主要なツールおよびライブラリの場所を確認します。

.NET Framework です。
Windows SDK ディレクトリ。
WPF 参照アセンブリの場所。
アセンブリ検索パスのプロパティ。

参照アセンブリディレクトリ (%ProgramFiles%\Reference Assemblies\Microsoft\Framework\v3.0\) は、アセンブリが最初に検索される場所です。また、この手順では、ビルドプロセスがさまざまなプロパティおよび項目のグループを初期化し、必要なクリーンアップ作業を実行します。

参照の解決

ビルドプロセスは、アプリケーションプロジェクトのビルドに必要なアセンブリを探してバインディングします。このロジックは、ResolveAssemblyReference タスクに含まれます。プロジェクトファイル内で Reference として宣言されたすべてのアセンブリは、検索パスに関する情報と、既にシステムにインストールされているアセンブリのメタデータと共にタスクに渡されます。タスクはアセンブリを検索し、インストールされているアセンブリのメタデータを使用して、出力マニフェストに含める必要のないコアの WPF アセンブリをフィルタして除外します。これは、ClickOnce マニフェストで情報が重複するのを避けるために行われます。たとえば、PresentationFramework.dll は WPF でビルドされた代表的なアプリケーションと見なすことができ、また、すべての WPF アセンブリは .NET Framework がインストールされているすべてのコンピュータで同じ場所に存在するため、マニフェストにすべての .NET Framework 参照アセンブリに関するすべての情報を含める必要はありません。

マークアップコンパイルのパス 1

この手順では、XAML ファイルを解析してコンパイルし、ランタイムが XML の解析やプロパティ値の検証などに時間を費やさずに済むようにします。コンパイル済みの XAML ファイルを事前にトークン化するため、実行時の読み込みは XAML ファイルを読み込むよりもはるかに短時間で終わります。

この手順では、Page ビルド項目である XAML ファイルごとに次のアクティビティが実行されます。

XAML ファイルがマークアップコンパイラによって解析されます。
対象の XAML に対してコンパイル済みの形式が作成され、obj\Release フォルダにコピーされます。
新しい部分クラスの CodeDOM 形式が作成され、obj\Release フォルダにコピーされます。

さらに、言語固有のコードファイルが XAML ファイルごとに生成されます。たとえば、Visual Basic プロジェクトの Page1.xaml ページに対して Page1.g.vb が生成され、C# プロジェクトの Page1.xaml ページに対して Page1.g.cs が生成されます。ファイル名に含まれる ".g" は、ファイルが生成されたコードであり、マークアップファイルのトップレベルの要素 (Page、Window など) に対する部分クラス宣言を持つことを示しています。クラスは C# でpartial修飾子 (Visual Basic では Extends) を指定して宣言され、他の場所に別のクラス宣言があることを示します。通常は分離コードファイル Page1.xaml.cs 内です。

部分クラスは該当の基本クラスから拡張され (ページの Page など)、System.Windows.Markup.IComponentConnector インターフェイスを実装します。IComponentConnector インターフェイスには、コンポーネントを初期化し、コンテンツ内の要素の名前とイベントを結び付けるメソッドがあります。そのため、生成されたコードファイルには次のようなメソッド実装が含まれます。

public void InitializeComponent() {
    if (_contentLoaded) {
        return;
    }
    _contentLoaded = true;
    System.Uri resourceLocater = 
        new System.Uri(
            "window1.xaml", 
            System.UriKind.RelativeOrAbsolute);
    System.Windows.Application.LoadComponent(this, resourceLocater);
}

既定で、マークアップコンパイルは MSBuild エンジンと同じ AppDomain 内で実行されます。これにより、パフォーマンスが大幅に向上します。この動作は、AlwaysCompileMarkupFilesInSeparateDomain プロパティで切り替えられます。切り替えた場合、別の AppDomain をアンロードすることにより、すべての参照アセンブリをアンロードするという利点があります

マークアップコンパイルのパス 2

マークアップコンパイルのパス 1 ですべての XAML ページがコンパイルされるとは限りません。ローカルで定義された型参照 (つまり、同じプロジェクト内の他のコードで定義された型の参照) を含む XAML ファイルは、この時点ではコンパイルから除外されます。これは、ローカルで定義された型はソース内にのみ存在し、まだコンパイルされていないためです。これを判別するために、パーサーはマークアップファイル内で x:Name などの項目を検索するヒューリスティックを使用します。このようなインスタンスが見つかると、そのマークアップファイルのコンパイルはコードファイルがコンパイルされるまで延期されます。その後、2 回目のマークアップコンパイルパスでこれらのファイルが処理されます。

ファイルの分類

ビルドプロセスは、配置するアプリケーションアセンブリに基づいて出力ファイルを別のリソースグループに配置します。通常、ローカライズされないアプリケーションでは、Resource とマークされたすべてのデータファイルはメインアセンブリ (実行可能ファイルまたはライブラリ) に配置されます。UICulture がプロジェクト内に設定されると、コンパイル済みのすべての XAML ファイルおよび言語固有と明示的にマークされたリソースは、サテライトリソースアセンブリに配置されます。また、言語に依存しないすべてのリソースは、メインアセンブリに配置されます。ビルドプロセスのこの手順で、この決定が行われます。

プロジェクトファイル内の ApplicationDefinition、Page、および Resource ビルドアクションは、Localizable メタデータで拡張できます (入力可能値は true および false)。これにより、ファイルが言語固有か、言語に依存しないかを指定します。

コアコンパイル

コアコンパイルの手順では、コードファイルをコンパイルします。これは、Microsoft.CSharp.targets や Microsoft.VisualBasic.targets など、言語固有のターゲットファイル内のロジックによって調整されます。ヒューリスティックによってマークアップコンパイラの 1 回のパスでは不十分であることが判断されると、メインアセンブリが生成されます。ただし、プロジェクト内の 1 つ以上の XAML ファイルにローカルで定義された型の参照が含まれている場合は、一時的な .dll ファイルが生成されます。これにより、マークアップコンパイルの 2 回目のパスが完了すると、最終的なアプリケーションアセンブリが作成されます。

マニフェストの生成

ビルドプロセスの終わりに、すべてのアプリケーションアセンブリとコンテンツファイルの準備が整った後で、アプリケーションの ClickOnce マニフェストが生成されます。

配置マニフェストファイルには、配置モデル (現在のバージョン、更新動作、および発行元の ID とデジタル署名) が記述されています。このマニフェストは、配置を処理する管理者が作成します。ファイル拡張子は、XAML ブラウザアプリケーション (XBAP) を表す .xbap とインストール型のアプリケーションを表す .application です。前者は HostInBrowser プロジェクトプロパティによって指定されるため、マニフェストはアプリケーションがブラウザによってホストされることを識別します。

アプリケーションマニフェスト (.exe.manifest ファイル) には、アプリケーションアセンブリ、依存ライブラリ、およびアプリケーションで必要なアクセス許可のリストが記述されています。このファイルは、アプリケーション開発者が作成します。ClickOnce アプリケーションを起動するには、ユーザーはアプリケーションの配置マニフェストファイルを開きます。

これらのマニフェストファイルは、常に XBAP 用に作成されています。インストール型のアプリケーションでは、プロジェクトファイル内で GenerateManifests プロパティ値を true に指定しない限り作成されません。

XBAP は、一般的なインターネットゾーンアプリケーションに割り当てられるこれらの許可のほかに、2 つの追加の許可を取得します。追加の許可とは、WebBrowserPermission と MediaPermission です。WPF のビルドシステムは、アプリケーションマニフェストでこれらのアクセス許可を宣言します。

インクリメンタルビルドのサポート

WPF のビルドシステムは、インクリメンタルビルドをサポートします。これは、マークアップやコードの変更を検出し、変更の影響を受けるアイテムだけをコンパイルするという高度な機能です。インクリメンタルビルドメカニズムでは、次のファイルを使用します。

$(AssemblyName)_MarkupCompiler.Cache ファイル。現在のコンパイラの状態を保持します。
$(AssemblyName)_MarkupCompiler.lref ファイル。ローカルで定義された型への参照を持つ XAML ファイルをキャッシュします。

インクリメンタルビルドの規則を次に示します。

ビルドシステムが変更を検出できるのは、ファイル単位以上です。そのため、コードファイルの場合、ビルドシステムは型が変更されたかどうか、またはコードが追加されたかどうかを通知できません。同じことはプロジェクトファイルにも当てはまります。
インクリメンタルビルドのメカニズムは、XAML ページがクラスを定義するのか、他のクラスを使用するのかを認識していなければなりません。
Reference のエントリが変更された場合は、すべてのページを再コンパイルします。
コードファイルが変更された場合は、ローカルで定義された型参照を含むすべてのページを再コンパイルします。
XAML ファイルが変更された場合 :
- XAML がプロジェクトで Page として宣言されている場合 : XAML にローカルで定義された型参照がなければ、その XAML とローカル参照を含むすべての XAML ページを再コンパイルします。XAML にローカル参照があれば、ローカル参照を含むすべての XAML ページを再コンパイルします。
- XAML がプロジェクト内で ApplicationDefinition として宣言されている場合 : すべての XAML ページを再コンパイルします (それぞれの XAML に、変更された可能性のある Application 型への参照があるため)。
プロジェクトファイルで、XAML ファイルではなくコードファイルをアプリケーション定義として宣言している場合 :
- プロジェクトファイル内の ApplicationClassName 値が変更されたかどうかを確認します (たとえば、新しいアプリケーションの種類があるかどうか)。その場合は、アプリケーション全体を再コンパイルします。
- または、ローカル参照を含むすべての XAML ページを再コンパイルします。
プロジェクトファイルが変更された場合は、上記のすべての規則を適用し、再コンパイルする必要があるものを確認します。次のプロパティが変更されると、全体の再コンパイルが実行されます : AssemblyName、IntermediateOutputPath、RootNamespace、および HostInBrowser。

次の再コンパイルのシナリオが考えられます。

アプリケーション全体が再コンパイルされます。
ローカルで定義された型参照を含む XAML ファイルだけが再コンパイルされます。
再コンパイルされるものはありません (プロジェクト内で変更が加えられていない場合)。

参照

概念

WPF アプリケーションの配置 (WPF)

Windows Presentation Foundation におけるパッケージの URI

Windows Presentation Foundation アプリケーションのリソース、コンテンツ、およびデータファイル

その他の技術情報

Windows Presentation Foundation MSBuild のリファレンス

履歴の変更

日付	履歴	原因
2008 年 7 月	SplashScreen ビルドプロパティに関する情報を追加。	SP1 機能変更

2008 年 7 月

SplashScreen ビルドプロパティに関する情報を追加。

SP1 機能変更

次の方法で共有

WPF アプリケーション (WPF) のビルド

コマンドラインコンパイルによる WPF アプリケーションのビルド

MSBuild による WPF アプリケーションのビルド

WPF の MSBuild プロジェクトファイル

Project 要素

プロパティ

項目

ターゲット

処理手順

Windows Presentation Foundation MSBuild プロジェクトサンプル

Visual Studio を使用した WPF の MSBuild プロジェクトの作成

プロジェクト構成

ビルド構成

ソースコードファイルの関連付け

既定のプロジェクトプロパティ、リソース、および設定の管理

WPF の MSBuild プロジェクトのビルド

コマンドプロンプトからの WPF の MSBuild プロジェクトのビルド

プロジェクトのビルド

Visual Studio で生成された言語固有のプロジェクトのビルド

Visual Studio で生成されたソリューションのビルド

Visual Studio での WPF の MSBuild プロジェクトのビルド

Visual Studio でのプロジェクトのビルド

Visual Studio でのソリューションのビルド

Windows Presentation Foundation のビルドパイプライン

ビルド前の初期化

参照の解決

マークアップコンパイルのパス 1

マークアップコンパイルのパス 2

ファイルの分類

コアコンパイル

マニフェストの生成

インクリメンタルビルドのサポート

参照

概念

その他の技術情報

履歴の変更

その他のリソース

次の方法で共有

WPF アプリケーション (WPF) のビルド

コマンド ライン コンパイルによる WPF アプリケーションのビルド

MSBuild による WPF アプリケーションのビルド

WPF の MSBuild プロジェクト ファイル

Project 要素

プロパティ

項目

ターゲット

処理手順

Windows Presentation Foundation MSBuild プロジェクト サンプル

Visual Studio を使用した WPF の MSBuild プロジェクトの作成

プロジェクト構成

ビルド構成

ソース コード ファイルの関連付け

既定のプロジェクト プロパティ、リソース、および設定の管理

WPF の MSBuild プロジェクトのビルド

コマンド プロンプトからの WPF の MSBuild プロジェクトのビルド

プロジェクトのビルド

Visual Studio で生成された言語固有のプロジェクトのビルド

Visual Studio で生成されたソリューションのビルド

Visual Studio での WPF の MSBuild プロジェクトのビルド

Visual Studio でのプロジェクトのビルド

Visual Studio でのソリューションのビルド

Windows Presentation Foundation のビルド パイプライン

ビルド前の初期化

参照の解決

マークアップ コンパイルのパス 1

マークアップ コンパイルのパス 2

ファイルの分類

コア コンパイル

マニフェストの生成

インクリメンタル ビルドのサポート

参照

概念

その他の技術情報

履歴の変更

その他のリソース

コマンドラインコンパイルによる WPF アプリケーションのビルド

WPF の MSBuild プロジェクトファイル

Windows Presentation Foundation MSBuild プロジェクトサンプル

ソースコードファイルの関連付け

既定のプロジェクトプロパティ、リソース、および設定の管理

コマンドプロンプトからの WPF の MSBuild プロジェクトのビルド

Windows Presentation Foundation のビルドパイプライン

マークアップコンパイルのパス 1

マークアップコンパイルのパス 2

コアコンパイル

インクリメンタルビルドのサポート