Upgrading ASP.NET Core 1.0 RC2 Project To RTM

A month ago I’ve demonstrated,

• How to migrate your ASP.NET 5 beta project to Core RC2

The migration from Beta to RC2 was a bit long but pretty much easy to follow and I was able to run my prototype apps smoothly without any hiccups. Recently, ASP.NET Core RTM was out. Microsoft announced the release of ASP.NET Core 1.0, couple of days ago. Big thanks to Microsoft and to the .NET Core team for their utmost effort on making this final release. Kudus!

Let’s Get Cracking!

In this article, we’re going to look at how to convert our existing RC2 App to RTM in Windows environment, using Visual Studio 2015.

Installation Requirements

• First, you need to download Visual Studio 2015 Update 3. You can check the release update here.
  
• Second, download the Microsoft .NET Core 1.0.0 VS 2015 Tooling Preview 2.

Installing Visual Studio 2015 Update 3

Close all the instances of Visual Studio, which are running on your machine and then install Visual Studio Update 3 (vs2015.3). Now, if you will get the following setup warning below:


Figure 1: Setup Warning

Don’t panic. Just click continue and it should bring you to the next step, shown below:


Figure 2: Features

Select the features, that you would like to be included for this update and then click “Next”. Verify all the features, you need in the next step and then click “Update” to start applying the changes.

You may need to wait few minutes or a few hours, depending on your connection, before it completes the upgrade. Once completed, you should be able to see the following:


Figure 3: Setup Completed

After the installation, make sure to restart your machine to ensure updates will take effect.

Installing .NET Core 1.0.0 VS Tooling Preview 2

Now, install the Tooling Preview 2, that you have just downloaded. You should see something like this as the installation progresses.


Figure 4: VS 2015 Tooling Preview 2 installation

Once the installation is complete, you should be able to see the screenshot, shown below:


Figure 5: VS 2015 Tooling Preview 2 installation completed

Upgrading to RTM

In this demo, I’m going to use the ASP.NET Core MVC project, that I’ve demonstrated before. Now, let’s start modifying.

Note: You may need to run Visual Studio as an administrator to make sure that restoring of NuGet packages will run smoothly.

project.json changes

The fastest trick to upgrade is to create new project and compare your existing “project.json” file with the new project. Looking at the newly created ASP.NET Core Web Application project it seems that we only need to change,

• The Microsoft.NETCore.App version from 1.0.0-rc2-3002702 to 1.0.0
• All references from 1.0.0-rc2-final to 1.0.0.
• All references from 1.0.0-preview1-final to 1.0.0-preview2-final
• Remove the imports section under the tools element. Hence, your tools element would now look like this,
  

  "tools": {
  "Microsoft.AspNetCore.Server.IISIntegration.Tools": "1.0.0-preview2-final"
  },

So doing a quick find and replace will easily do the sync for you.

global.json changes

You need to update SDK version to 1.0.0-preview2-003121. Hence, your file will look, as shown below:

{
    "projects": ["src", "test"],
    "sdk": {
        "version": "1.0.0-preview2-003121"
    }
}

Wrapping Up

Here’s, how my project.json file looked like after the modification:

{
    "dependencies":
    {
        "Microsoft.NETCore.App":
        {
            "version": "1.0.0",
            "type": "platform"
        },
        "Microsoft.AspNetCore.Server.IISIntegration": "1.0.0",
        "Microsoft.AspNetCore.Server.Kestrel": "1.0.0",
        "Microsoft.AspNetCore.Mvc": "1.0.0",
        "Microsoft.AspNetCore.Diagnostics": "1.0.0"
    },

    "tools":
    {
        "Microsoft.AspNetCore.Server.IISIntegration.Tools": "1.0.0-preview2-final"
    },

    "frameworks":
    {
        "netcoreapp1.0":
        {
            "imports":
            [
                "dotnet5.6",
                "dnxcore50",
                "portable-net45+win8"
            ]
        }
    },

    "buildOptions":
    {
        "emitEntryPoint": true,
        "preserveCompilationContext": true
    },

    "runtimeOptions":
    {
        "gcServer": true
    },

    "publishOptions":
    {
        "include":
        [
            "wwwroot",
            "web.config"
        ]
    },

    "scripts":
    {
        "postpublish": ["dotnet publish-iis --publish-folder %publish:OutputPath% --framework %publish:FullTargetFramework%"]
    }
}

Output

That's it! Unlike previous versions, it seems that upgrading to RTM is painless. Here's the output of my ASP.NET Core MVC app after the upgrade:


Figure 6: Output

I have attached the source code of my upgraded ASP.NET Core MVC app just in case you need a reference. Feel free to download it.

If you are still working on Beta versions and wanted to migrate your project to RTM, then I would really recommend you on creating a fresh project instead and move your code to the new project created. In this way, there is a less chance for you to get the migration configuration errors.

I know, there are some things, I haven’t covered in this article as I am only basing my prototype app for this upgrade. For more details about the breaking changes, I would recommend you to visit the following references:  

• Migrating from ASP.NET Core RC2 to ASP.NET Core 1.0
• Announcing ASP.NET Core 1.0
• ASP.NET Core 1.0 Announcements