PC SOFT

ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Home | Sign in | English EN
New WINDEV 26 feature!
  • In this lesson you will learn the following concepts
  • Overview
  • Creating the executable
  • Creating the setup
  • Installing an application
  • The different types of deployment
  • Overview
  • Setup with network update
  • Setup with Internet update
  • Multisite setup
Lesson 4.13. Deploying the application
In this lesson you will learn the following concepts
  • Creating the executable.
  • Help about the new features.
  • Creating the setup.
Lesson duration

Estimated time: 30 mn
Previous LessonTable of contentsNext Lesson
Overview
A full application was created, allowing you to discover several WINDEV features. We must now generate the executable and install the application on the user computers. That's what we are going to do in this part. So, you will be familiar with the main topics for developing a WINDEV application.

  • Open the project you worked on in the previous lesson if necessary.
    1. Go to the WINDEV home page (Ctrl + <).
    2. On the home page, click "Tutorial", then in "Part 4 - Full application with data", double-click "Full application (Exercise)".
    3. A dialogue box prompts you to open the project you worked on in the previous lesson. You can open the local copy or the original project. Select "Open the local copy".

Answer

A corrected project is available. This project allows you to perform the different operations in this lesson. To open the corrected project, go to the home page and click "Tutorial", then in "Part 4 - Full application with data", double-click "Full application (Answers)".
Creating the executable
It is very easy to create the executable: you will only need to go through one option and a few clicks.
We will now present in detail the different steps for creating the executable. You can click the "Finish" button to validate all the steps of the wizard at any time.
  • To create the executable:
    1. Expand Create an executable among the quick access buttons, and select "Generate the 32-bit Windows executable (.exe)".
      Generating the executable

      Remark

      WINDEV also allows you to create 64-bit executables, Linux executables, services, Java applications and more.
    2. The executable creation wizard starts.
    3. Describe the general options of the executable:
      • the executable name: we will keep the default name.
      • the name of icon associated with the executable: you have the ability to select an icon in the image catalog.
      • the splash screen. Several types of splash screens are available. A splash screen with animated text is selected by default. The "Options" button is used to configure it.

        Express

        This option is not available in the Express version.
        Executable creation wizard
      Choose "No splash screen" and go to the next step.
    4. For the operating mode of executable, we will keep the default options. Go to the next step.
    5. You can customize the application error message. We will keep the default message. Go to the next step.
    6. The wizard proposes to enable the telemetry in the application. We won't use this feature. Go to the next step.

      Remark

      Telemetry allows you to get detailed statistics about the use of your application by the end users. The telemetry shows you a report about your deployed applications, so you can improve them.
      For more information on how to set up and configure the telemetry, see Telemetry overview.
    7. This step is used to specify whether the executable will take the patches into account.

      Remark

      When the application is modified, to avoid proving the entire executable, you can provide the additional resources (windows, reports, etc.) as patches. These patches are additional libraries.
      If the option "Yes: the executable will take these updates by patch into account" was checked when the executable was created, the elements found in the patch will replace the elements found in the application library when the application starts.
      For more details, see Application patch.
      We will keep the default options. Go to the next step.
    8. This step is used to manage the executable languages. The multilingual feature will be presented in another lesson. We will keep the default options. Go to the next step.
    9. This step displays all files that will be included in the executable library. Those are the project elements that can be handled by the end user. We will keep the default options. Go to the next step.
    10. This step concerns the directory of HFSQL Classic data files used by the application.
      Executable creation wizard
      Select "Automatic (recommended)" if necessary. This option is used to install the data files:
      • in the application data directory (if the executable is installed in "Program files").
      • in the executable directory.
    11. Go to the next step.
    12. We are now going to type the information about the executable. This information is displayed in the Windows explorer by selecting the file properties.
      Type the following information:
      Executable creation wizard
      This step can also be used to sign the executable if necessary.
      Go to the next step.
    13. This step concerns the executable version number. You can use:
      • a format compatible with the earlier WINDEV versions,
      • a standard Windows format. Select this option.
    14. Go to the next step of the wizard.
    15. We are now going to define the options for integrating the WINDEV framework.

      Express

      This option is not available in the Express version.

      Remark

      The framework corresponds to the different libraries required to run the executable.
      The option "Framework DLL beside the executable" allows you to use the necessary libraries only. These DLLs are copied to the executable directory.
      The "Framework included in the executable" option allows you to distribute only the executable (since the DLLs are in the executable).
      The option "Common framework" allows you to use the framework common to all the WINDEV applications installed on the computer. With this option, the framework is installed once only on the computer (it can also be downloaded by Internet) and is used by all WINDEV applications.
    16. Select "Common framework" and choose "Common WINDEV framework".
      Go to the next step.
    17. This step concerns Windows Vista (and later). You can include a manifest for Windows Vista (and later).
      For our example, check "Don't include a manifest for Windows Vista and later".
      Go to the next step.
    18. WINDEV proposes to perform a project backup. This backup is used to keep a project version whenever the executable is created. In our case, select "No: Don't make a backup copy of the project" and validate the wizard.
    19. The executable is created. It can be run immediately to check its operating mode. To do so, click "Run executable".
