Visual Studio 集成 (MSBuild)

Visual Studio 2005 承载 MSBuild 以加载和生成托管项目。 由于 MSBuild 负责处理项目,因此,可以在 Visual Studio 中成功使用几乎任何 MSBuild 格式的项目(即使项目是用另一种工具编写的,而且这些项目有自定义的生成过程)。

自定义希望在 Visual Studio 中加载和生成的项目和 .targets 文件时,应当考虑 Visual Studio 的 MSBuild 承载的特定方面,本主题对此进行了描述。 这些内容将帮助您确保 Visual Studio 中诸如 IntelliSense 和调试这样的功能对您的自定义项目有效。

项目文件扩展名

MSBuild.exe 可识别与 .*proj 模式匹配的任何项目文件扩展名。 但是,Visual Studio 只识别其中一部分项目文件扩展名,这些扩展名决定了将会加载项目的特定于语言的项目系统。 Visual Studio 没有基于非特定语言 MSBuild 的项目系统。

例如,Visual C# 项目系统可加载 .csproj 文件,但是 Visual Studio 不能加载 .xxproj 文件。 任意语言的源文件对应的项目文件都必须使用与 Visual Basic 或 Visual C# 项目文件相同的扩展名,才能加载到 Visual Studio 中。

已知的目标名称

在 Visual Studio 中单击**“生成”命令将执行项目中的默认目标。 通常,此目标也命名为 Build。 如果选择“重新生成”“清理”命令,将尝试执行项目中的同名目标。 单击“发布”**将执行项目中的名为 PublishOnly 的目标。

配置和平台

在 MSBuild 项目中,配置由在包含 Condition 特性的 PropertyGroup 元素中进行分组的属性来表示。 为了创建要显示的项目配置和平台的列表,Visual Studio 将检查这些条件。 若要成功提取此列表,条件必须具有如下格式:

Condition=" '$(Configuration)|$(Platform)' == 'Debug|AnyCPU' "
Condition=" '$(Configuration)' == 'Release' " 
Condition=" '$(Something)|$(Configuration)|$(SomethingElse)' == 'xxx|Debug|yyy' "

为了达到这个目的,Visual Studio 将针对 PropertyGroupItemGroupImport、属性和项元素检查条件。

其他生成操作

Visual Studio 允许您使用“文件属性”窗口的**“生成操作”**属性来更改项目中文件的项类型名称。 CompileEmbeddedResourceContentNone 项类型名称始终会在此菜单中列出,此菜单中同时还会列出项目中已有的任何其他项类型名称。 若要确保任何自定义的项类型名称在此菜单中始终可用,可以将这些名称添加到名为 AvailableItemName 的项类型。 例如,如果在项目文件中添加下面的内容,就会为导入它的所有项目在此菜单中添加自定义类型 JScript:

<ItemGroup>
    <AvailableItemName Include="JScript"/>
</ItemGroup>

提示

某些项类型名称是 Visual Studio 所特有的,但没有在此下拉列表中列出。

进程内编译器

