A solution is a collection of projects, and all projects are contained in solutions. Organizing your projects into a solution allows you to build all the projects in a solution with a single keystroke, load them onto the target ready for debugging with another.

Projects in a solution can can reside in the same or different directories. Project directories are always relative to the directory of the solution file which enables you to move or share project file hierarchies on different computers.

The Project Explorer organizes your projects and files and provides quick access to the commands that operate on them. A tool bar at the top of the window offers quick access to commonly used commands for the item selected in the Project Explorer.

Projects

The projects you create within a solution have a project type which CrossStudio uses to determine how to build the project. The project type is selected when you use the New Project dialog. The particular set of project types can vary depending upon the variant of CrossWorks you are using, however the following project types are standard to most CrossWorks variants:

Properties and Configurations

Properties are data that are attached to project nodes. They are usually used in the build process for example to define C preprocessor symbols. You can have different values of the same property based on a configuration, for example you can change the value of a C preprocessor symbol for a release or a debug build.

Folders

Projects can contain folders which are used to group related files together. This grouping can be done using the file extension of the file or it can be done by explicitly creating a file within a folder. Note that folders do not map onto directories in the file store they are solely used to structure the project explorer display.

Files

The source files of your project can be placed either in folders or directly in the project. Ideally files placed in project should be relative to the project directory, however there are cases when you might want to refer to a file in an absolute location and this is supported by the project system. The project system will allow (with a warning) duplicate files to be put into a project.

The project system uses the extension of the file to determine the appropriate build action to perform on the file. So

You can modify this behaviour by setting the File Type property of the file with the Common configuration selected in the properties window which enables files with non-standard extensions to be compiled by the project system.

Solution links

You can create links to existing project files from a solution which enables you to create hierarchical builds. For example you could have a solution that builds a library together with a stub test driver executable. You can then link to this solution (by right clicking on the solution node of the project explorer and selecting Add Existing Project) to be able to use the library from a project in the current solution.

Project and session files

When you have created a solution it is stored in a project file. Project files are text files with the file extension hzp that contain an XML description of your project. When you exit CrossWorks details of your current session are stored in a session file. Session files are text files with the file extension hzs that contain details such as files you have opened in the editor and breakpoints you set in the breakpoint window.