Search code examples
tfsazure-devopstfsbuildazure-pipelines-build-task

TFS Custom Build Tasks - Multiple versions

I need to make changes to a custom TFS build task. I'd like to bundle the new version of the task in my extension (leaving the current version in as well) and be able to select the version when editing a build/release definition.

I've looked over Microsoft's documentation for bundling multiple versions of a build task within one extension, but I'm not seeing the details of what needs to be included in the extension manifest.

I've also looked at the VSTS Tasks on github and I'm not seeing how to accomplish this.

Does anyone have an example of how to bundle multiple versions of a task in one extension?

Solution

  • This works for Visual Studio Team Services, you may have to wait until TFS 2017u2 is out to be able to do this against TFS.

    • Create a parent folder for both tasks (Task)
    • Put each build task in its own folder (Task\TaskV1, Task\TaskV2).
    • Make sure they're different by major version in the task.json
    • Make sure they have the same TaskID and TaskName
    • In the vss-extension.json include the files for both versions
    • In the vss-extension.json include a single contribution for the task and reference only the parent folder (Task).

    So like this:

     "contributions": [ 
     { 
         "id": "Task", 
         "type": "ms.vss-distributed-task.task", 
         "targets": [ "ms.vss-distributed-task.tasks" ], 
         "properties": { "name": "Task" } // reference task root folder here.
     },
 ]

    See also