Skip to content

Commit 98bea0d

Browse files
carlescufikartben
authored andcommitted
doc: getting started: windows: Switch to winget
Winget has become the standard Windows package manager, and it already contains all the packages required for Zephyr development. Switch to it from Chocolatey for simplicity and consistency with the OS. Signed-off-by: Carles Cufi <[email protected]>
1 parent 78f0516 commit 98bea0d

File tree

1 file changed

+17
-24
lines changed

1 file changed

+17
-24
lines changed

doc/develop/getting_started/index.rst

Lines changed: 17 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -164,45 +164,38 @@ The current minimum required version for the main dependencies are:
164164
application from the Microsoft Store. Instructions are provided for a ``cmd.exe`` or
165165
PowerShell command prompts.
166166

167-
These instructions rely on `Chocolatey`_. If Chocolatey isn't an option,
168-
you can install dependencies from their respective websites and ensure
169-
the command line tools are on your :envvar:`PATH` :ref:`environment
170-
variable <env_vars>`.
167+
These instructions rely on Windows' official package manager, `winget`_.
168+
If using winget isn't an option, you can install dependencies from their
169+
respective websites and ensure the command line tools are on your
170+
:envvar:`PATH` :ref:`environment variable <env_vars>`.
171171

172172
|p|
173173

174174
.. _install_dependencies_windows:
175175

176-
#. `Install chocolatey`_.
176+
#. In modern Windows versions, winget is already pre-installed by default.
177+
You can verify that this is the case by typing ``winget`` in a terminal
178+
window. If that fails, you can then `install winget`_.
177179

178-
#. Open a ``cmd.exe`` or PowerShell terminal window as **Administrator**.
179-
To do so, press the Windows key, type ``cmd.exe`` or PowerShell, right-click the
180-
:guilabel:`Command Prompt` or :guilabel:`PowerShell` search result, and choose
181-
:guilabel:`Run as Administrator`.
180+
#. Open a Command Prompt (``cmd.exe``) or PowerShell terminal window.
181+
To do so, press the Windows key, type ``cmd.exe`` or PowerShell and
182+
click on the result.
182183

183-
#. Disable global confirmation to avoid having to confirm the
184-
installation of individual programs:
184+
#. Use ``winget`` to install the required dependencies:
185185

186186
.. code-block:: bat
187187
188-
choco feature enable -n allowGlobalConfirmation
188+
winget install Kitware.CMake Ninja-build.Ninja oss-winget.gperf python Git.Git oss-winget.dtc wget 7zip.7zip
189189
190-
#. Use ``choco`` to install the required dependencies:
191-
192-
.. code-block:: bat
193-
194-
choco install cmake --installargs 'ADD_CMAKE_TO_PATH=System'
195-
choco install ninja gperf python311 git dtc-msys2 wget 7zip strawberryperl
190+
#. Close the terminal window.
196191

197-
.. warning::
192+
.. note::
198193

199-
As of November 2024, Python 3.13 is not recommended for Zephyr development on Windows,
200-
as some required Python dependencies may be difficult to install.
194+
You may need to add the 7zip installation folder to your ``PATH``.
201195

202-
#. Close the terminal window.
203196

204-
.. _Chocolatey: https://chocolatey.org/
205-
.. _Install chocolatey: https://chocolatey.org/install
197+
.. _winget: https://learn.microsoft.com/en-us/windows/package-manager/
198+
.. _install winget: https://aka.ms/getwinget
206199

207200
.. _get_the_code:
208201
.. _clone-zephyr:

0 commit comments

Comments
 (0)