单个 TFS 2010 构建定义可以用于多个分支吗？

Question

我负责我们产品的构建，并被要求提出一种自定义现有构建定义的方法，以在需要时构建不同的分支。

该产品的构建过程已经有几个自定义步骤和操作，并且该产品有大量已构建的项目文件，因此为创建的每个新分支设置新的构建定义是无效的。

构建定义设置为从主分支构建。目的是输入特定分支（使用构建排队时可以输入的工作流参数），然后将构建该分支而不是默认的主分支，而无需编辑构建定义。

我有一个单独的测试程序，用于测试所有自定义构建活动和过程。在此构建定义的工作流程中，我添加了相当多的构建消息用于记录目的，以便我可以查看构建过程中使用的变量的值。

我还基于此测试程序创建了一个分支，准备测试构建定义，该定义可用于首先构建多个分支

，我从原始分支运行原始测试解决方案的项目文件的构建，然后更改了构建定义，以便使用新分支完成相同的操作并运行另一个构建。当比较两个分支之间的构建日志时，它们之间只有一些细微的差异。 （记录详细程度设置为诊断）

第一个区别 - 我查看了构建的工作区变量和文件夹属性引用了各自的分支，特别是文件夹属性的 ServerItem 属性

第二个区别 - 正在构建的项目文件（BuildSettings.ProjectsToBuild）是来自各自的分支，

除了这些之外，我没有看到两个构建日志之间有任何其他差异

这里的主要问题：

是否有一种标准方法可以交换正在为单个分支构建的分支构建定义？

如果没有，是否可以简单地将自定义工作流模板（在 Workspace 和 BuildSettings.ProjectsToBuild 中）中对默认 Main 分支的所有引用更改为排队构建时输入的分支？

一如既往，提前感谢您的任何和所有帮助

Answer 1

我已设法修改构建的工作流程模板，以便可以构建解决方案的多个分支。为了实现这一目标，我必须更改工作流程中的某些内容，并为运行构建的服务帐户创建一些额外的工作区。

1. 我向工作流添加了一个参数，以便在构建排队时可以输入所需的分支。

2. 我更改了构建的放置位置，以便它与输入的分支相关（可选）

3. 在构建计算机上为分支构建创建了一个单独的源目录

4. 初始化了 WorkspaceName 和 SourcesDirectory，以便它们与新的工作空间名称和源目录文件夹匹配

5. 我创建了一个自定义活动来更改 BuildSettings.ProjectsToBuild 中的项目/解决方案列表，以便它们从

6. 我在测试阶段注意到，即使我输入的分支的新工作区最初是设置为使用输入的分支作为其 ServerItem，它仍然会使用在构建定义中输入的 ServerItem 创建工作区。为了解决这个问题，我创建了另一个自定义活动来重新映射分支工作区，以便 ServerItem 指向正确的分支

我的工作流程中还涉及到其他一些内容，但它们是我的开发人员要求的更多调整，上述步骤导致了单个构建定义的多个分支构建。

Answer 2

我还希望在构建定义中具有更多的分支敏捷性，因此我实现了一个代码活动来更改 ProjectsToBuild（如上面 Vermin 的步骤 5）。这是代码（删除了项目特定的内容）：

[BuildActivity(HostEnvironmentOption.All)]
public sealed class ConvertProjectsAccordingToBranch : CodeActivity
{
    public static string s_MainBranch = "$/MyTeamProject/Main";

    public InArgument<IBuildDetail> BuildDetail { get; set; }
    public InArgument<BuildSettings> BuildSettingsOriginal { get; set; }
    public OutArgument<BuildSettings> BuildSettingsConverted { get; set; }

    protected override void Execute(CodeActivityContext context)
    {
        Logger.Instance.Init(context);
        IBuildDetail buildDetail = BuildDetail.Get(context);
        BuildSettingsConverted.Set(context, ConvertProjects(BuildSettingsOriginal.Get(context), buildDetail.BuildDefinition));
    }

    /// <summary>Returns a BuildSettings with ProjectsToBuild converted according to the build definition's workspace</summary>
    public BuildSettings ConvertProjects(BuildSettings settingsOriginal, IBuildDefinition buildDefinition)
    {
        var mappings = buildDefinition.Workspace.Mappings;
        if (mappings.Count() != 1)
        {
            throw new BuildProcessException(string.Format(CultureInfo.InvariantCulture,
                "Build definition must have exactly one workspace mapping. Build definition ID:{0} has {1} mappings",
                buildDefinition.Id,   // IBuildDefinition doesn't have any Name property, seriously!
                mappings.Count()));
        }

        string definitionBranch = mappings.First().ServerItem;
        var settingsConverted = new BuildSettings()
        {
            PlatformConfigurations = settingsOriginal.PlatformConfigurations,
        };

        foreach (string projectOriginal in settingsOriginal.ProjectsToBuild)
        {
            var projectConverted = projectOriginal.Replace(s_MainBranch, definitionBranch);
            if (!projectConverted.StartsWith(definitionBranch))
            {
                throw new BuildProcessException(string.Format(CultureInfo.InvariantCulture,
                    "Project {0} is not under main branch {1},  Definition branch: {2}",
                    projectOriginal, s_MainBranch, definitionBranch));
            }

            settingsConverted.ProjectsToBuild.Add(projectConverted);
            Logger.Instance.Log("Converted ProjectToBuild: {0},  original: {1}", projectConverted, projectOriginal);
        }

        return settingsConverted;
    }
}

我还有 ConvertProjects() 的单元测试，但它依赖于本地内容，所以我没有将其发布在这里。很琐碎，绝对值得写！

Answer 3

我知道这已经很老了，但以防万一有人发现这篇文章。

我们有相同的要求：能够构建一个功能分支，以在合并到开发之前提供用于测试的特定功能的构建。

这就是我们的做法：

创建了一组 Visual Studio 扩展：

• 创建分支构建
• 启动分支构建
• 删除分支

创建分支构建将克隆用作模板的构建定义。根据分支更改构建定义名称和工作区。构建定义将在团队资源管理器 (VS2012) 中可见。

启动分支构建将找到构建定义并启动构建。

删除分支会找到构建定义，删除所有构建，删除构建定义，并删除分支（清理）。构建和分支的生命周期很短，因此清理它们很重要。

Answer 4

简而言之：否和是:-)

对这些答案进行更多详细说明，TFS 系统默认模板更喜欢为您想要构建的每个分支拥有单个构建定义，或者指定需要一次构建的所有分支，但是在单个构建定义中。没有标准方法可以从队列新构建对话框中的可用分支中进行选择。

下一个答案是肯定的，因为您确实可以自定义构建模板，而且我知道您已经开始这样做了。根据您的分支结构，向模板添加一个属性应该相当容易，该属性显示在“队列新构建”对话框中，并且有一个（例如）半列分隔的字符串，其中包含您想要在运行期间构建的所有分支，并为该列表中的每个元素添加一个解决方案，以便在模板实际开始迭代该列表之前在工作流程中构建。

这应该可以完成工作，但是，我感兴趣的是你最终是如何想要这种能力的？你没有使用VS解决方案文件吗？