What does the Microsoft.Bcl.Build NuGet package do?

Question

I\'m unable to find any documentation on this - the links from the Microsoft.Bcl.Build Nuget page don\'t provide much help:

This package provides buil

Answer 1

From looking at Microsoft.Bcl.Build.targets, it has a bunch of project configuration targets, eg:

• EnsureBindingRedirects - Determine which references are opted in for binding redirects, and update the app.config with them
• BclBuildValidateNugetPackageReferences - This target validates that any Nuget packages installed in the current project also have their dependencies (transitive dependencies) installed in the current project.

So based on this evaluation, I decided that this functionality is only needed in a dev environment, when adding/removing/updating NuGet dependencies; and that it could be ignored in a CI environment, where it's causing problems.

So I want to keep the dependency in my *.csproj files, but ignore it when running a CI build. I did that by adding a conditional import on a build environment targets file (eg builder.targets), which includes this block:

  Ignore

This has the net effect of ignoring the targets in a CI environment, but activating them in a development environment. I've had this running for over a week, and no problems so far...

I'd still love to know if anyone has better information on this package that indicates that doing this is a bad idea. So far I'm of the opinion that it's a good idea.

Edit 2018-02-01:

Note that the ignore parameter can also be passed on the command-line, to skip the Microsoft.Bcl.Build.targets logic:

msbuild (targets, etc) /p:BclBuildImported=Ignore