In the New Project dialog, the wizards are categorized according to the nature of the project. If you expand C, you'll see all projects that have a C nature; expand QNX, and you'll see all the projects with a QNX nature:
Notice the overlap: the C Project wizard appears in both C and QNX.
Note: In the C/C++ perspective, you can also access the QNX C/C++ Projects wizards via the New C/C++ Project button:
Besides the nature-specific wizards, the IDE also has simple wizards that deal with the very basic elements of projects: Project,
Folder, and File. These elements have no natures associated with them. You can access these wizards by selecting .
Note: Although a project may seem to be nothing other than a directory in your workspace, the IDE attaches special meaning to a
project — it won't automatically recognize as a project any directory you happen to create in your
workspace.
Once you've created a project in the IDE, you can bring new folders and files into your project folder, even if they were
created outside of the IDE (e.g. using Windows Explorer).
To have the IDE recognize folders and files:
- In the Project Explorer view, right-click and select Refresh.
If you select a QNX C/C++ project, the first panel in the wizard looks like this:
The first panel in the New Project wizard for a QNX C/C++ project.
Field descriptions
-
Project name
- Name for the QNX project. Although the wizard allows it, don't use any of the following characters in your project name: | ! $ ( " ) & ` : ; \ ' * ? [ ] # ~ = % < > { } as they may cause problems later.
-
Use Default Location
- Use the current default workspace location to create the new project. If you don't want to use the default location for the
project, ensure that the Use Default Location option is deselected, and specify where the resources reside in the filesystem (if they don't reside in your workspace).
The Location field is required and must specify a valid location for the project when the Use Default Location is not selected.
-
Type
- Specifies the type for the QNX project:
-
Generate default file
- Generate the default files associated with a project. If you want to check out source from version control, for a QNX project,
make sure that you deselect the Generate default file option.
-
Add project to working sets
- Set this project to belong to a working set, meaning that you want to group all related
projects together as a set. Select this option, and then click
Select to either choose an existing working set, or create a new
working set. For more information about working sets, see the
Workbench User Guide.
If you select a C/C++ project, the first panel in the wizard looks like this:
The first panel in the New Project wizard for a C++ project.
Field descriptions
-
Project name
- Name for the QNX project. Although the wizard allows it, don't use any of the following characters in your project name: | ! $ ( " ) & ` : ; \ ' * ? [ ] # ~ = % < > { } as they may cause problems later.
-
Use Default Location
- Use the current default workspace location to create the new project. If you don't want to use the default location for the
project, ensure that the Use Default Location option is deselected, and specify where the resources reside in the filesystem (if they don't reside in your workspace).
The Location field is required and must specify a valid location for the project when the Use Default Location is not selected.
-
Project type
- Specifies the type for the QNX project:
- Executable
— Provides an executable application. This project type folder contains three templates:
- Empty Project
— A single-source project folder that doesn't contain any files.
- Hello World C++ Project
— A simple C++ application with main().
After specifying an Executable template, the workbench creates a project with only the metadata files required for your project type, and automatically
creates a makefile for you. You can modify these source files, and provide them for the project's target.
- Shared Library
— An executable module compiled and linked separately. For more information about this type, see Creating a C/C++ project.
- Static Library
— A collection of object files that you can link into another application (libxx.a). For more information about this type, see Creating a C/C++ project.
- Makefile Project
— Creates an empty project without any metadata files. For more information about this type, see Creating a C/C++ project.
Note:
When you create a shared library, it's name is recorded in a special dynamic section. You can display the information in this
section to see a SONAME record. For example, you can use the following:
ntoarm-readelf -d libname.so
When you link against this library, your application will look for that name.
When you perform a make install, the .so is copied to .so.1, and a .so symbolic link is created to point to it. You'll also notice that .so will get the right version. If you install a .so.2 (where the .so points to it), your old version 1 clients can still run.
-
Toolchain
- Select a required toolchain from the Toolchain list. A toolchain represents the specific tools (such as a compiler, linker, and assembler) used to build your project. Additional
tools, such as a debugger, can also be associated with a toolchain. Depending on the compilers installed on your system, there
might be several toolchains available to select from.