使用默认模板定义生成
您可以使用默认模板，通过选择要生成的代码项目来快速定义基本生成。 还可以使用此模板，以包括更多高级功能（例如运行自动测试），并调整生成过程的各个方面以满足您团队的需求。
所需权限
若要执行此过程，必须将**“编辑生成定义”权限设置为“允许”**。 有关更多信息，请参见 Team Foundation Server 权限。
使用默认模板创建生成定义
在团队资源管理器中，单击您要在其中定义生成的团队项目。
在**“生成”菜单上，单击“新建生成定义”**。
在**“生成定义名称”**中，键入名称。
单击**“流程”**选项卡。
在**“生成过程模板”下，默认情况下已选中“默认模板”**。
在**“生成过程参数”下，展开“必需”**节点，并至少指定一个要生成的解决方案或项目。
有关更多信息，请参见本主题后面部分的指定要生成的项目。
使用本主题后面的信息完成那些可以提供您要放入此生成定义中的功能的相应字段。
完成**“流程”选项卡上的字段后，完成“触发器”、“工作区”、“生成默认值”和“保持策略”**选项卡中的字段。
有关更多信息，请参见指定生成触发器和原因、使用生成工作区和创建基本生成定义。
主题内容
关于默认模板的生成过程参数
指定要生成的项目
指定要生成的平台和配置
指定哪些生成代理处理您的生成
指定生成代理时间限制
运行自动化测试和启用测试影响分析
指定基本生成过程参数
指定高级生成过程参数
关于默认模板的生成过程参数
本主题说明如何通过在基于默认模板的生成中使用生成过程参数来定义生成。 本主题中的信息介绍了在满足以下条件的情况下应与 Visual Studio Application Lifecycle Management (ALM) 匹配的功能：
您正在处理的团队项目是从 Visual Studio ALM 附带的两个过程模板之一创建的：MSF for Agile Software Development 5.0 版或 MSF for CMMI Process Improvement 5.0 版。
团队中的任何人都未删除或自定义默认模板。
指定要生成的项目
在**“要生成的项目”框中，您可以指定要生成的一个或多个解决方案或项目。 （若要显示此框，请展开“必需”节点，然后展开“要生成的项”**节点。）您必须指定至少一个解决方案或项目。
如果正在生成多个相关项目，通常应将它们添加到单一解决方案，并在**“要生成的项目”**框中指定该解决方案，而不是分别列出每个项目。
在**“要生成的项目”对话框中，您可单击省略号按钮 (...) 打开并使用“解决方案/项目”**对话框指定要生成的解决方案或项目。
若要手动填写**“要生成的项目”**框，您可指定要生成的每个项目或解决方案的完整版本控制路径。 使用逗号分隔每个值，如以下示例所示：
$/Features/FeatureA/Server/All Server Projects.sln, $/Features/FeatureA/Client/All Client Projects.sln
.gif "重要说明") 重要事项 |
|---|
确保每个项目或解决方案的路径是生成定义的“工作区”选项卡上所列的任一“源代码管理文件夹”值的子路径。 |
指定要生成的平台和配置
在**“要生成的配置”框中，您可以指定要生成哪些平台和配置。 （若要显示此框，请展开“必需”节点，然后展开“要生成的项”**节点。）例如，您可以通过在此框中包含“Release|x86”，来指定此生成应只生成 32 位版本 C++ 项目的发布配置。
提示
如果您的基本代码较大，则可以通过只生成所需配置和平台来显著提高生成处理速度。
如果保留**“要生成的配置”**框为空，则将生成每个解决方案或项目中定义的默认配置和平台。
在**“要生成的项”框中，您可单击省略号按钮 (...) 打开并使用“配置”**对话框指定要生成的项。 也可以手动指定这些项。
**“要生成的配置”**框中的每个配置应为以下形式：
配置|平台
必须替换以下占位符：
配置是一个值，例如“调试”、“发布”或“所有配置”。
平台是一个值，例如“Win32”、“x86”、“x64”或“任意 CPU”。
列表中的配置必须以逗号分隔。
例如，如果要为 C# 项目生成“调试”和“发布”配置，您应在**“要生成的配置”**框中指定“调试|任意 CPU”、“发布|任意 CPU”。
配置和平台所使用的标记必须与解决方案属性或代码项目属性中设置的标记相符。 如果不相符，则在生成完成时可能会出现意外结果。
指定哪些生成代理处理您的生成
若要指定使用哪些生成代理来处理生成，请展开**“高级”节点，再展开“代理设置”**节点，然后指定以下参数值：
名称筛选器：您可以通过在此字段中键入代理名称，来筛选用于处理此生成定义的生成代理。 还可以使用 * 和 ? 通配符指定一系列名称。 例如，可以指定 CI* 来指定名称以字符 CI 开始的任何代理。 符合此条件的代理包括 CI、CI1 或 CI_Agent2。
标记筛选器：指定一个或多个标记，以确保只有符合标记的生成代理将运行此生成。 出于特定目的，通常您会对某些生成代理应用标记以保留这些代理。 例如，在生成计算机上设置一个旨在处理封闭签入生成的生成代理。 将封闭的标记应用到此生成代理。 最后，将封闭的标记应用到生成定义，以便对仅由该代理处理的定义也使用封闭的标记进行标记。 若要指定标记，可单击省略号按钮 (...)。
提示
可用于处理此生成的一组生成代理由已为此生成定义指定的生成控制器确定。 若要修改生成控制器，请单击“生成默认值”选项卡，打开“生成控制器”菜单，然后单击生成控制器。
“标记比较运算符”：在菜单上，单击以下值之一：
“MatchExactly”：如果您只希望由包含您在**“标记筛选器”**框中指定的同一标记集的生成代理处理此生成定义，请单击此值。 如果您未指定任何标记，则任何代理均可处理此生成定义。
提示
通过单击“MatchExactly”，将可用于此生成定义的代理限制为包含与“标记筛选器”字段中的标记集完全相同的标记集的代理。
“MatchAtLeast”：如果您只希望由至少包含您在**“标记筛选器”**框中指定的同一标记集的任何生成代理处理此生成定义，请单击此值。 如果您未指定任何标记，则只有不包含任何标记的代理才可处理此生成定义。
指定生成代理时间限制
若要指定时间限制，请展开**“高级”节点，再展开“代理设置”**节点，然后在下表中指定参数。
若希望... |
然后设置此参数... |
使用本指南... |
|---|---|---|
指定允许生成代理处理生成的最长时间 |
最长执行时间 |
按照 hh:mm:ss 格式键入时间跨度值。 例如，如果指定值 04:30:15，并且在 4 小时 30 分钟 15 秒之后未完成生成代理，则该生成将由于超时错误而失败。 如果想要生成代理处理生成时不受时间限制，则指定值 00:00:00。 |
指定允许向生成代理指派生成请求的最长时间 |
最长等待时间 |
按照 hh:mm:ss 格式键入时间跨度值。 例如，如果指定值 01:30:45，并且在 1 小时 30 分钟 45 秒之后尚未将生成指派给生成代理，则该生成将由于超时错误而失败。 如果您想要生成控制器查找用于处理此生成定义的生成代理不受时间限制，则指定值 00:00:00。 |
运行自动化测试和启用测试影响分析
您可将生成设计为执行一个或多个自动化测试运行，并分析代码更改对测试的影响。 有关更多信息，请参见使用生成系统运行测试。
指定基本生成过程参数
要在某些常见情形下成功完成生成，通常必须修改**“基本”**节点中的生成过程参数。
若希望... |
然后设置此参数... |
使用本指南… |
|---|---|---|
自定义用于命名已完成生成的约定 |
内部版本号格式 |
您和您的团队可以将有用数据加载到每个已完成生成。 有关更多信息，请参见使用生成号。 若要自定义此参数，您可以直接在此字段中键入文本。 不过，通过单击省略号按钮 (...) 打开并使用“BuildNumber 格式编辑器”对话框，您可更轻松地修改此值并显示可用标记。 在此对话框中，单击“宏”以显示并插入您要使用的标记。 |
指定是否以及如何在处理生成之前清理生成代理的工作区 |
清理工作区 |
在此菜单上，单击以下值之一：
.gif "提示") 提示
如果生成过程不需要“全部”选项执行的额外清除，则通过指定“无”（最快的选项）或“输出”，可显著减少运行生成所需的时间。
|
指定生成日志的详细级别 |
日志记录详细级别 |
虽然生成信息对团队来说很重要，但是记录过多信息的生成过程可能会导致问题。 这类问题可以包括耗尽服务器存储和 CPU 资源，减慢服务器性能，以及使客户端计算机上的生成结果窗口中的用户体验降级。 您可控制 Team Foundation Server 必须处理、存储和显示的信息量。 有关更多信息，请参见管理生成信息和控制详细级别。 |
分析您的代码以查找常见缺陷 |
执行代码分析 |
在此菜单上，单击以下值之一：
有关更多信息，请参见下列主题之一： |
存储您的符号以启用历史调试等功能 |
“编制源索引”和“发布符号的路径” |
您可以配置您的生成定义以发布符号数据，从而启用历史调试等功能。 有关更多信息，请参见发布符号数据。 |
指定高级生成过程参数
要在某些不太常见的情形下成功完成生成，需要修改**“高级”**节点中提供的生成过程参数。
若希望... |
然后设置此参数... |
使用本指南… |
|---|---|---|
对照层关系图验证您的代码 |
MSBuild 参数 |
在此参数值中包括以下字符串：/p:ValidateArchitecture=true。 有关更多信息，请参见如何：对照层关系图验证 .NET 代码。 |
指定要传递到 MS Build 的命令行参数 |
MSBuild 参数 |
如果生成过程需要将参数传递到 MSBuild，则在“MSBuild 参数”参数中键入这些参数。 有关更多信息，请参见 MSBuild 命令行参考。 |
将每个已完成的生成与已转为代码的所有变更集及其关联的工作项相链接 |
将变更集与工作项相关联 |
在大多数情况下，最佳做法是将此参数设置为“True”（默认值）。 尤其是对于已计划的生成（例如每夜生成）更应采取此做法，因为通常使用已成功完成的已计划生成来确认修补程序或运行其他测试。 每个生成定义均维护其自己的记录，其中包含等待与下一个已完成的生成相关联的变更集和工作项。 例如，变更集 382 由生成 A 和生成 B 生成。 生成 A 已排队，并已成功完成。 生成 B 已排队，并失败。 变更集 382 现在与生成 A 的成功完成生成和生成 B 的失败完成生成相链接。变更集 382 将不会与生成 A 的下一个已完成生成相链接，但它将与生成 B 的下一个已完成生成相链接。 |
将生成项目时所产生的可执行文件和其他二进制文件复制到放置文件夹 |
将输出复制到放置文件夹 |
将此参数设置为“True”可将生成项目时所产生的可执行文件和其他二进制文件复制到放置文件夹。 注意
放置文件夹是在“生成默认值”选项卡中指定的。
|
在生成失败时创建工作项 |
在失败时创建工作项 |
如果您希望系统在生成失败时创建工作项，请将此参数设置为“True”。 |
生成源代码的特定版本 |
获取版本 |
指定用于标识要生成的版本的 versionspec。 有关 versionspecs 的更多信息，请参见命令行语法（版本控制）。 |
标记已编译到每个已完成生成的每个文件的版本 |
标记源 |
如果希望系统为每个源代码文件进行标记，则将此参数设置为“True”。 此操作使您的团队能轻松标识已完成生成中包含的每个文件的版本。 |
指定用于处理生成的 MSBuild 版本的位数 |
MSBuild 平台 |
指定下列值之一：
|