Installing ASP.NET MVC 3 Tools Update
Date Published: 13 April 2011
Phil Haack has a post introducing the ASP.NET MVC 3 Tools Update that you probably should read. This is my own experience installing the update and upgrading an existing MVC 3 project to use the new tooling. First, you’ll want to install the MVC 3 Tools Update, using one of these options:
And then you can read the Release Notes as well.
I’m not going to talk about what’s new with the Tools Update, except to re-emphasize the fact that MVC 3 didn’t change at all – only the tooling has changed. So, don’t worry about whether your application will need upgraded or will be compatible or any of that – it’s the same System.Web.Mvc.dll being used before and after this update.
I’m installing it via Web PI – here’s a quick walkthrough, after clicking the Web Platform Installer link above:
Click OK. Lucky me, I need to install a new version of Web PI:
Click “I Accept”… let the installer run. Shouldn’t require any action from you, and should then show this screen:
Click “I Accept”.
Wait for it…
Phil outlines a bunch of new stuff you get with the tooling update. A lot of the changes are in the ASP.NET MVC 3 project template, which of course only applies when you create a new project. So, what about existing ASP.NET MVC 3 projects – do they immediately take advantage of this new tooling goodness? Somewhat. The new template uses NuGet for its dependencies on jQuery, Modernizr, and EF Code First 4.1 – you can manually add these NuGet packages to your MVC 3 project, but just installing the Tools Update isn’t going to do it for you. Here are the packages included now by default:
To add these to your pre-existing MVC 3 project, run these commands in the Package Manager console:
PM> install-package jQuery   PM> install-package jQuery.vsdoc   PM> install-package jQuery.Validation   PM> install-package jQuery.UI.Combined   PM> install-package EntityFramework   PM> install-package Modernizr   PM>
After installing these (on 13 April 2011), I have the following packages installed in my pre-existing project:
So, the versions aren’t a complete match, but that’s to be expected since NuGet packages are updated frequently. You can get a particular version by simply passing in the version string with your request, for example:
PM> install-package jQuery -version 1.4.4
One of the new features in the tools update is the ability to quickly flesh out a Controller by simply right-clicking and choosing Add Controller. If you have a model class, you can now use EF to create the scaffolding for this model class using this UI:
This option is available in both new and pre-existing MVC 3 projects. About the only thing I couldn’t see a way to bring into my pre-existing project was this new feature:
I’m sure it’s a setting in the project template somewhere, but I haven’t as yet gone digging to find it. Perhaps Phil or someone from his team will let us know how to do this in the comments below.
Installing the new MVC 3 Tools Update was quick and painless. The new features in my pre-existing MVC 3 application were welcome and either lit up automatically or were easily added via NuGet. It’s worth noting as well that if you hadn’t already upgraded your version of NuGet to 1.2, installing the tools update will do so as part of the process. And if you haven’t given NuGet much of a look yet, I recommend you browse the NuGet Gallery at NuGet.org (which incidentally is running on open-source code designed and developed by NimblePros and hosted at CodePlex, so if you want to host your own NuGet gallery for internal use or for your customers, you can customize it to fit your needs). There are already over 1000 packages available via NuGet, and nearly half a million package downloads already, according to stats.nuget.org.
Steve is an experienced software architect and trainer, focusing on code quality and Domain-Driven Design with .NET.