Setting preferences for UML-to-Real-Time-C++ transformations

You can set active transformation and project configuration management preferences for UML capsule development projects.

About this task

To set transformation configuration preferences for UML capsule development projects:

Procedure

  1. Click Window > Preferences > UML Development.
  2. Optional: To configure preferences for the number of allowed transformation configurations, complete one of the following steps:
    • To allow multiple active configurations, select Allow multiple active transformation configurations per project. If multiple active configurations are allowed, when you set active configurations in the project properties, you must manually deactivate any transformation configurations that you do not want to run when a project build starts.
    • To prevent multiple active configurations from being selected, clear Allow multiple active transformation configurations per project. If more then one configuration is active when this option is cleared, only the first active configuration remains active.
  3. Optional: To keep inactive target projects open when you work with smaller projects or switch frequently between active configurations, clear Close inactive slave projects automatically. By default, the target projects associated with inactive transformation configurations close automatically to improve system performance when you work with large projects.
  4. Optional: When a transformation runs, the software automatically checks the transformation configuration source for completeness. If sources are missing, a list of missing sources is displayed. You can either add the sources or cancel the transformation. To prevent the validation of configuration sources, clear the Validate closure of transformation configuration sources option.
  5. Optional: To turn off the prompt that notifies you when build configurations for the target project are inconsistent, click UML to C++ transformation, and clear Prompt when target CDT active configurations aren't consistent. The build configurations for target projects are configured manually in the target projects that the transformation configurations reference. When a UML-to-Real-Time-C++ transformation runs, all the target projects in the dependency chain are checked for active build configurations that are consistent with each other. If they are not consistent, you are prompted to choose a single active build configuration for the target projects.
  6. Optional: To improve build performance for UML development projects with multiple dependencies to other projects, click Run transformation configurations only when there are Eclipse resource or model changes. When selected and an active transformation configuration is run, the UML development builder determines which prerequisite transformation configurations reference model projects containing changes, and runs only those transformations.

    By default, the UML development builder runs the active transformation configuration, and all its prerequisite configurations, regardless of whether the prerequisite transformations reference model resources that have changed.

  7. Optional: To set options for synchronizing manual changes in the generated code source with their associated model elements, in the Preferences window, expand UML Development, click Code to Model Synchronization, and then perform the following steps:
    1. To prevent the manual changes you produce in generated source code from synchronizing with the UML development model, under Synchronize generated sources with the model on resource save, select Never. By default, if you save a generated source file, the resource is analyzed to determine if the generated sources differ from the source snippets contained in the model. If there are differences, a window opens showing the comparison between existing and new source; you then select the changes you want to synchronize with the model.
    2. When you save a code file resource and code-to-model synchronization is enabled, if the associated model is not opened during a code-to-model synchronization, then the changes in the associated source files are not synchronized with the model. To open the closed models automatically, under Automatically open closed models, select Always. By default, if you edit a source file generated from model elements in a currently closed model resource, you are prompted to open the closed model when you save a file resource and code-to-model synchronization is enabled.
  8. Optional: To configure settings for a prompt that enables you to choose a single active build configuration when the active build configurations for target projects are not consistent with each other, in the Preferences window, expand Real Time, click C++ Transform, and then choose one of the following options:
    • Prompt when target CDT active configurations aren't consistent - The build configurations for target CDT projects are configured manually in the target projects that the transformation configurations reference. When a UML-to-Real-Time-C++ transformation is run, all the target projects in the dependency chain are checked for active build configurations that are consistent with each other. If they are not consistent, then by default you are prompted to choose a single active build configuration for the target projects.
    • If the target project build configurations are inconsistent by design, to turn off the prompt, clear Prompt when target CDT active configurations aren't consistent.
  9. Click Apply and click OK.

Feedback