PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

  • Overview
  • Creating a project for Linux with WINDEV
  • Creating a project configuration for Linux
  • Running the test of a Linux WINDEV project
  • Creating the Linux executable
  • Distributing the Linux executable
  • Using a Linux executable
  • Special case: Using 32-bit Linux executables on a 64-bit Linux system
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Overview
WINDEV allows you to develop applications for the Linux operating system.
The method for developing applications for Linux with WINDEV is identical to the method for developing applications for Windows except for some differences. See Limits of WINDEV applications for Linux for more details.
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 the Linux distributions.
Versions 21 and later
Note: To benefit from the management of SVG images, the QT library installed must support the SVG format.
New in version 21
Note: To benefit from the management of SVG images, the QT library installed must support the SVG format.
Note: 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.
Notes:
  • 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).
Creating a project for Linux with WINDEV
To create a Linux project with WINDEV:
  1. Select "File .. New .. Project". The wizard for project creation 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 wizard for project creation 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 wizard step.
  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.
Once your project is created, your project can be developed like any standard WINDEV project:
  • 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.
Note: The analysis of a Linux WINDEV project can use the following types of data files:
  • HFSQL Classic.
  • HFSQL Client/Server.
  • MySQL.
  • MariaDB.
  • PostgreSQL.
  • SQLite.
Creating a project configuration for Linux
To use an existing WINDEV project in Linux, you must create a project configuration specific to the creation of Linux executables.
To create a new project configuration for Linux:
  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.
Note: You have the ability to include project elements in the project configuration or to exclude project elements from the project configuration via the "Project explorer" pane ("Include in the current configuration" or "Exclude from the current configuration").
See Project configuration for more details.
To develop your project:
  • 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.
Running the test of a Linux WINDEV project
In Linux mode, the test of a window or the test of the project can be run via the corresponding GO. The test of the application is run in Windows.
Caution: When running a test of the Linux WINDEV application in GO mode, the specific features of Linux are ignored: all the controls operate (even the ones that are not supported in Linux).
Creating the Linux executable
To create the Linux executable:
  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. Enter the name of the executable. 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 "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).
      Note: If these files use a specific case, this case must be respected in the code of the application (Linux being a "case sensitive" system).
Distributing the Linux executable
The Linux applications have no setup like in Windows.
To distribute a WINDEV Linux application, the entire content of the generation directory must be supplied to the users.
To run the test of the Linux executable created with WINDEV and to distribute it:
  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 /.).
Note: To update a Linux application, you must:
  • 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

To use a Linux executable, the QT library (Core and GUI) version 4.5 (or later) must be installed.
In Ubuntu, this library can be installed with the following commands:
sudo apt-get install libqtcore4
sudo apt-get install libqtgui4
In mandriva 2010 Spring, this library can be installed with the following commands:
urpmi libqtgui4
Versions 21 and later
Note: To benefit from the management of SVG images, the QT library installed must support the SVG format.
New in version 21
Note: To benefit from the management of SVG images, the QT library installed must support the SVG format.
Note: 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

To use a 32-bit Linux executable on a 64-bit Linux system, a specific module must be installed.
In Ubuntu, the steps are as follows:
  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
Related Examples:
WD Managing Contacts Complete examples (WINDEV): WD Managing Contacts
[ + ] This example presents the management of contacts in WINDEV.
The following topics are presented in this example:
1/ the loopers
2/ the label reports
3/ the queries
4/ sending emails
5/ using Outlook
6/ handling the data found on a mobile device.
Summary of the example supplied with WINDEV:
This example is used to manage the contacts and to send emails.
It also enables you to synchronize these contacts with the ones found on the mobile device connected to the PC and with the ones found in Outlook.
Minimum required version
  • Version 16
Comments
Click [Add] to post a comment