Start the CMake GUI, either from a terminal window or a menu.
Please note that the cmake-gui does not set the CMAKE_BUILD_TYPE variable. This variable is used to determine the names of the RTI Connext DDS Micro libraries. Thus, it is necessary to add CMAKE_BUILD_TYPE manually and specify either Debug or Release. To add this variable manually, click the 'Add Entry' button, specify the name as a string type.
As an alternative rtime-make's –gui option can be used. This option starts the CMake and also adds the CMAKE_BUILD_TYPE option when the CMake GUI exits.
Please note that when using Visual Studio or Xcode it is important to build the same configuration as was specified with rtime-make's –config option. While it is possible to build a different configuration from the IDE, selecting a different configuration does not update the build configuration generated for RTI Connext DDS Micro.
It is recommended that the GUI is started from the RTIMEROOT directory. If this is not the case, check that:
- The source directory is the location of RTIMEROOT.
- The binary directory is the location of RTIMEBUILD.
With the CMake-gui running:
- Press 'Configure'.
- Select a generator. You must have a compatible tool installed to process the generated files.
- Select 'Use default native compilers'.
- Press 'Done'.
- Press 'Configure'.
- Check 'Grouped'.
- Expand RTIME and select your build options. All available build options for RTI Connext DDS Micro are listed here.
- Type a target name for RTIME_TARGET_NAME. This should be the same as the <name> used to create the RTIMEBUILD directory, that is the RTIMEBUILD should be on the form <path>/<RTIME_TARGET_NAME>.
- Press 'Configure'. All red lines should disappear. Due to how CMake works it is strongly recommended to always press 'Configure' whenever a value is changed for a variable. Other variables may depend on the modified variable and pressing 'Configure' will mark those with a red line. No red lines means everything has been configured.
- Press 'Generate'. This creates the build-files in the RTIMEBUILD directory. Whenever an option is changed and configure is re-run, press Generate again.
- Exit the GUI.
Depending on the generator, do one of the following:
- For IDE generators (such as Eclipse, Visual Studio, Xcode) open the generated solution/project files and build the project/solution.
- For command-line tools (such as make, nmake, ninja) change to the RTIMEBUILD directory and run the build-tool.
After a successful build, the output is placed in RTIMEROOT/lib/<name>
The generated build-files may contain different sub-projects that are specific to the tool. For example, in Xcode and MS Visual Studio the following targets are available:
- ALL_BUILD - Builds all the projects.
- rti_me_<name> - Build only the specific library. Note that that dependent libraries are built first.
- ZERO_CHECK runs CMake to regenerate project-files in case something changed in the build input. This target does not need to be built manually.
For command-line tools, try <tool> help for a list of available targets to build. For example, if Unix makefiles where generated:
make help