That was a quick turn-around… we issued our 3.0 beta just a few days ago and our community of developers and supporters quickly found a number of issues with it. Thank you to the early reporters on Twitter and on this blog for helping us to identify those issues. We would like to issue an update to our Visual Studio extension to correct some of the stickier problems that were identified. You can also get a copy of the extension from Codeplex at http://nuget.codeplex.com/downloads/get/1432773.
Our new protocol delivers NuGet package data in JSON format from the nuget.org server. One issue we ran into was a mishandling of the date formatting for non-US machines. We addressed this issue and re-tested with a German workstation to verify that the problem is corrected.
We had a backwards compatibility issue with Visual Studio due to a previously included reference to the Visual Studio v12 shell. That type is not being loaded by Visual Studio 2015 (version 14 internally) and we fixed our references to use the Visual Studio v14 shell.
The final issue we had reported to us was an interesting uninstall of the NuGet extension issue. This is a particularly strange one because it does not happen on all machines, and we have not been able to isolate the trigger scenario. It does appear to be an issue in Visual Studio when uninstalling an extension, and we are working with their team to address this. We suspect that it could be an issue for other extension developers as well.
We do not have a fix for this uninstall issue, but we do have a workaround if you encounter it. We recommend that you follow these steps if you encounter it:
- Uninstall the existing NuGet extension that you retrieved from the extension gallery.
- With Visual Studio closed, download a new copy of the NuGet extension from Codeplex instead of through the extension gallery.
- Double-click the VSIX you downloaded to install a fresh copy of the NuGet extension.
- When you next start Visual Studio, if you are prompted with an error about needing Admin privileges again, take the following steps:
- Close Visual Studio
- Start the Visual Studio Command Prompt, called “Developer Command Prompt for VS2015” as an Admin
- Manually install the NuGet VSIX using VsixInstaller with the /admin switch. eg:
VSIXInstaller.exe c:\install\nuget.tools.2015.vsix /admin
A note about using NuGet 3 with kpm: a new kpm client has not been issued that is compatible with the NuGet 3 API. This means that if you are in an ASP.NET 5 project, you cannot use the NuGet v3 endpoint. For these projects, we recommend that you disable the api.nuget.org service in the package sources dialog as follows:
Legacy package restore incompatibility
If you have a project with in the ‘legacy package restore mode’, with the .nuget folder at the root of your solution folder, you will run into a similar API incompatibility issue. In this scenario, the nuget.exe client program that you have copied locally does not understand the v3 API and will not be able to restore packages for you using the api.nuget.org endpoint. You have two options:
- Disable the api.nuget.org endpoint as described above, enabling the v2 endpoint.
- Migrate from legacy package restore mode to automatic package restore.
We responded quickly to these issues because we heard your feedback, and we value our developers and customers who are using our NuGet extension for Visual Studio. It is important to us that you have a good experience while using our product. We are committed to improving your package management experience, and we will deliver on that promise.