Download and install CMake (version 3.31 or later).

Choose Tools>Options>CMake/CMSIS-Toolbox to open the settings page for CMake/CMSIS-Toolbox and specify the path to the CMake executable.

Choose Project>Add or Create>Create New Project to open the Create New Project dialog box.

Select one of the templates Import CMakeLists.txt or Attach to pre-configured CMake directory, located under the CMake for Arm folder.

If you selected the template Import CMakeLists.txt, navigate to the CMakeLists.txt that belongs to the CMake project you want to add. Adding it can take a few minutes.

If you selected the template Attach to pre-configured CMake directory, navigate to an existing CMake build directory. The new Embedded Workbench project will use the information found in that directory. Creating a project this way is very convenient if you are using a complex build system that uses CMake, for example, some real-time operating systems. A project created this way cannot be configured in the Embedded Workbench IDE except by specifying extra command line options in the Project>Options>CMake>CMake dialog box, because the project is controlled by what is on disk in the attached build directory, rather than by user input.

Save the project file in a suitable location.

Now all files should be displayed in the Workspace window.

The project can now be analyzed and debugged as a regular Embedded Workbench project. In a project with multiple executable targets, select the target to debug on the Project>Options>CMake>CMake Target page.

You can also use the template Empty project and import a CMakeLists.txt file into the IDE later, provided you choose the template located under the CMake for Arm folder. Import the CMakeLists.txt file by selecting CMake>Add CMakeLists.txt to Project. Note that you can only add one CMakeLists.txt file.