I have migrated a solution that is currently targeting .NET 4.0 in VS2010 to VS2012 and now I would like to re-target it to .Net 4.5
What I am not sure about is the NuGet packages. For example EF5, which I updated from EF4 in VS2010 turns out to be actually EF 4.4 as you can see here:
<Reference Include="EntityFramework, Version=4.4.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089, processorArchitecture=MSIL">
<SpecificVersion>False</SpecificVersion>
<HintPath>..\packages\EntityFramework.5.0.0\lib\net40\EntityFramework.dll</HintPath>
</Reference>
I can also see the following in packages.config for the project:
<?xml version="1.0" encoding="utf-8"?>
<packages>
<package id="EntityFramework" version="5.0.0" targetFramework="net40" />
</packages>
So my question is:
What is the best practice to re-target all NuGet packages that are currently set to target .NET 4.0 to target .NET 4.5?
NuGet 2.1 offers a feature that makes this a lot simpler: just do update-package -reinstall -ignoreDependencies
from the Package Manager Console.
NuGet 2.0 doesn't handle re-targeting your applications very well. In order to change your packages' target frameworks, you must uninstall and reinstall the packages (taking note of the packages you had installed so that you can reinstall each of them).
The reason packages must be uninstalled and reinstalled is:
When installing a package, we determine the target framework of your project
We then match that up with the package contents, finding the appropriate \lib\ folder (and \content\ folder)
Assembly references are added with Hint Paths that point to the package's \lib\ folder, with the right subfolder (\lib\net40 for example)
Content files are copied from the packages \content\ folder, with the right subfolder (\content\net40 for example)
We record the targetFramework used to install the package within the packages.config file
After you change your project's target framework, the Hint Paths still point to net40
When you uninstall packages, we check the targetFramework that was recorded in packages.config to see what target framework's libs/content to remove from your project
When you reinstall the package, we detect your updated target framework and reference/copy the right libs/content
For those who had problems with update-package -reinstall <packagename>
command, consider running it with -ignoreDependencies
flag, like this:
update-package -reinstall <packagename> -ignoreDependencies
This flag will leave your package dependencies alone, otherwise they might got updated even if the package you originally wanted reinstall still keeps it's version in same.
More info here.
get-package | % { update-package $_.Id -reinstall -ProjectName $_.ProjectName -ignoreDependencies }
After trying the accepted answer unsuccessfully I would like to suggest a less risky command:
Update-Package <PackageName> -ProjectName <ProjectName> -Reinstall -IgnoreDependencies
For more info: http://blog.nuget.org/20121231/a-quick-tutorial-on-update-package-command.html
-reinstall
will only install the same version, so don't see any benefit to using -safe
. Am I missing something?
Whilst attempting to reinstall packages solution wide, I encountered a dependency error (in spite of using the -ignoreDependencies
flag), and all the packages.config files for every project had been deleted. In VS2013, it seems that packages.config does not get flushed back to disk and re-added until all the upgraded dependencies/references are re-attached to the project.
In my case what worked was to upgrade each project one-at-a-time by adding the -ProjectName
projectname to the update-package
command. In this case the packages.config is updated as each project is upgraded.
May not be practical for very large solutions but it seems a reasonable compromise to still take advantage of the automated upgrade for as many projects as possible and isolate the problematic ones without having every packages.config in your solution deleted on failure.
UpdatePackage -Reinstall
deleted the package.config and project references for a few projects (specifically ones that had fakes assemblies generated in them). We worked around this by undoing all changes to the screwed up project and running: Update-Package -reinstall -ProjectName "PROJECTNAME" -IgnoreDependencies
With Visual Studio for Mac 2019, right-clicking the Packages folder shows 'Retarget' option in the menu. This resolved the retarget issue for all packages in the project that required retargeting. Looks like there was no NuGet Package Manager under Tools menu in Visual Studio for Mac (atleast in mine), so I couldn't launch Package Manager Console.
https://i.stack.imgur.com/LSij8.png
Success story sharing
update-package -reinstall
in Package Manager Console. All packages started to be uninstalled and updated and all of a sudden Windows 8 restarted and when it got back it told "Your PC run into a problem and restarted. Do you want to send information to Microsoft?" :( Scaring... By the way, this is the NuGet version I have installed right now:2.2.40116.9051
Opened an issue here: nuget.codeplex.com/workitem/3049