You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Edit Install toolchain section to better accound for pre-packaged
SDK and Toolchain option in the extension.
VSC-3082.
Signed-off-by: Grzegorz Ferenc <[email protected]>
Copy file name to clipboardExpand all lines: doc/nrf/installation/install_ncs.rst
+19-15Lines changed: 19 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -98,24 +98,27 @@ Depending on your preferred development environment, complete the following step
98
98
.. note::
99
99
If you prefer, you can now `start VS Code walkthrough`_ and install the toolchain and the SDK from there.
100
100
101
-
1. Open the nRF Connect extension in |VSC| by clicking its icon in the :guilabel:`Activity Bar`.
102
-
#. In the extension's :guilabel:`Welcome View`, click on :guilabel:`Manage toolchains`.
103
-
The list of actions appears in the |VSC|'s quick pick.
104
-
#. Click :guilabel:`Install Toolchain`.
105
-
The list of available stable toolchain versions appears in the |VSC|'s quick pick.
106
-
#. Select the toolchain version to install.
107
-
The toolchain version should match the |NCS| version you are going to work with.
108
-
|install_latest_version|
101
+
You can install the toolchain together with or separately from the SDK code:
109
102
110
-
.. note::
111
-
If you have received a custom URL for installing the toolchain, you can provide it using the :guilabel:`Change Toolchain Index` button in the quick pick's header (wrench icon).
112
-
If you are working with a development tag, disable the filter in the quick pick's header to list all available toolchains.
103
+
* When you install the toolchain together with the SDK code, you can download a pre-packaged bundle from the Nordic Semiconductor server that installs both the SDK and the toolchain.
104
+
Skip to :ref:`cloning_the_repositories` step now.
105
+
* When you install the toolchain separately from the SDK code, you can later install the SDK code from a GitHub tag.
106
+
To install the toolchain separately from the SDK code, complete the following steps:
113
107
114
-
The toolchain installation starts in the background, as can be seen in the notification that appears.
108
+
1. Open the nRF Connect extension in |VSC| by clicking its icon in the :guilabel:`Activity Bar`.
109
+
#. In the extension's :guilabel:`Welcome View`, click on :guilabel:`Manage toolchains`.
110
+
The list of actions appears in the |VSC|'s quick pick.
111
+
#. Click :guilabel:`Install toolchain`.
112
+
The list of available stable toolchain versions appears in the |VSC|'s quick pick.
113
+
#. Select the toolchain version to install.
114
+
The toolchain version should match the |NCS| version you are going to work with.
115
+
|install_latest_version|
115
116
116
-
When you install the toolchain for the first time, the installed version is automatically selected for your project.
117
+
.. note::
118
+
If you have received a custom URL for installing the toolchain, you can provide it using the :guilabel:`Change Toolchain Index` button in the quick pick's header (wrench icon).
119
+
If you are working with a development tag, disable the filter in the quick pick's header to list all available toolchains.
117
120
118
-
After installing the toolchain, you can access the :guilabel:`Install Toolchain` option by clicking on :guilabel:`Manage toolchains`.
121
+
The toolchain installation starts in the background, as can be seen in the notification that appears.
119
122
120
123
.. group-tab:: Command line
121
124
@@ -236,7 +239,8 @@ For more information about the repository and development model, see the :ref:`d
236
239
#. Select the SDK type to install.
237
240
The list of available stable SDK versions for the selected SDK type appears in the |VSC|'s quick pick, grouped into two categories:
238
241
239
-
* Pre-packaged SDKs - Bundled by Nordic Semiconductor.
242
+
* Pre-packaged SDKs & Toolchains - Available on the Nordic Semiconductor server.
243
+
The package downloads both the SDK and Toolchain, but skips the Toolchain if you have it already installed.
240
244
Available mostly for stable releases and some preview tags.
241
245
Recommended for faster and more reliable download and installation.
242
246
* GitHub - Taken from the `nRF Connect by Nordic Semiconductor GitHub organization <nrfconnect GitHub organization_>`_.
0 commit comments