1. Click in the quick access buttons.
   • In the window that appears, click "Project".
   • The project creation wizard starts.
2. In "Description - Type of project", select "Windows or Linux application". Go to the next step.
3. Select the desired style book. This style book will be available by default when creating a window or report, and will be applied to all new controls. This option can be modified in the project description window ("Style" tab). Go to the next step.
4. Specify the project name and location.
5. Finish the wizard. The created project becomes the current project. This project contains a "64-bit Windows executable" project configuration..
6. Close the element creation window.

• Modify current configuration.
• Add a new Linux configuration to your project (and delete the Windows configuration if necessary). For more details, see Creating a project configuration for Linux.

1. In the "Project Explorer" pane, select the "Windows 64-bit executable" configuration.
2. Display the context menu and select "Description" from the context menu.
3. In the "General" tab:
   • Change the configuration name (for example: "64-bit Linux executable").
   • Modify application type. Select "Linux application"..
4. Validate the project configuration window.

• Only the controls available for Linux can be created.
• In the description windows, the options that are not available for Linux are automatically grayed.
• Compilations errors indicate the functions and the controls not available in Linux.
• If unavailable controls are found in the Linux executable, a fatal error is displayed at runtime.

• HFSQL Classic.
• HFSQL Client/Server.
• MySQL.
• MariaDB.
• PostgreSQL.
• SQLite.

1. Start the wizard for creating a new configuration: in the "Project Explorer" pane, display the context menu for the "Configurations" option and select "New configuration".
2. Enter the name and description of the project configuration and select "Windows or Linux application".
3. In the next step of the wizard, specify the operating system: "Linux platform".
4. Finish the wizard. The project configuration is created and automatically selected..

• The controls not available for one of the configurations are displayed in blue in the editor.
• In the description windows, the options that are not available in the current configuration are automatically grayed. The options not available in one of the configurations are displayed in blue.
• In the Linux configuration, compilation errors indicate the controls not available in Linux.
• If unavailable controls are found in the Linux executable, a fatal error is displayed at runtime.
• In the Linux configuration, compilation errors indicate the functions not available in Linux.

1. Click in the quick access buttons (this icon appears if the current configuration is a Linux configuration).
2. The Linux executable creation wizard starts.
3. Type the executable name. The same name is automatically given to the library associated with the executable.
4. Select how the library is to be used: built-in library, external library, ... By default, the library is integrated into the executable.
5. Specify the error message that will be displayed on the console when a runtime error occurs.
6. Specify whether the executable will take the patch libraries into account.
7. Specify the languages supported by the executable.
8. Specify the elements that will be included in the library.
9. Select (if necessary) the components used by the executable.
10. Specify the information about the executable. This information can be retrieved through programming with ExeInfo. This information is as follows:
    • the name of the company. For example, the name of the publisher.
    • a short description of the application purpose. For example: "Inventory management".
    • the copyright of the application
    • Website URL: You can enter the URL of your website, for example.
    • Email address: Email address where application users can reach you.
11. Specify the version number of the executable. The version of an executable is used to find out the features available (or not) in the application used by the end user. This version number can be retrieved through programming with ExeInfo.
    The format of the version number corresponds to a set of 4 numbers separated by dots.
    • The first group of 4 digits corresponds to the number of major changes performed in the application.
    • The second group of 4 digits corresponds to the number of minor changes performed in the application.
    • The third group of 4 digits corresponds to the number of changes without GUI modification performed in the application.
    • The last group of 4 digits corresponds to the number of reviews.
      We advise you to automatically increment this number at each generation. This increment operation is automatically performed if the option "Automatically increment the version at each generation" is checked.
12. Go to the next step. Accept (if necessary) the project backup suggested by the wizard.
13. The Linux executable is automatically generated. You have the ability to open the generation directory. This directory contains:
    • a file without extension that is the Linux executable.
    • possibly a WDL file with the same name. It is the library of the executable.
    • the .so files required at runtime.
    • the .FIC, .MMO and .NDX files if your application uses HFSQL Classic data files. The names of the data files must be written in lowercase characters. If data files were present before the project configuration was created, they have been copied in lowercase characters.
    • the files specific to this configuration (.ini configuration file for example).
      Remark: If these files use a specific case, this case must be respected in the application code (Linux being a "case sensitive" system)..

Note: To open a file explorer on the application's generation directory, under the "Home" pane, in the "General" group, pull down the option and select "Open generation directory"..

1. Connect to the Linux computer via the "WinScp" application for example.
2. Copy the contents of the generation directory to the Linux workstation: executable, *.WDL (if you've chosen an external library) and *.so.
3. Change the program attributes to grant execution rights to the program:
   • check "Allow the execution of the file like a program" in the context menu of the file
   • use the following command line in the console:
     
     chmod + x myapp
4. Run the program. For example, to launch the executable in the current directory, use the notation: ./myappli (the application name must be preceded by /.).

• regenerate the executable.
• copy the executable file only in the directory of the Linux application (if the library is included in the executable).
• copy the generated WDL file only in the directory of the Linux application (if the library is not included in the executable).

Using a Linux executable