Selecting a Development Environment

You can develop applications with Connext DDS either by building and executing commands from a shell window, or by using a development environment like Microsoft® Visual Studio®, Eclipse™, or GPS from AdaCore1Ada support requires a separate add-on product, Ada Language Support. .

Using the Command-Line Tools on UNIX-based Systems

By default, examples are copied into your home directory the first time you run RTI Launcher or any script in <NDDSHOME>/bin. This document refers to the location of the copied examples as <path to examples>.

Wherever you see <path to examples>, replace it with the appropriate path.

Default path to the examples:

• Mac OS X systems: /Users/your user name/rti_workspace/5.2.0/examples
• UNIX-based systems: /home/your user name/rti_workspace/5.2.0/examples
• Windows systems: your Windows documents folder\rti_workspace\5.2.0\examples

Where 'your Windows documents folder' depends on your version of Windows. For example, on Windows 7, the folder is C:\Users\your user name\Documents; on Windows Server 2003, the folder is C:\Documents and Settings\your user name\Documents.

Note: You can specify a different location for rti_workspace. You can also specify that you do not want the examples copied to the workspace.

For Java applications, you can use the following script files to build and execute.

• <path to examples>/connext_dds/java/<example>/build.sh—Builds your Java source files; no parameters are needed.
• <path to examples>/connext_dds/java/<example>/run.sh—Runs the main program in either Publisher or Subscriber mode. It accepts the following parameters:
  • [pub|sub]—Run as publisher or subscriber
  • –verbose—Increases output verbosity
• (This script accepts other options, which we will discuss later.)

For C, C++, and Ada applications, you can use the make command with this makefile:

<path to examples>/connext_dds/<language>/<example>/make/Makefile.<architecture>

where <architecture> reflects the compiler, OS and processor combination for your development environment. If you do not see your architecture listed, see Generating Code with RTI Code Generator for instructions on how to generate an example makefile.

Using the Command-Line Tools on Windows Systems

By default, examples are copied into your home directory the first time you run RTI Launcher or any script in <NDDSHOME>/bin. This document refers to the location of the copied examples as <path to examples>.

Wherever you see <path to examples>, replace it with the appropriate path.

Default path to the examples:

• Mac OS X systems: /Users/your user name/rti_workspace/5.2.0/examples
• UNIX-based systems: /home/your user name/rti_workspace/5.2.0/examples
• Windows systems: your Windows documents folder\rti_workspace\5.2.0\examples

Where 'your Windows documents folder' depends on your version of Windows. For example, on Windows 7, the folder is C:\Users\your user name\Documents; on Windows Server 2003, the folder is C:\Documents and Settings\your user name\Documents.

Note: You can specify a different location for rti_workspace. You can also specify that you do not want the examples copied to the workspace.

For Java applications, you can use the following script files to build and execute.

• <path to examples>\connext_dds\java\<example>\build.cmd—Builds Java source files; no parameters are needed.
• <path to examples>\connext_dds\java\<example>\run.cmd—Runs the main program, Hello, in either Publisher or Subscriber mode. It accepts the following parameters:
  • [pub|sub]—Run as publisher or subscriber
  • –verbose—Increases output verbosity
• (This script accepts other options, which we will discuss in later sections.)

For Java users:

The native libraries used by the RTI Java API require the Visual Studio redistributable libraries on the target machine. You can obtain this package from Microsoft or RTI.

Using Microsoft Visual Studio

For C, C++, and C# users: Please use a supported version of Microsoft Visual Studio to build and run the examples. Supported versions are listed in the Platform Notes.

By default, examples are copied into your home directory the first time you run RTI Launcher or any script in <NDDSHOME>/bin. This document refers to the location of the copied examples as <path to examples>.

Wherever you see <path to examples>, replace it with the appropriate path.

Default path to the examples:

• Mac OS X systems: /Users/your user name/rti_workspace/5.2.0/examples
• UNIX-based systems: /home/your user name/rti_workspace/5.2.0/examples
• Windows systems: your Windows documents folder\rti_workspace\5.2.0\examples

Where 'your Windows documents folder' depends on your version of Windows. For example, on Windows 7, the folder is C:\Users\your user name\Documents; on Windows Server 2003, the folder is C:\Documents and Settings\your user name\Documents.

Note: You can specify a different location for rti_workspace. You can also specify that you do not want the examples copied to the workspace.

Connext DDS includes solutions and project files for Microsoft Visual Studio in
<path to examples>\connext_dds\[c|c++|cs]\<example>\win32.

To use these solution files:

1. Start Visual Studio.
2. Select File, Open, Project/Solution.
3. In the File dialog, select the solution file for your architecture. For example, a solution file for Visual Studio 2012 for 32-bit platforms is in
   <path to examples>\connext_dds\[c|c++|cs]\<example>\win32\Hello-i86Win32VS2012.sln.

© 2015 RTI