生成 WPF 应用程序 (WPF)

更新:2010 年 11 月

可以将 Windows Presentation Foundation (WPF) 应用程序生成为 .NET Framework 可执行文件 (.exe)、库 (.dll) 或这两种类型的程序集的组合。 本主题介绍如何生成 WPF 应用程序,并介绍生成过程的关键步骤。

本主题包括下列各节。

  • 生成 WPF 应用程序
  • WPF 生成管道
  • 增量生成支持
  • 相关主题

生成 WPF 应用程序

可以通过以下方式编译 WPF 应用程序:

WPF 生成管道

生成 WPF 项目时,将调用特定于语言的目标和特定于 WPF 的目标的组合。 执行这些目标的过程称为生成管线,下图阐释了其主要步骤。

WPF 生成过程

预生成初始化

进行生成之前,MSBuild 会确定重要工具和库的位置,其中包括:

  • .NET Framework。

  • Windows SDK 目录。

  • WPF 引用程序集的位置。

  • 程序集搜索路径的属性。

MSBuild 搜索程序集的第一个位置是引用程序集目录 (%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 文件,都将发生下列活动:

  1. 标记编译器对 XAML 文件进行分析。

  2. 为该 XAML 创建编译表示形式并将其复制到 obj\Release 文件夹。

  3. 创建新的分部类的 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);
}
Public Sub InitializeComponent() _

    If _contentLoaded Then
        Return
    End If

    _contentLoaded = True
    Dim resourceLocater As System.Uri = _
        New System.Uri("mainwindow.xaml", System.UriKind.Relative)

    System.Windows.Application.LoadComponent(Me, resourceLocater)

End Sub

默认情况下,标记编译在与 MSBuild 引擎相同的 AppDomain 中运行。 这样可以显著提高性能。 可以使用 AlwaysCompileMarkupFilesInSeparateDomain 属性切换此行为。 其优点是可以通过卸载单独的 AppDomain 来卸载所有引用程序集。

标记编译 — 第 2 趟

并非所有 XAML 页都在标记编译的第 1 轮即进行编译。 包含本地定义类型引用(引用同一项目中其他位置的代码中定义的类型)的 XAML 文件此时将免于编译。 这是因为这些本地定义的类型仅存在于源中,并且尚未进行编译。 分析器使用试探法来确定这一点,这需要在标记文件中查找 x:Name 之类的项。 如果找到这样的实例,则标记文件的编译将推迟至代码文件编译之后完成,此时,第二趟标记编译将处理这些文件。

文件分类

生成过程根据用于存放输出文件的应用程序集的不同,将这些文件放入不同的资源组中。 在典型的非本地化应用程序中,所有被标记为 Resource 的数据文件都放置在主程序集(可执行文件或库)中。 如果在项目中设置了 UICulture,则所有经过编译的 XAML 文件以及那些被专门标记为特定于语言的资源都放在附属资源程序集中。 此外,所有非特定语言的资源都放在主程序集中。 在生成过程的这一步骤中,将做出这一决定。

项目文件中的 ApplicationDefinition、Page 和 Resource 生成操作可以使用 Localizable 元数据(可接受的值为 true 和 false)进行扩充,此元数据指示该文件是特定于语言的还是非特定语言的。

核心编译

核心编译步骤包括代码文件的编译。 这是在特定于语言的目标文件 Microsoft.CSharp.targets 和 Microsoft.VisualBasic.targets 中的逻辑协调下进行的。 如果试探法确定标记编译器运行一趟就足够了,则生成主程序集。 但是,如果项目中的一个或多个 XAML 文件具有对本地定义类型的引用,则生成一个临时 .dll 文件,以便可以在第二趟标记编译完成之后创建最终的应用程序集。

清单生成

在生成过程的末尾,当所有应用程序集和内容文件都准备好之后,将生成应用程序的 ClickOnce 清单。

部署清单文件描述部署模型:当前版本、更新行为、发行者标识以及数字签名。 此清单应该由处理部署的管理员创作。 对于 XAML browser applications (XBAPs),文件扩展名为 .xbap;对于安装的应用程序,文件扩展名为 .application。 前者由 HostInBrowser 项目属性指示,因此,清单将应用程序标识为浏览器承载的应用程序。

应用程序清单(.exe.manifest 文件)描述应用程序集和依赖库,并列出应用程序所需的权限。 此文件应该由应用程序开发人员创作。 为了启动 ClickOnce 应用程序,用户应该打开应用程序的部署清单文件。

对于 XBAPs,始终会创建这些清单文件。 对于安装的应用程序,除非在项目文件中使用值 true 指定 GenerateManifests 属性,否则不会创建它们。

除了分配给典型的 Internet 区域应用程序的那些权限以外,XBAPs 还获得了两项额外的权限:WebBrowserPermissionMediaPermission。 WPF 生成系统在应用程序清单中声明这些权限。

增量生成支持

WPF 生成系统为增量生成提供了支持。 它相当智能地检测对标记或代码所做的更改,并且仅编辑那些受到更改影响的项目。 增量生成机制使用下列文件:

  • 一个 $(程序集名称)_MarkupCompiler.Cache 文件,用于保持当前编译器状态。

  • 一个 $(程序集名称)_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)

WPF 中的 Pack URI

WPF 应用程序资源、内容和数据文件

其他资源

WPF MSBuild 参考

修订记录

日期

修订记录

原因

2010 年 11 月

添加了缺少的 Visual Basic 示例。

内容 Bug 修复