Building from the command line

You can build one or more projects from the command line using mkbuild commands with one of the following formats:

mkbuild -ws <workspace> [options] 
mkbuild [-project] <dir> [options] 
mkbuild -ws <workspace> -projects <project1[,project2...]> [options]

Where:

workspace is the path of the IDE workspace
dir is a full project pathname where one or more projects are built
project1[,project2...] is the list of projects to build, where each project is a type supported by the IDE: Makefile project, QNX project, Managed project, or Container project.
options can be:
- -stopOnError — stop on the first compile error. This option isn't valid for a full workspace build.
- -targets target1[,target2...] — the make targets (build, clean, rebuild, or a custom target).
  
  For a Makefile or a Container project, use this option to pass the configuration name to mkbuild. Note that the configuration names you define must not contain spaces or non-standard characters; the list of unacceptable characters is given below.
- -variant variant — The build variant:
  - For a Managed project, the variant is the configuration to build. If it's not assigned, the default is used.
  - For a QNX project, the variant is All, Enabled, or platform/type (e.g., x86/release). Enabled means build the configurations selected in the Build Variants tab of the project's properties.
  - For a workspace, the variant option isn't used. The default variant for each project is used.
  - For multiple projects, the defined variant for each project is used (the project must understand the variant).
Note: In the project and configuration names, and the list of projects, targets, or variants, don't use spaces or any of the following characters:
| ! $ ( " ) & ` : ; \ ' * ? [ ] # ~ = % < > { }
These characters cause problems because mkbuild doesn't like them in directory and file names.
The environment variable QDE can be used to override the default IDE installation location ($QNX_HOST/usr/qde). This variable must be defined on the command line before the mkbuild command (e.g., QDE=path mkbuild ...).

If a project doesn't support a target, the default target gets built. By default, for make projects, no targets are defined; make targets have to be created from the UI in order to use named targets.

Examples

To build a default target and variant for the project projectA:

mkbuild /home/user/workspace/projectA

To build all projects in a specified workspace:

mkbuild -ws /home/user/workspace

To build using another IDE installation:

QDE=/home/user/IDE4.6 mkbuild ...

To build the projectA and projectB projects with clean, all targets, and the x86 variant/configuration:

mkbuild -ws /home/user/workspace -projects projectA,projectB -target \
clean,all -variant x86