This is a particularly common scenario if you're developing MSBuild tasks or Roslyn code analyzers: all the dependencies you use in your task, analyzer or source generator, need to be included in your nuget package too, alongside your project primary output (i.e. under the proper
analyzer, tools or buildfolders). A very convenient way (if not comprehensive, since it won't include with transitive dependencies) to do so is by annotating your
PackageReference themselves, like:
<PackageReference Include="Scriban" Version="2.1.2" PrivateAssets="all" Pack="true" />
Pack metadata value can then be used to include the assets in the package with the following target:
<!-- For every PackageReference with Pack=true, we include the assemblies from it in the package --><Target Name="AddPackDependencies" Inputs="@(RuntimeCopyLocalItems)" Outputs="%(RuntimeCopyLocalItems.NuGetPackageId)" AfterTargets="ResolvePackageAssets"><ItemGroup><NuGetPackageId Include="@(RuntimeCopyLocalItems -> '%(NuGetPackageId)')" /></ItemGroup><PropertyGroup><NuGetPackageId>@(NuGetPackageId -> Distinct())</NuGetPackageId></PropertyGroup><ItemGroup><PackageReferenceDependency Include="@(PackageReference -> WithMetadataValue('Identity', '$(NuGetPackageId)'))" /></ItemGroup><PropertyGroup><NuGetPackagePack>@(PackageReferenceDependency -> '%(Pack)')</NuGetPackagePack></PropertyGroup><ItemGroup Condition="'$(NuGetPackagePack)' == 'true'"><_PackageFiles Include="@(RuntimeCopyLocalItems)" PackagePath="$(BuildOutputTargetFolder)/$(TargetFramework)/%(Filename)%(Extension)" /><RuntimeCopyLocalItems Update="@(RuntimeCopyLocalItems)" CopyLocal="true" Private="true" /><ResolvedFileToPublish Include="@(RuntimeCopyLocalItems)" CopyToPublishDirectory="PreserveNewest" RelativePath="%(Filename)%(Extension)" /></ItemGroup></Target>
Quite a few things to note in the above target that aren't too obvious:
We use the
RuntimeCopyLocalItems item group which is resolved by
ResolvePackageAssets and contains the stuff that is needed for the dependency to run (i.e. the actual binaries, not reference assemblies, if it includes them).
We use Inputs/Outputs on it so we can batch by
%(RuntimeCopyLocalItems.NuGetPackageId): this makes processing simpler inside the target, since we'll be dealing with a single
NuGetPackageId for each batch, regardless of how many
We next get that package ID as a property, and find the
@(PackageReference) with that ID, to determine if it needs to be packed or not.
Note we use property syntax next since we know there can be at most one such
@(PackageReferenceDependency), in which case we'd get either an empty value or
If we have to pack, we include all the
@(RuntimeCopyLocalItems) (in the current batch, MSBuild does this for us for free thanks to the Inputs/Outputs) and use as the package path the same as what the primary project output will use. These are added directly as
_PackageFiles which is what the SDK-style project
We update the items metadata so they are also flagged as copy-local
ResolvedFileToPublish is useful when creating dotnet tools, since packing those is slightly different and includes a publish operation.