如果可能,Visual Studio 将尝试使用 Visual Basic 或 Visual C# 编译器的进程内版本,以便提高性能。 为了让它正确工作,必须满足下面的条件:

  • 在项目的目标中,必须有名为 Csc(对于 Visual C# 项目)或名为 Vbc(对于 Visual Basic 项目)的任务。

  • 任务的 UseHostCompilerIfAvailable 参数必须设置为 True。

  • 只有受支持的参数值才必须指定。 进程内编译器支持为任务指定的所有参数,但是某些参数值不受支持。 Visual C# 进程内编译器不支持下面的 Csc 任务参数值:

    • NoConfig:false 和空值不受支持。

    • ResponseFiles:非空值不受支持。

    • AdditionalLibPaths:非空值不受支持。

    • AddModules:非空值不受支持。

    • CodePage:非零值不受支持。

    • GenerateFullPaths:true 不受支持。

    • LinkResources:非空值不受支持。

如果不满足这些条件,则需要使用命令行编译器(而不是进程内编译器)来编译项目。

设计时 IntelliSense

在生成过程生成输出程序集之前,若要在 Visual Studio 中获得 IntelliSense 支持,必须满足下面的条件:

  • 必须有名为 Compile 的目标。

  • Compile 目标或它的一个依赖项必须调用该项目的编译器任务,例如,CscVbc

  • Compile 目标或它的一个依赖项必须导致编译器接收使用 IntelliSense 所需的所有参数,特别是所有引用。

  • “进程内编译器”部分中列出的条件必须满足。

生成解决方案

在 Visual Studio 中,解决方案文件和项目生成顺序由 Visual Studio 本身进行控制。 在命令行用 msbuild.exe 生成解决方案时,MSBuild 将分析解决方案文件,并对项目生成进行排序。 在这两种情况下,项目都将按依赖顺序逐个生成,因此,不会来回进行项目到项目的引用。 相比之下,用 msbuild.exe 生成单个项目时,则会来回进行项目到项目的引用。

在 Visual Studio 内生成时,属性 $(BuildingInsideVisualStudio) 将设置为 true。 这可以用在项目或 .targets 文件中,使生成行为有所不同。

显示属性和项

Visual Studio 可识别某些属性名称和值。 例如,项目中下面的属性将导致**“Windows 应用程序”出现在“项目设计器”内的“应用程序类型”**框中。

<OutputType>WinExe</OutputType>

可以在**“项目设计器”**中编辑属性值,并将其保存在项目文件中。 如果通过手动编辑来为这样的属性分配了无效的值,则 Visual Studio 在加载项目时会显示一条警告,并会用默认值替代无效值。

Visual Studio 知道某些属性的默认值。 这些属性不会保留到项目文件中,除非它们有非默认的值。

具有任意名称的属性不会显示在 Visual Studio 中。 若要在 Visual Studio 中修改任意属性,必须在 XML 编辑器中打开项目文件,并手动编辑它们。 有关更多信息,请参见!!!测试开始[How To:]测试结束!!!!!!测试开始[Edit Project Files]测试结束!!!

默认情况下,在项目中定义的具有任意项类型名称的项将会显示在解决方案资源管理器中其项目节点的下面。 若要隐藏项,请将 Visible 元数据设置为 false。 例如,下面的项将参与生成过程,但不会显示在解决方案资源管理器中。

<ItemGroup>
    <IntermediateFile Include="cache.temp">
        <Visible>false</Visible>
    </IntermediateFile>
</ItemGroup>

默认情况下,不会显示在导入到项目内的文件中所声明的项。 在生成过程中创建的项永远不会显示在解决方案资源管理器中。

项和属性的条件

在生成期间,将严格检查所有条件。

在确定要显示的属性值时,会以不同的方式来计算 Visual Studio 认为依赖于配置的属性和它认为独立于配置的属性。 对于它认为依赖于配置的属性,Visual Studio 将相应地设置 ConfigurationPlatform 属性,并指示 MSBuild 重新计算项目。 对于它认为独立于配置的属性,计算条件的方式则是不确定的。

如果项的条件表达式用于决定是否应当在解决方案资源管理器中显示项,则始终忽略这样的表达式。

调试

为了查找和启动输出程序集并附加调试器,Visual Studio 需要正确定义属性 OutputPath、AssemblyName 和 OutputType。 如果生成过程没有导致编译器生成 .pdb 文件,则调试器将无法附加。

设计时目标执行

Visual Studio 加载项目时,它将尝试执行具有某些名称的目标。 这些目标包括 Compile、ResolveAssemblyReferences、ResolveCOMReferences、GetFrameworkPaths 和 CopyRunEnvironmentFiles。 Visual Studio 将运行这些目标,以便可以执行以下操作:初始化编译器以提供 IntelliSense,初始化调试器,以及解析在解决方案资源管理器中显示的引用。 如果这些目标不出现,项目将正确加载和生成,但是 Visual Studio 中的设计时体验将不会完全有效。

在 Visual Studio 中编辑项目文件

需要直接编辑 MSBuild 项目时,可以在 Visual Studio XML 编辑器中打开项目文件。 有关更多信息,请参见!!!测试开始[How To:]测试结束!!!!!!测试开始[Edit Project Files]测试结束!!!

IntelliSense 和验证

使用 XML 编辑器编辑项目文件时,IntelliSense 和验证由 MSBuild 架构文件驱动。 这些文件由 Visual Studio 安装在架构缓存中,您可以在 [Visual Studio 安装位置]\Xml\Schemas 文件夹中找到该缓存。

核心 MSBuild 类型是在 Microsoft.Build.Core.xsd 中定义的,Visual Studio 使用的通用类型则是在 Microsoft.Build.CommonTypes.xsd 中定义的。 若要自定义架构,以便设置针对自定义项类型名称、属性和任务的 IntelliSense 和验证,您可以编辑 Microsoft.Build.xsd,或创建包括 CommonTypes 或核心架构的自己的架构。 如果创建自己的架构,则必须使用**“属性”**窗口指引 XML 编辑器找到它。

编辑加载的项目文件

Visual Studio 将缓存项目文件和由项目文件导入的文件的内容。 如果编辑已加载的项目文件,Visual Studio 将自动提示您重新加载项目,以使更改生效。 但是,如果编辑由已加载的项目导入的文件,则没有重新加载的提示,并且您必须手动卸载并重新加载项目,以使更改生效。

输出组

Microsoft.Common.targets 中定义的一些目标的名称以 OutputGroups 或 OutputGroupDependencies 结尾。 Visual Studio 调用这些目标以获取项目输出的特定列表。 例如,SatelliteDllsProjectOutputGroup 目标创建将由一次生成过程创建的所有附属程序集的列表。 诸如发布、部署和项目到项目引用这样的功能将使用这些输出组。 没有定义它们的项目仍然可以在 Visual Studio 中加载和生成,但是某些功能可能无法正常工作。

引用解析

引用解析是使用项目文件中存储的引用项来查找实际程序集的过程。 Visual Studio 必须触发引用解析,才能在**“属性”**窗口中显示每个引用的详细属性。 下面的列表描述了三种类型引用和如何解析它们。

  • 程序集引用:

    项目系统调用具有已知名称 ResolveAssemblyReferences 的目标。 此目标应当产生具有项类型名称 ReferencePath 的项。 这些项中的每一个都应当有包含引用的完整路径的项规范(项的 Include 特性的值)。 除了下面的新元数据以外,项应当让来自输入项的所有元数据通过:

    • CopyLocal,指示程序集是否应当复制到输出文件夹中、设置为 True 还是 False。

    • OriginalItemSpec,包含引用的原始项规范。

    • ResolvedFrom,如果从 .NET Framework 目录解析它,则设置为“{TargetFrameworkDirectory}”。

  • COM 引用:

    项目系统调用具有已知名称 ResolveCOMReferences 的目标。 此目标应当产生具有项类型名称 ComReferenceWrappers 的项。 这些项中的每一个都应当有项规范,其中包含 COM 引用的 interop 程序集的完整路径。 除了具有名称 CopyLocal(用于指示程序集是否应当复制到输出文件夹中、设置为 true 还是 false)的新元数据以外,项应当让来自输入项的所有元数据通过。

  • 本机引用

    项目系统调用具有已知名称 ResolveNativeReferences 的目标。 此目标应当产生具有项类型名称 NativeReferenceFile 的项。 除了名为 OriginalItemSpec(包含引用的原始项规范)的新元数据片段以外,项应当让来自输入项的所有元数据通过。

性能快捷方式

在 Visual Studio 中,生成过程使用快速更新检查来改进性能。 在有些情况下,当自定义的生成创建轮流生成的文件时,快速更新检查无法正确标识更改的文件。 通过设置环境变量 DISABLEFASTUPTODATECHECK=1,需要更彻底更新检查的项目可以关闭快速检查。 或者,项目可在项目或项目导入的文件中将此变量设置为 MSBuild 属性。

请参见

参考

Item 元素 (MSBuild)

Property 元素 (MSBuild)

Target 元素 (MSBuild)

Csc 任务

Vbc 任务

其他资源

!!!测试开始[MSBuild Concepts]测试结束!!!