Generating code

Generating code

Once all the necessary information for the new RT Component has been specified, the template code can be generated. On the Basic Profile tab, click the Generate button to generate the template code.

The generated template files are as follows, dependent on the language selected:

• All

• C++

• Java

• Python

~* RTC Builder will parse the IDL file(s) when generating the template code in order to generate the operation templates for the service providers. However, the following limitations apply to this:

• Only #include can be used by the preprocessor. #ifdef, etc. are ignored.
• The generated operations are only those directly specified by the interface. Inherited operations are not generated.

Output selection

If an output file of the code to be generated already exists, and there are differences between the existing file and the generated file, it will request confirmation of how to merge the two files.

In this screen there are three options to select from.

• Original： Use the existing file.
• Merge： Merge using a merge block*.
• Generate： Overwrite using the generated code.

~* When merging, only blocks of code surrounged by <rtc-template block="block"> tags will be overwritten by newly generated code. Unchanged code in a generated file will already be surrouned by these tags. The contents of these tags will be replaced when merging, so take care not to change code within these tagged blocks.

Changing perspective

If the correct development environment plugins are installed for the language the template was generated in, after generation is complete the perspective will ask to change to the correct perspective for that language.

The necessary development plugins are:

• Java： JDT (Java Development Tools) - already included in Eclipse
• C++： CDT (C/C++ Development Tooling)
• Pytho： PyDev

~* When the correct development plugins are installed, and a new project is generated, the correct properties will be set for the language in use.

Loading and Saving Settings

RTC Builder can save and load the contents of the RTC Profile Editor entered by the user to and from an RTC Profile XML file (RTC.xml).

Saving

Use one of the following methods to save the editor contents to an RTC Profile XML file.

• Press Ctrl-S
• Right-click in the editor and select Save or Save As... from the context menu
• Select Save or Save As... from the File menu.

~* Save As... allows the profile to be saved to any project.

Loading

Use one of the following methods to load an RTC Profile into the editor from an RTC Profile XML file.

• Right-click on the editor and select Open from the context menu.
• Select Open File... from the File menu.
  
  
  Loading