KDevelop5/Manual/Running programs: Difference between revisions

Latest revision as of 04:48, 27 August 2020

Running programs in KDevelop

Once you have built a program, you will want to run it. To do this, need to configure Launches for your project. A Launch consists of the name of an executable, a set of command line parameters, and an execution environment (such as "run this program in an external terminal", or "run this program in the debugger").

Setting up launches in KDevelop

Select Run -> Configure launches from the menubar.
Highlight the project you want to add a launch for and click on the /Add button.
From the drop down menu shown, select the name of the launch configuration.
Enter the name you want to call the launch configuration (you can edit it later by double clicking it ).
In the executable tab, choose the project target or the path where you want to run the program.

Any required command line arguments can be specified in the Arguments: edit box.

If you need to build the executable or add libraries before running it,add the dependencies tab at the bottom of the page,

select Build from the dropdown Action: menu.
Select the symbol to the right of the textbox and select whatever target you want to have built.
Click Ok.

To configure a debug launch:

Select on the Debug symbol under the selected launch configuration on the left tab.
add the path to the debugger program.

if this is the system's default debugger (e.g. gdb on Linux), then you don't need to do this step.

To run the program:

From the menu bar, select Run -> Execute Launchor use the shortcut Shift + F9.

Your program should now run in an external terminal window of KDevelop. The picture above shows the result: The new Run tool subwindow at the bottom shows the output of the program that is being run, in this case the nano text editing program.

Note

If you have configured multiple launches, you can choose which one should run when you hit Shift + F9 by going to Run -> Current Launch Configuration. There is a non-obvious way to edit the name of a configuration, however: in the dialog box you get when you select Run -> Current Launch Configuration, double-click on the name of the configuration in the tree view on the left, which will allow you to edit the configuration's name.

Some useful keyboard shortcuts

Running a program
F8	Build (call make)
Shift + F9	Run
F9	Run program in the debugger; you may want to set breakpoints beforehand, for example by right-clicking with the mouse on a particular line in the source code

@@ Line 15: / Line 15: @@
 <!--T:5-->
-To set this up go to menu item <menuchoice>Run -> Configure launches</menuchoice>, highlight the project you want to add a launch for, and click on the {{Plus}} button. Then enter the name and location of the executable, and the path where you want to run the program.  Any required command line arguments if any, can be specified in the <menuchoice>Arguments:</menuchoice> edit box. If running the executable depends on building the executable and/or other libraries first, then you may want to add them to the list at the bottom: select <menuchoice>Build</menuchoice> from the dropdown <menuchoice>Action:</menuchoice> menu, then hit the {{Icon|folder}} symbol to the right of the textbox and select whatever target you want to have built. While you're there, you may as well also configure a debug launch by clicking on the <menuchoice>Debug</menuchoice> symbol and adding the name of the debugger program; if this is the system's default debugger (e.g. '''gdb''' on Linux), then you don't need to do this step.
+*  Select <menuchoice>Run -> Configure launches</menuchoice> from the menubar.
+*  Highlight the project you want to add a launch for and click on the {{Plus}}/<menuchoice>Add</menuchoice> button.
+*  From the drop down menu shown, select the name of the launch configuration.
+*  Enter the name you want to call the launch configuration (you can edit it later by double clicking it ).
+*  In the executable tab, choose the project target or the path where you want to run the program.
+Any required command line arguments can be specified in the <menuchoice>Arguments:</menuchoice> edit box.
+<!--T:17-->
+[[File:KDevelop-arguments-config.png.png|800px|thumb|center]]
+<!--T:18-->
+If you need to build the executable or add libraries before running it,add the dependencies tab at the bottom of the page,
+* select <menuchoice>Build</menuchoice> from the dropdown <menuchoice>Action:</menuchoice> menu.
+* Select the {{Icon|folder}} symbol to the right of the textbox and select whatever target you want to have built.
+* Click Ok.
+<!--T:19-->
+To configure a debug launch:
+*  Select on the <menuchoice>Debug</menuchoice> symbol under the selected launch configuration on the left tab.
+*  add the path to the debugger program.
+<!--T:20-->
+if this is the system's default debugger (e.g. '''gdb''' on Linux), then you don't need to do this step.
 <!--T:6-->
@@ Line 21: / Line 43: @@
 <!--T:7-->
-You can now try to run the program: Select <menuchoice>Run -> Execute Launch</menuchoice> from '''KDevelop's''' main window menu (or hit <keycap>Shift + F9</keycap>) and your program should run in an external ''terminal window'' of '''KDevelop'''. The picture above shows the result: The new <menuchoice>Run</menuchoice> tool subwindow at the bottom shows the output of the program that is being run, in this case of the '''''nano''''' program.
+To run the program:
+*  From the menu bar, select <menuchoice>Run -> Execute Launch</menuchoice>or use the shortcut <keycap>Shift + F9</keycap>.
+Your program should now run in an external ''terminal window'' of '''KDevelop'''. The picture above shows the result: The new <menuchoice>Run</menuchoice> tool subwindow at the bottom shows the output of the program that is being run, in this case the '''''nano''''' text editing program.
 <!--T:8-->
@@ Line 32: / Line 56: @@
 </translate>
-{| class="wikitable" style="border:1px solid" width="500"
+{| class="tablecenter" style="border:1px solid" width="500"
 ! colspan="2" style="background:#ffff99; text-align:center" |<translate> <!--T:13-->
 Running a program
-|-style="font-weight:bold; text-align:left;"
-! width=15% style=" border:1px solid gray;"| Shortcut
-! width=85% style=" border:1px solid gray;"| Result
 |-
 <!--T:14-->
- | <keycap>F8</keycap>
+| style="width: 15%"|<keycap>F8</keycap>
- | Build (call make)
+| style="width: 85%"|Build (call make)
 |-