Skip to main content

IAR Embedded Workbench for Arm 10.10.x

Workspace window

In this section:

What do you want to do?

YellowStripe.png

The Workspace window is available from the View menu.

WorkspaceWin_Qt_01.png

Use this window to access your projects and files during the application development. To open an existing workspace in this window, either choose File>Open Workspace and select a workspace file to open or drag the file and drop it onto the main IDE window. Before a new workspace is opened you will be prompted to save and close any currently open workspaces.

Drop-down list

At the top of the window there is a drop-down list where you can choose a build configuration to display in the window for a specific project.

The display area

This area contains two columns.

The Files column displays the name of the current workspace and a tree representation of the projects, groups and files included in the workspace.

Note

An asterisk (*) after the filename means that changes have been made to the workspace/project or settings since it was last saved.

One or more of these icons are displayed:

PgNodeWorkspaceIcon_Mym80_01.png

Workspace

PgNodeProjectIcon_Mym80_02.png

Project

PgNodeProjectMfc_02.png

Project with multi-file compilation

PgNodeGroupIcon_Mym80_02.png

Group of files

PgNodeExclGroupIcon_Mym80_02.png

Group excluded from the build

PgNodeGroupMfc_02.png

Group of files, part of multi-file compilation

PgNodeGroupMfcExcluded_02.png

Group of files, part of multi-file compilation, but excluded from the build

PgNodeObjectFile.tif

Object file or library

PgNodeAsmIcon_Mym80_02.png

Assembler source file

PgNodeSourceFileC.tif

C source file

PgNodeSourceFileCpp.tif

C++ source file

PgNodeExclSourceIcon_Mym80_02.png

Source file excluded from the build

PgNodeSourceFileH.tif

Header file

PgNodeTextFile.tif

Text file

PgNodeTextFileHtml.tif

HTML text file

PgNodeControlFile.TIF

Control file, for example the linker configuration file

PgNodeInternalFile.tif

IDE internal file

PgNodeSourceFile_Mym8.0_02.png

Other file

The column OptionsIcon_Mym81_02.pngthat contains status information about option overrides can have one of three icons for each level in the project:

Blank

There are no settings/overrides for this file/group.

Black check mark

There are local settings/overrides for this file/group.

Red check mark

There are local settings/overrides for this file/group, but they are either identical to the inherited settings or they are ignored because you use multi-file compilation, which means that the overrides are not needed.

For more information about project management and using the Workspace window, see the Introduction to managing projects.

Context menu

This context menu is available:

WorkspacePopup_Qt_01.png

These commands are available:

Set as Active

Sets the selected project in the window to be the active project. It is the active project that will be built when the Make command is executed.

Options

Displays a dialog box where you can set options for each build tool for the selected item in the Workspace window, for example to exclude it from the build. You can set options for the entire project, for a group of files, or for an individual file. See Setting project options using the Options dialog box.

Exclude from Build

Excludes the selected file in the window from being included when the project is being built. If the selected file is already excluded, the command changes to Include in Build.

Make

Brings the current target up to date by compiling, assembling, and linking only the files that have changed since the last build.

Compile

Compiles or assembles the currently active file as appropriate. You can choose the file either by selecting it in the Workspace window, or by selecting the editor window containing the file you want to compile.

Rebuild All

Recompiles and relinks all files in the selected build configuration.

Clean

Deletes intermediate files.

C-STAT Static Analysis>Analyze Project

Makes C-STAT analyze the selected project. For more information about C-STAT, see the C-STAT® Static Analysis Guide.

C-STAT Static Analysis>Analyze File(s)

Makes C-STAT analyze the selected file(s). For more information about C-STAT, see the C-STAT® Static Analysis Guide.

C-STAT Static Analysis>Clear Analysis Results

Makes C-STAT clear the analysis information for previously performed analyses. For more information about C-STAT, see the C-STAT® Static Analysis Guide.

C-STAT Static Analysis>Generate HTML Summary

Shows a standard Save As dialog box where you can select the destination for a report summary in HTML and then create it. For more information about C-STAT, see the C-STAT® Static Analysis Guide.

C-STAT Static Analysis>Generate Full HTML Report

Shows a standard Save As dialog box where you can select the destination for a full report in HTML and create it. For more information about C-STAT, see the C-STAT® Static Analysis Guide.

Stop Build

Stops the current build operation.

Add or Create>Add Files

Displays a dialog box where you can add files to the project.

Add or Create>Create New File

Displays a dialog box where you can choose a folder for a new file to add to the selected project. After you have specified a filename and an extension, an empty file will be created in the folder and added.

Add or Create>Add File ( filename )

Adds the indicated file to the project. This command is only available if there is an open file in the editor.

Add or Create>Add Files From Folder

Displays a dialog box where you can choose a folder to add files from to the selected project, see Add Files From Folder dialog box.

Add or Create>Create New Group

Displays a dialog box where you can add new groups to the project. For more information about groups, see Groups.

Sync With Folder on Disk

Displays a dialog box where you can compare the selected project in the workspace with the folder on disk where the project is stored, and synchronize the contents, see Sync With Folder on Disk dialog box.

Set as Debug Target

Starts the debug session with the selected file as the debug target.

Add External Binary

Opens a standard navigation dialog box, in which you can select an externally built binary file to add to the project.

Resolve Sources

Tries to locate and display the source files that the selected binary file was built from. If any files cannot be located, the Add Folder Alias dialog box is displayed, see Add Folder Alias dialog box.

Remove

Removes selected items from the Workspace window.

Rename

Displays the Rename Group dialog box where you can rename a group. For more information about groups, see Groups.

Open Containing Folder

Opens the File Explorer that displays the directory where the selected file resides.

File Properties

Displays a standard File Properties dialog box for the selected file.