Template for MSbuild target / task

[vlada-shubina]

Extracted from dotnet/templating#233

Create a template for creation of MSBuild tasks and targets.

The template should setup:

• correct packaging (per the guidance we've created)
• support for full-framework and .NET versions of MSBuild (for Visual Studio and dotnet build support)
• should scaffold out folders for the different extensibility points (build vs buildMultitargeting, primarily) with a README in each folder describing the intent)
• scaffold out tests for the generated Task(s)?
  • may require that we ship the MSBuild Task Testing helpers in the MSBuild project as a separate package first, so it can be easily included
• Will need a strategy for easy testing locally vs packaged.

[vlada-shubina]

@baronfel please advise whether this issue should be moved to dotnet/msbuild repo instead.

[baronfel]

Yeah, it should. I've added a couple items to cover in the issue description. But will go ahead and transfer it.

[danmoseley]

Perhaps it could ensure that Execute() returns "return !Log.HasLoggedErrors;" as all tasks should.

[teo-tsirpanis]

correct packaging (per the guidance we've created)

Where can I find that guidance?

[baronfel]

@teo-tsirpanis I updated the description with the link, but the example is at https://docs.microsoft.com/en-us/visualstudio/msbuild/tutorial-custom-task-code-generation?view=vs-2022#package-the-task-for-distribution. I've applied them to my own project Ionide.KeepAChangelog.Tasks if you want to see what they look like when applied to a non-example Task.

[teo-tsirpanis]

Thanks @baronfel, I will take a look. What I've been doing is dotnet publishing the library into a directory and adding it to the package. This looks much better!

[rainersigwald]

Consideration here: pull in the type of improvements mentioned in #5068.