The WINDEV executables for Linux use the graphic QT library. Therefore, this library must necessarily be installed on the Linux computers (version 4.5 or later). This library is a standard library, available on most of Linux distributions.

Versions 21 and later
Remark: To benefit from the management of SVG images, the QT library installed must support the SVG format.

New in version 21
Remark: To benefit from the management of SVG images, the QT library installed must support the SVG format.

Remark: To benefit from the management of SVG images, the QT library installed must support the SVG format. See Distributing a Linux application for more details.

• The following Linux distributions are supported:
  • Debian 7 (and later).
  • Ubuntu 14 (and later).
• The Linux applications developed with WINDEV operate on the devices equipped with an Intel processor or with a processor compatible with Intel (the ARM processors are not supported).

1. Select "File .. New .. Project". The project creation wizard starts. Click among the quick access buttons.
   • Click "Project" in the wheel that is displayed. The window for creating a new element is displayed: click "Project".
   • The project creation wizard starts.
2. Choose the name and location of your project. You have the ability to enter a short description of the project. Go to the next step of the wizard.
3. Add (if necessary) design documents to the project. Go to the next step.
4. In the "Description - Type of project" step, select "Application". Go to the next step.In the "Description - Type of project" step, select "Windows application (desktop)". Go to the next step.
5. In the "Description - Platform" step, select "Linux platform". In the "Description - Operating system" step, select "Linux platform". Go to the next step.
6. Versions 18 and later
   In the "Description - Platform" step, select the runtime mode of the application:

   • Linux 32-bit executable.
   • Linux console 64-bit executable.
   New in version 18
   In the "Description - Platform" step, select the runtime mode of the application:

   • Linux 32-bit executable.
   • Linux console 64-bit executable.
   In the "Description - Platform" step, select the runtime mode of the application:
   • Linux 32-bit executable.
   • Linux console 64-bit executable.
7. The rest of the wizard is performed like for any other platform. See Creating a WINDEV project for more details.

• 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 run time.

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

1. Select "Project .. Project configurations .. New configuration". The wizard for creating a configuration starts. Go to the next step.On the "Project" pane, in the "Project configuration" group, click "New configuration" and select "New configuration (via wizard)". The wizard for creating a configuration starts. Go to the next step.
2. Specify the name and description of the configuration and select "32-bit Linux executable". Go to the next step. Specify the name and description of the configuration and select "Windows executable (Desktop)". Go to the next step.
   • Select the "Linux platform" operating system. Go to the next step.
   • Select the platform: Linux 32-bit executable or Linux console 64-bit executable. Go to the next step.
3. Select the elements that must be included in the project configuration (windows, queries, ...).
4. Validate.

• 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 run time.
• In the Linux configuration, compilation errors indicate the functions not available in Linux.

1. Select "Workshop .. Executable .. Generate the Linux executable".Click among the quick access buttons (this button is found if the current configuration is a Linux configuration).
2. The wizard for creating a Linux executable starts.
3. Type the executable name. The same name is automatically given to the library associated with the executable.
4. Versions 18 and later
   Select the mode for using the library: library included in the executable, external library, ... By default, the library is included in the executable.
   New in version 18
   Select the mode for using the library: library included in the executable, external library, ... By default, the library is included in the executable.
   Select the mode for using the library: library included in the executable, external library, ... By default, the library is included in 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 by 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
    • the URL of the Web site: You can specify the URL of your site for example.
    • the email address: Email address where the users of the application can contact 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 by 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 proposed 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 run time.
    • the .FIC, .MMO and .NDX files if your application is using 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 code of the application (Linux being a "case sensitive" system).

1. Connect to the Linux computer via the "WinScp" application for example.
2. Copy the content of the generation directory onto the Linux computer: executable, *.WDL and *.soCopy the content of the generation directory onto the Linux computer: executable, *.WDL (if an external library was chosen) 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 popup menu of the file
   • use the following command line in the console:
     
     chmod + x myapp
4. Run the program. For example, to start the executable of the current directory, use the following notation: ./myapp (the name of the application must be preceded by /.).

• regenerate the executable.
• Versions 18 and later
  copy the executable file only in the directory of the Linux application (if the library is included in the executable).
  New in version 18
  copy the executable file only in the directory of the Linux application (if the library is included in 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

Versions 21 and later
Remark: To benefit from the management of SVG images, the QT library installed must support the SVG format.

New in version 21
Remark: To benefit from the management of SVG images, the QT library installed must support the SVG format.

Remark: To benefit from the management of SVG images, the QT library installed must support the SVG format.

Special case: Using 32-bit Linux executables on a 64-bit Linux system

1. Switch to root mode:
   
   sudo su
   <Enter the password of the connected user>
2. Check whether the computer is in 64 bits:
   
   uname -a
   
   The following code is returned:
   
   Linux twr24o-7 2.6.35-23-generic #41-Ubuntu SMP Wed Nov 24 11:55:36 UTC 2010 x86_64 GNU/Linux
3. Install the support for 32 bits on a computer in 64 bits:
   
   apt-get install ia32-libs