This tool helps onboarding to package source mapping feature.
It can generate package source mapping section for you from nuget.config file and restored global packages folder
.
Here is steps to use the tool. It works for both packagereference and packages.config type projects. Please note tool doesn't map packages in fallback folder since they don't get copied to global packages folder
.
<config>
<add key="globalPackagesFolder" value="globalPackages" />
</config>
Preparation
global packages folder
.Run this tool with options suitable for you. See examples below.
Copy generated nugetPackageSourceMapping.config
file content into your nuget.config file. Please make any adjustments most sutiable for your use case.
Clear all local cache one more time to start on clean slate dotnet nuget locals all --clear
Repeat restore step above and make sure everything still works.
packagesourcemapper generate <CONFIGPATH> [-h|--help] [--verbosity <LEVEL>] [--fully-specified]
If no command is specified, the command will default to help
.
generate
Generates packageSourceMapping section for nuget.config file.
CONFIGPATH
Specify path to nuget.config
used for packagesourcemapper. This is positional argument so just value after generate
command.
-h|--help
Show help information
--verbosity <LEVEL>
Sets the verbosity level of the command. Allowed values are q[uiet]
, m[inimal]
, n[ormal]
, d[etailed]
, and diag[nostic]
. The default is minimal
. For more information, see LoggerVerbosity.
--fully-specified
Specify this option to generate full specified pattern instead without prefix. Currently only packages starting with Microsoft, System, Runtime, Xunit
are prefixed by default.
--remove-unused-sources
Specify this option if the packagesourcemapper should attempt to reduce the number of sources used in nuget.config by consolidating them.
Generate packageSourceMapping section:
PackageSourceMapper.exe generate C:\NuGetProj\NuGet.Client\NuGet.Config
PackageSourceMapper.exe generate C:\NuGetProj\NuGet.Client\NuGet.Config --verbosity diag
Generate packageSourceMapping section without any prefixing:
PackageSourceMapper.exe generate C:\NuGetProj\NuGet.Client\NuGet.Config --verbosity m --fully-specified
File NuGet.Client bugs in the NuGet/PackageSourceMapper