Working with west¶
You can interact with west in several ways, either by calling commands in the Command Palette or by using the Source control UI.
How to initialize a west workspace¶
A new west workspace is created by using the west init
command. To use the command from the extension:
- Open the Command Palette and type
nRF Connect: West Init
. - Browse to the folder where you want to initialize a west workspace.
- Choose
nrf
orzephyr
, or a custom repository. - Choose which version tag you want to work with.
West begins to initialize the workspace in the terminal output.
How to manually trigger status update¶
To trigger a status update, use one of the following options:
-
Open the Source Control View and click the refresh button on the west source control line in Source control UI.
-
Open the Command Palette and type
nRF Connect: West Refresh
.
How to update a west workspace¶
Use the west update
command to match your west workspace state with the state of the west manifest file. Whenever you check out a different revision in your manifest repository, run west update
to make sure your workspace contains the project repositories that the new revision expects.
To update a west workspace:
- Open the Command Palette and type
nRF Connect: West Update
. - Choose the location of your project repository.
West begins to update automatically.
How to change the west manifest¶
This option is useful for those who use upstream Zephyr and need to frequently switch between the two manifests or different versions. To change the current west manifest:
-
Use one of the following options to access the menu for setting the active manifest:
-
Click on the manifest path icon located towards the top of the Source Control View.
-
Open the Command Palette and type
nRF Connect: West Set Active Manifest
. -
Choose between either the nRF Connect or Zephyr manifest.