Supporting Package Reference in UWP WPF WinForms and Classic Libraries
Spec for the work is available here: - https://github.com/NuGet/Home/issues/3561
Currently there are multiple ways (packages.config, project.json and PackageReference in csproj) of managing dependencies and we want to standardize on one global way of managing dependencies. Its hard on customers to read and understand about multiple ways of managing dependencies.
All .NET Customers who want to move towards managing dependencies via the model built for project.json.
There are 2 key scenarios at play here.
- Customers who want to move from package.config to PackageReference
- Customers who want to move from project.json to PackageReference
One thing to note is that PackageReference support is only available in VS "15" RTM+ versions of Visual Studio and the corresponding versions of NuGet.exe. Customers upgrading to PackageReference will be unable to roundtrip their projects with previous versions of Visual Studio including VS 2015
If projects with PackageReference is opened in the downlevel version of NuGet package manager that will be shipped with VS 2017. We will show a error in the errorlist when a restore is invoked on a project that contains a package reference or any operations through PMC or the Package Manager UI is tried on that project.
Message: Managing NuGet packages through PackageReferences is only supported in Visual Studio 2017 and above. Revert to project.json or packages.config to manage NuGet packages for {ProjectName} in this version of Visual Studio. To learn more, refer to following link https://aka.ms/packagereferencesupport.
At RTM, PackageReference will only be added if project.json and packages.config are missing in a project and/or a PackageReference is detected in the project, If a PackageReference is detected, future references will be added as PackageReference and all NuGet actions will be performed on this basis.
The user will have to explicitly migrate existing dependencies to PackageReference. Automatic migration will not be available at RTM. In other classic desktop projects or PCLs when a user tries to add the first NuGet package, will bring up a dialog that gives them a choice a using packages.config or PackageReference to manage their dependencies.
Title: Choose NuGet Package Management Format
Message: Projects with PackageReference are not supported in Visual Studio 2015 and earlier. Learn more about package reference (which will refer to the following link https://aka.ms/packagereferencesupport)
Text: Select the NuGet package manager format for App1
Radio Buttons: Choose Packages.config, Choose PackageReference - For classic projects
Radio Buttons: Choose project.json, Choose PackageReference - For UWP projects
CheckBox: Make this package manager format the default and do not show this dialog again.
Text: You can manage these settings in NuGet Settigns [Here points to Tools->Options->NuGet Package Manager -> General]
Butttons: Ok
Butttons: Cancel
We will have a new option in NuGet Options in Visual Studio that will specify the default behavior that is set when users either.
Set default package management format - ComboBox with the following options (PackageReference, Packages.config or Project.json)
In addition, to this option, we will have another option that will specify whether to show the dialog on first package addition to a new packages.config.
Do not show the format selector on first package install - CheckBox(Yes, No)
The default behavior is to keep using packages.config for classic projects. You can use the option to change it to Package References.
