Skip to main content

Install MSVC

Install MSVC 2019 (toolset v142) or later.

About MSVC​

MSVC (Microsoft C++) is Microsoft’s C++ build toolchain.

Rokae+ client plugins on Windows are built with Qt + MSVC.

Installation options​

Either of the following options provides the same MSVC toolchain. Select one according to development needs.

OptionDescription
Build Tools (recommended)Installs only the components required to compile. Does not include the full IDE and has a smaller footprint. Suitable when Qt Creator is the primary IDE.
Full Visual StudioInstalls the Visual Studio IDE together with the MSVC toolchain. Larger footprint. Suitable when Visual Studio is required, or when it is already installed.

The following steps use Build Tools for Visual Studio 2022 (MSVC 2022, toolset v143) as an example. To install full Visual Studio, or if Visual Studio is already present, see Full Visual Studio. A separate Build Tools installation is not required in those cases.

tip

Some Windows editions do not include winget or other package managers, or cannot run them. This guide therefore downloads the installer from the Microsoft website.

Download location​

This guide obtains Build Tools for Visual Studio 2022 via Older downloads (the UI may differ slightly by version).

Download steps​

1. Open the Visual Studio downloads page​

Open the Visual Studio downloads page in a browser.

msvc_0_打开网站

2. Open Older downloads​

Scroll to the bottom of the page and select Older downloads.

msvc_1_滑到最下面找到旧版下载

3. Download Visual Studio 2022 and other products​

On the Older downloads page, expand 2022, then select Download on the Visual Studio 2022 and other products row.

msvc_2_点击下载

4. Sign in with a Microsoft account​

Sign in with a Microsoft account when prompted. If an account is not available, create one and return to this page to sign in.

msvc_3_登录微软账号

5. Locate Build Tools for Visual Studio 2022​

After sign-in, open the downloads list. The search box is typically prefilled with visual studio 2022; locate Build Tools for Visual Studio 2022 in the list.

msvc_4_勾选BuildTools

6. Download Build Tools​

Select Download on the Build Tools for Visual Studio 2022 row and wait until the browser finishes downloading. The installer is typically named vs_BuildTools.exe.

msvc_5_下载BuildTools

Installation steps​

1. Start the installer​

Double-click vs_BuildTools.exe.

msvc_6_双击打开BuildTools

2. Allow User Account Control​

If User Account Control appears, confirm that the publisher is Microsoft Corporation, then choose Yes.

msvc_7_允许更改

3. Select Continue​

On the Visual Studio Installer welcome page, review the license and privacy information, then select Continue.

msvc_8_继续

4. Wait while the installer downloads and prepares​

Wait until Visual Studio Installer finishes downloading and preparing itself.

msvc_9_等待安装

5. Select Desktop development with C++​

  1. On the Workloads page, select Desktop development with C++.
  2. Confirm that several items are selected under Installation details on the right.

msvc_11_安装C++桌面开发

6. Change the install location (optional)​

Open the Installation locations page and review the Product and Download cache paths.

tip

If drive C: has sufficient free space, keep the default install location. When the system drive is solid-state, the default location helps run faster.

msvc_12_更改合适的安装路径

7. Select Install​

msvc_13_点击安装

8. Wait until setup finishes​

Wait until download and installation complete. Visual Studio Installer may then be closed.

msvc_14_等待安装完成

Full Visual Studio​

In the following cases, do not install Build Tools separately. Ensure that the machine already provides the same MSVC toolchain. Required workload is described in Installation step 5.

Installing full Visual Studio​

  1. Open the Visual Studio downloads page and download Community or another edition for which a license is held. Do not use winget or other package managers.
  2. Run the installer, select the Desktop development with C++ workload, confirm that several items are selected under Installation details on the right, then select Install.

Visual Studio is already installed​

  1. Open Visual Studio Installer (search for it from the Start menu).
  2. Select Modify on the installed Visual Studio instance.
  3. Select Desktop development with C++, and confirm that several items are selected under Installation details on the right.
  4. Select Modify and wait until the operation completes.