That's it, the executable creation is ended. A lot of options to fill but after a first configuration of your choices, you will be able to validate all wizard steps from the beginning.

Remark

You also have the ability to click the steps specified in the wizard in order to reach a wizard screen directly. The default options of the other screens will be automatically validated.
Creating the setup
The setup is created via a wizard. This wizard allows you to define the main choices. You also have the ability to use the setup editor if the options proposed by the wizard are not suitable. We will not see its use in detail in this lesson. See The setup editor WDInst for more details.
We will now present the different steps for creating the setup program. You can click the "Finish" button to validate all the steps of the wizard at any time.
  • To create the setup program:
    1. On the "Project" pane, in the "Generation" group, expand "Setup procedure" and select "Create setup procedure". The executable and setup creation wizard starts.
    2. The executable was already created: the selected options are stored.
    3. In the wizard, click on "Additional information" in the "Executable" section.
    4. The wizard proposes to perform a project backup. Select "No: Don't make a backup copy of the project" and go to the next step.
    5. The wizard proposes to create the new features page.

      Express

      This option is not available in the Express version. In this case, go to step 8 directly.
      Documentation of new features
      This option is used to create a help file in order to present the new features to the end users. During a first setup, this file can correspond to the software help.
      Select "Create a documentation for the new features" and go to the next step.
    6. You have the ability to define the elements that will be automatically included in the help file. Keep the default options and go to the next step.

      Remark

      If the application already contains a help system, you can use it and include the new features page in it.
    7. Validate the message and the help file save window.
    8. The executable is automatically created (with the options defined when creating the executable) as well as the help system. You now have the ability to type specific information in the help system. In this case, keep the default information. To resume the creation of the setup program, click Continue the creation of the setup procedure, which corresponds to "Continue the creation of the setup procedure".
      Setup creation options
      The help is automatically compiled.
    9. Let's now go to the "Setup" section of the wizard. In this first screen, choose the setup mode:
      • Individual setup for an independent application, installed and started on each computer. We will choose this option.
      • Setup with automatic update, for a setup on a server. The applications will be installed from the server. In case of update, only the server must be updated. The applications installed on the computers will be automatically updated.
      Go to the next step.
    10. Choose a standard setup. Go to the next step.
    11. We will not change the default setup directory. Go to the next step.
    12. Keep the files that appear in the list of installed files. By default, WINDEV proposes the Executable file and the help file (created by the help of new features). We are going to add the data files:
      • Click the "Add" button. The Windows explorer displays the content of the application generation directory.
      • Select the Customer, Order, OrderLine, PaymentMode and Product data files (files with ".fic", ".ndx" and ".mmo" extension).
      • Validate. The files are automatically saved in the application data directory.
        Creating the setup
    13. Go to the next step.
    14. Uncheck all options from the database parameters. Go to the next step.
    15. Keep the following options in the additional modules:
      Setup - Additional modules
      We will choose the optional tools to install and we will include the uninstaller. The uninstaller will allow the users to uninstall the application from the Windows program manager. Go to the next step.

      Express

      The optional tools are not available in the Express version. In this case, go to step 16 directly.
    16. We will select WDOptimizer. This tool optimizes the application data files on a regular basis.
    17. Click "Medium" on the left of the wizard. The setup will be generated in a single directory. By default, the setup program is created in the project "Install" subdirectory. You can:
      • Specify a password for the setup. In this case, only the user who knows the password will be able to install the application.
      • Sign the setup with a certificate. This option is used to ensure the integrity of the setup pack.
    18. Validate. The setup program is automatically created.
    19. A screen is displayed, allowing you to check the setup or to open the generation directory.
