Launching a Program

In this section, you will run learn how to run ProvideX programs from the Workbench. Prior to running the DemoApp please do a clean build and make sure there are no errors. For more information on building the project see Getting Started > Project Tutorial > Building ProvideX Projects > Build the DemoApp Project.

1. From the Workbench toolbar, select Run > Run Configurations...

2. The Run Configurations dialog opens. This allows you to configure how a program is launched, including its arguments, and other options.

3. Right click the ProvideX Application from the list and select New Configuration.

   

4. The ProvideX Application launch configuration dialogue will appear. The ProvideX launch configuration dialogue has four tabs:
   

   • Application
   • Arguments
   • Source
   • Common

The Application Tab

The Following fields reside on the Application tab (below the Name field): ProvideX project, ProvideX program to run, ProvideX Executable, and Working Directory.

1. Enter "DemoApp" in the Name field.

2. In the ProvideX project section, click the Browse button and select the DemoApp project.

3. In the ProvideX program to run section, click the Search button. Browse to, and select, the menu program in the project's output directory (compiled\prog\menu)

   Note: Do not select the menu file in the input directory.

4. Accept the default ProvideX Executable which will be the one that was selected for the workspace during the configuration of the ProvideX plug-in.

5. In the Working Directory section, the default value will be the root directory for the workspace; simply add the name of the project output directory (DemoApp\compiled) to the end of the default value

6. The Application tab is done, click Apply:

   

The Arguments Tab

The following fields reside on the Arguments tab: Program Arguments, Path to Ini file, and Window state./p>

1. Select the Arguments tab.

2. By default, the program will use the project's default ini file. The project's default ini file is found in the project's root directory. For more information on the default ini file see Project Tutorial > Creating a ProvideX Project. To specify an ini file, use the Search button. Browse to, and select, a ProvideX ini file located in any directory. This application will run with the default ProvideX ini file, so leave this field blank.

3. Enter "-hd" in the Window state field so that the main window of ProvideX is hidden when the menu program is run.

4. The Arguments tab is done. Click Apply.

   

5. Click Run to run the menu program.

   

6. Exit the ProvideX menu program.

7. Examine the Eclipse Console view. Messages regarding the life cycle of the ProvideX program will be printed to the Console view.

   

8. To re-run this program, press Ctrl + F11 or press the run icon on the Workbench toolbar.

Next Section: Launching a Program in WindX