Launch Configurations - 2023.1 English

Vitis Unified IDE and Common Command-Line Reference Manual (UG1553)

Document ID
UG1553
Release Date
2023-07-17
Version
2023.1 English

Launch configurations save the environment setup for running or debugging the project. The launch configurations are stored in a launch.json file associated with a component or System project. The launch.json file can contain one or more launch configurations for running or debugging the component or project.

To view and edit launch configurations you can select the launch.json file for a component or System project in the Component Explorer view, or select Open Settings next to Run or Debug in the Flow Navigator.

Tip: The Open Settings command is a hidden icon that appears when you place your cursor in the Flow Navigator next to either Run or Debug.

This opens the launch.json file and lets you edit the launch configurations contained within. The Launch Configuration editor has a toolbar menu at the top, as shown in the figure below. The figure shows the System Project Launch Configuration editor as an example. The specific contents of the launch configuration will vary depending on the component or project selected.

Figure 1. Launch Configurations

The commands in the toolbar include:

  • Settings Form / Source Editor: You can toggle between the GUI view and Text Editor view of the launch.json file with these commands.
  • Undo/Redo: undo or redo the last actions.
  • Add Configuration: You can add a configuration by clicking the + button. The default launch configurations for System projects are: Emulation SW, Emulation HW and Hardware.
  • Run / Debug: Launch run or debug using the currently selected launch configuration.

Place your mouse over the configuration name and the Duplicate and Delete commands will appear. Select Delete to remove the launch configuration, or Duplicate to copy the launch configuration.

In each configuration, you can update the settings to configure the tool prior to running or debugging the component or project. After setting up the launch configuration, you can select Run or Debug commands in the Launch Configuration editor, or by selecting Run or Debug from the Flow Navigator and specifying a launch configuration if more than one is available.