Installing an application
In the last setup creation window, click "Test". If you closed this window, run the "Install.exe" program located in the setup program directory. The application setup starts.
  • We will go through the different steps of the "WD Full Application" setup program.
    1. On Windows Vista (or later), a window requests the authorization to run the program. Validate this window.
    2. Choose the language of the setup program and click "OK".
      Setup languages
    3. The setup wizard starts. Two setup modes are available:
      • Quick setup: The setup is performed with the parameters specified by the application provider.
      • Custom setup: The wizard asks the user to define the parameters of the application setup.
    4. Choose "Custom setup". The wizard asks for the application setup directory.
      Setup wizard
    5. Keep the default directory and go to the next step.
    6. Finish the application setup wizard.
    7. The application setup starts. Validate the different setup steps.
The different types of deployment
We have performed a simple application deployment. In the setup creation wizard, WINDEV also proposes setups with automatic update.

Overview

Several setup modes are available for a WINDEV application:
  • Stand-alone setup:
    This type of setup is used to create a unique setup program. This setup program will be run by the end users from their computers.
    To update the application, you will have to re-create a setup for the application. Then, the end user will have to install this new program.
    This is the type of setup that we have just created.
  • Setup with automatic update:
    This type of setup is used to automatically detect the updates when starting the application. If an update is available, users can update immediately.
    This type of setup is available via the network or the Web. You also have the ability to perform a multi-site setup.
We are now going to present the operating mode of a setup with update.

Setup with network update

The setup program is created via a specific wizard (on the "Project" pane, in the "Generation" group, click "Setup procedure").
The setup program obtained at the end of the wizard includes two setups:
  • the setup of the reference application. The reference application must be installed on the network (in a shared directory or on a server for example), accessible to all the end users of the application.
  • the application setup itself. This setup is included in the reference application. It can be accessed once the reference application is installed.
The diagram below presents the setup mode of an application that uses a local HFSQL Classic database, with a network update.
Setup with network update
The version of the reference application is automatically checked each time the end user starts the application. If this version was modified (if the reference version was updated for example), an update is automatically proposed for the final application.

Setup with Internet update

The same principle is used by the setup with Internet update.
The setup program is created via a specific wizard (on the "Project" pane, in the "Generation" group, click "Setup procedure").
The setup program obtained at the end of the wizard includes:
  • the setup of the reference application and the Web page used to download the client setup. These elements must be installed on an HTTP server.
  • the application setup itself. This setup is included in the reference application. It can be accessed once the reference application is installed, via the Web page for download.
The diagram below presents the setup mode of an application that uses an HFSQL Client/Server database, with an internet update.
Setup with Internet update
Remark: This type of setup can also be performed via PCSCloud (if you have an account).

Multisite setup

The multi-site setup combines:
  • a reference network setup deployed on a local network.
  • an HTTP setup used to update the reference setup on the local network.
Previous LessonTable of contentsNext Lesson
Minimum version required
  • Version 26
Comments
Click [Add] to post a comment