How to install R Tools for Visual Studio

In this topic:

Note

After installing R Tools, you may want to configure Visual Studio for an optimized data scientist layout, as described on the Options topic.

Supported versions of Visual Studio

R Tools for Visual Studio (RTVS) is supported on Windows with the Community (free), Professional, and Enterprise editions of both Visual Studio 2017 and Visual Studio 2015 Update 3 (or higher) (direct download).

RTVS is not presently supported on Visual Studio for Mac.

RTVS does not install if you have only the Visual Studio Shell that's included with products such as Visual Studio Test Professional and SQL Server Management Studio. Visual Studio Shell lacks the necessary components for RTVS.

Installing RTVS in Visual Studio 2017

  1. Run the Visual Studio installer. (See Downloads if you don't yet have Visual Studio installed.) On Windows 7, be sure that your installer is updated to show Visual Studio version 15.2 build 26430.12 or later.

  2. Select the Data science and analytical applications workload:

    Data science and analytical applications workload in VS2017

  3. Set any additional options on the right side under the same workload name. By default, this workload includes F# and Python support. For R, minimum requirements are R language support, Runtime support for R development, and Microsoft R client.

RTVS is installed in: %ProgramFiles(x86)%\Microsoft Visual Studio\<version>\<edition>Common7\IDE\Extensions\Microsoft\R Tools for Visual Studio where <version> is typically 2017 and <edition> is Community, Professional, or Enterprise.

Installing RTVS in Visual Studio 2015

With Visual Studio 2015, you need to install an R interpreter and the R Tools separately.

Install an R interpreter

RTVS requires a 64-bit installation of R version 3.2.1 or higher from one or more of the following sources:

Microsoft R Open and CRAN R both allow for multiple side-by-side versions. Microsoft R Client, however, supports only one version and always uses the latest one you installed.

Install the R tools

Download the current RTVS for Visual Studio 2015 from https://aka.ms/rtvs-current. RTVS checks for a suitable version of Visual Studio and helps you install an R interpreter if you haven't already.

Note

The standalone RTVS installer works only with Visual Studio 2015; with Visual Studio 2017, install R support through the Data Science and Analytical Applications workload as described earlier.

RTVS for Visual Studio 2015 is installed in: %ProgramFiles(x86)%\Microsoft Visual Studio 14\Common7\IDE\Extensions\Microsoft\R Tools for Visual Studio

Offline installation of Visual Studio and RTVS

Offline installation is suitable for computers that are not connected to the Internet:

  1. Follow the instructions to create an offline installer for your version of Visual Studio:

  2. For Visual Studio 2015, download the offline RTVS installers from https://aka.ms/rtvs-current-zip and https://aka.ms/rtvs-remote-zip.

  3. Install Visual Studio and RTVS from the offline installers.

See also