IAR Build

Build and develop your IAR Embedded Workbench projects from Visual Studio Code.

• Build projects
• Manage project files
• Generate C-STAT messages and reports
• Use language features powered by the C/C++ extension

An IAR Embedded Workbench or IAR Build Tools installation is required to use this extension. See Compatibility table below for detailed information.

💡️ To debug your Embedded Workbench projects from VS Code, please also see the IAR C-SPY Debug extension.

Getting started

To get started, open a folder containing an IAR Embedded Workbench project. A view with an IAR Embedded Workbench icon will appear in the left side panel:

Here you may select the desired IAR Embedded Workbench/Build Tools installation, and the project and project configuration you want to work with. If your IAR Embedded Workbench or IAR Build Tools installation is not found automatically, please see Adding IAR Embedded Workbench/Build Tools installations.

To build or analyze the selected project configuration, go to Terminal->Run Task... and then select either the iar or iar-cstat category. To make this easier, you may wish to Add a default build task.

Documentation

• Configuring the Build extension

• Making IAR Build settings

• Switching between VS Code and IAR Embedded Workbench

• Adding and removing source files

• IAR Build tasks

• Configuring build parameters

• IAR language extensions

Click here to view the full documentation.

Compatibility

This extension is compatible with any IAR Embedded Workbench (EW) or IAR Build Tools version (BX) using IDE version 8 or newer. The table below helps you find the extension version supporting your IAR Embedded Workbench product. The supported versions are the same for IAR Build Tools installations, but IAR Build Tools does not support the file view or adding/removing files from a project.

IAR EW/BX - Compatibility table

IAR EW/BX version	Limitation
Arm v9.30.1 or later RISC-V v3.10 or later RH850 v3.10 or later 430 v8.10 or later RL78 v5.10 or later AVR v8.10 or later RX v5.10 or later	None
Arm v9.20.4	Batch builds do not persist to the workspace file.
Arm v8.10-9.20.3 RISC-V v1.10-2.11 430 v7.10-7.21 RL78 v3.10-4.21 RX v3.10-4.20 RH850 v2.10-2.21 AVR v7.10-7.30 8051 v10.10 or later	File view and possibility to add/remove files from a project is not supported. Batch builds do not persist to the workspace file.

Feedback

Depending on the type of feedback you want to share with us, here are our preferred options:

• For urgent matters with the extension, or if you have issues with the underlying IAR Embedded Workbench or IAR Build Tools product, report this via the IAR Systems technical support channel at IAR Technical Support.

• For other matters isolated to this extension, file a New issue using the provided template. We will reply on a "best effort basis".

• If you have ideas on how to improve this extension, see CONTRIBUTING.md on how to proceed.