Manage toolchains

nRF Connect for VS Code

tags
nRF Connect for VS Code

This action lets you manage the toolchain versions that you can select for each of your build configurations, including those you have installed outside of the extension, for example using the command line, on the system PATH, or using a custom toolchain URL.

The following actions are available in the Manage toolchains Manage toolchains menu:

Action Description
Install toolchain Installs one or more nRF Connect SDK Toolchain versions from the list of available toolchains. Only stable toolchain are displayed by default.

During the first installation, you can select your preferred download region for Pre-packaged SDKs & Toolchain: Global or Mainland China. If you need to change the region in the future, change the nrf-connect.sdkManager.region setting.

In the quick pick header, you can use the following buttons:

- The Change Toolchain Index button to provide a custom toolchain URL.
- The Change Toolchain Install Directory button to provide a custom source directory for the installation.
- The filter button to list all available toolchains (instead of only stable ones).
Show Only Stable Toolchain Versions
Uninstall toolchain Uninstalls a toolchain version from the computer. The quick pick from which you select the version to uninstall also lists toolchain versions installed outside of the extension.
Open terminal profile Opens the nRF Connect terminal profile in the Panel View for the selected toolchain and SDK version. You can use the Change Terminal Configuration button to select different toolchain or SDK versions (or both, but only if you have installed more than one).

Open Terminal Profile with the Change Terminal Configuration button

It is also possible to skip the SDK selection using the Skip SDK Selection button in the Change Terminal Configuration quick pick menu. This lets you open the terminal for the toolchain only.
Open toolchain directory Opens the directory of an installed toolchain version that you select from the quick pick.
Validate toolchain Validates the installation of the toolchain version that you select from the quick pick. The installation is validated against the requirements file in the nRF Connect SDK. Any failures are reported in the Output window.

This check is also automatically done when you change the SDK or toolchain (or both) when creating or editing the build configuration.

When you hover over the Manage toolchains Manage toolchains entry, the Refresh Toolchains button appears. You can use this button to scan the extension settings for any changes to the toolchain configuration. This is useful if the setting is not picked up when you create a new workspace or add a new build configuration.

Refresh Toolchains button