How to: Upgrade Visual C++ Projects to Visual Studio 2013

When you first open a Visual C++ project that was created in an earlier version of Visual Studio, you might be prompted to update the project. The message asks whether you want to upgrade to the most recent version of the Visual C++ compiler and libraries. The options for upgrading depend on the version of Visual Studio that was used to create the project.

You can use Visual Studio 2013 to open, edit, and build Windows 8 projects that were created in Visual Studio 2012, but to create a new Windows 8 project, you must use Visual Studio 2012. (To create a Windows 8.1 project, you must use Visual Studio 2013.)

If you aren't prompted to update the project, you may not have to do anything to upgrade the project. For more information, see Visual Studio 2013 Compatibility.

  • If the project (.vcproj) was created in a version of Visual Studio that's older than Visual Studio 2010, you must update the project.

  • If the project (.vcxproj) was created in Visual Studio 2010 or Visual Studio 2012, you have two options:

    • You can skip the update. Visual Studio 2013 will load the project without making any changes if it has access to the Visual C++ tools in Visual Studio 2010 with SP1 or Visual Studio 2012. You can provide this access by installing Visual Studio 2010 and/or Visual Studio 2012 on the same machine that has Visual Studio 2013. For more information, see Installing Visual Studio Versions Side-by-Side.

    • You can update the project by allowing Visual Studio to make the changes that are described later in this topic. If you have more than one Visual C++ project in your solution, you must update all of them.

      Note

      If you decline the update when you're first prompted, you can update the project later by choosing Update VC++ project on the Project menu. If the command doesn't appear, then an update isn't required.

Upgrading a Visual C++ Project

If you allow Visual Studio 2013 to automatically update the project, these changes are made:

  • Changes the project so that it uses the Visual Studio 2013 compiler and libraries (PlatformToolset = VisualStudio v120).

  • For C++/CLI projects, changes the TargetFrameworkVersion to the .NET Framework 4.5.1.

Continuing to Work with a Custom PlatformToolset

If you want to continue to work with a custom PlatformToolset in Visual Studio 2013, the toolset must be located under %ProgramFiles%\MSBuild\Microsoft.Cpp\v4.0\Platforms\Win32\PlatformToolsets\ on an x86 machine, or under %ProgramFiles (x86)%\MSBuild\Microsoft.Cpp\v4.0\Platforms\Win32\PlatformToolsets\ on an x64 machine. For information about how to create a custom PlatformToolset, see C++ Native Multi-Targeting on the Visual C++ Team blog.

See Also

Concepts

Visual Studio 2013 Compatibility