ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / Installing applications and websites / WINDEV application / Setup editor
  • Overview
  • Proposing to run a program
  • Specifying the executable to run and associating parameters with this executable
  • Not proposing to run the application executable at the end of the setup
  • Uninstalling application
  • Modifying the application identifier
  • Modifying the application identifier in the registry
  • Modifying or creating the "AutoExec.BAT" file
  • Modifying or creating the "AutoExec.BAT" file
  • Modifying or creating the ".INI" files
  • Modifying or creating ".INI" files during the setup
  • Modifying or creating entries in the registry
  • Overview
  • Modifying or creating entries in the registry during the setup
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
Overview
When creating the setup program, WDInst allows you to configure the computer where the program will be installed. You can:
  • Propose to run a program at the end of the setup (with or without command line).
  • Modify the registry:
    • modify the application identifier,
    • modify or create entries.
  • Modify or create the "AutoExec.BAT" file.
  • Modify or create the ".INI" files.
By default, the setup program proposes to start the program at the end of the setup and no modification will be performed on the user computers.
The setup computer is configured in the setup editor WDInst. To start WDInst, go to the "Tools" tab, "Utilities" group and click "WDInst".
The wizard for creating the setup program can also be used to configure the setup computer.
Remark: To ask the user to confirm the modifications performed on the system when installing the application:
  1. Start WDInst: on the "Tools" tab, in the "Utilities" group, click "WDInst".
  2. Select "Setup parameters.. System configuration".
  3. Check "Ask for confirmation before modifying".
Proposing to run a program
By default, the setup program proposes to run the executable of the application at the end of the setup. The option "Start the program" is checked. The executable is automatically run when clicking the "Done" button.
The setup editor WDInst is used to:
  • Specify the executable to run and associate parameters with this executable. A single executable (".EXE" file) found in the list of files to install can be run.
  • Not propose to run the executable of the application at the end of the setup.
Remark: If modifications are performed in the "AutoExec.Bat" file, no program should be run at the end of the setup. Indeed, the modifications performed in this file will be taken into account when the computer is restarted.

Specifying the executable to run and associating parameters with this executable

To specify the executable to run and to associate parameters with this executable:
  1. Select "Setup settings .. End of setup".
  2. Enter the executable that must be run at the end of the application setup ("Command line" option).
    The executable to run corresponds to:
    • The name and full path of the executable file. The following keywords can be used:
      • - <SetupDir>: installation directory chosen by the user.
      • - <SetupDrive>: drive of the installation directory chosen by the user.
      • - <SetupFile>: data file installation directory. WDInst is used to configure this directory.
        For more details, see Configuring the data file directory.
      • - <WinDir>: Windows directory on user computers.
    • The runtime parameters of the program installed (if necessary).
      For example: "<SetupDir>\MyApp.EXE /Param".

Not proposing to run the application executable at the end of the setup

To avoid proposing to run the application executable at the end of the setup:
  1. Select "Setup settings .. End of setup".
  2. Erase the content of the "Command line" option.
Uninstalling application
The uninstaller can be included with the application setup. This makes it possible to uninstall the application via the Windows options.
Modifying the application identifier
When installing the application, a specific identifier is automatically created in the registry. This identifier can be modified with WDInst.
By default, this identifier is "<ApplicationName>". For example, "WD Customer" for the "WD Customer" application. This identifier may contain spaces.

Modifying the application identifier in the registry

To modify the identifier used to uninstall the application:
  1. Select "Setup settings .. End of setup".
  2. Select the new identifier of the application.
Remark: This identifier may contain spaces.
Modifying or creating the "AutoExec.BAT" file
You can modify or create the "AutoExec.BAT" file on user computers. This file will be modified or created (if necessary) when the computer is restarted. In this case, a reboot is automatically proposed at the end of the application setup.
The "AutoExec.BAT" file is used to:
  • add the application executable directory to PATH,
  • start the application when the setup computer is started,
  • etc.
Reminders:
  • The "AutoExec.BAT" file is automatically run when the computer is started.
  • PATH lists the directories in which executables (".EXE" files) and libraries (".DLL" files) are searched for first.

Modifying or creating the "AutoExec.BAT" file

To modify or create the "AutoExec.BAT" file:
  1. Select "Setup parameters.. System configuration".
  2. Enter the command line to add to or to modify in the "AutoExec.BAT" file.
  3. Specify the location of the corresponding "command line" in the "AutoExec.BAT" file ("Location" combo box):
    • At the beginning. Corresponds to the first "command line" of the "AutoExec.BAT" file.
    • At the end. Corresponds to the last "command line" of the "AutoExec.BAT" file.
    • After PATH. By positioning a "command line" after PATH, the executable and/or libraries used in this command line will be searched for in the directories of PATH.
  4. If the same command line already exists in the "AutoExec.BAT" file, you can:
    • Replace the existing command line. Select the "Replace" parameter ("Type" combo box).
    • Add the command line. Select the "Add" parameter ("Type" combo box).
Remark: To directly add the installation directory of the application to PATH, use the buttons:
  • "At the beginning". The installation directory will be the first directory in PATH.
  • "At the end". The installation directory will be the last directory in PATH.
Modifying or creating the ".INI" files
When installing a WINDEV application, you have the ability to modify or create the ".INI" files on the setup computers. These files will be associated with the application installed.
The ".INI" files are used to:
  • Customize the application according to the connected user
  • Define the default parameters of the application
Then, the ".INI" files can be read and modify from the application directly (INIRead and INIWrite).
For example, to save the setup program runtime language to the "MyAppli.INI" file (in the application installation directory):
  • ".INI" file: <SetupDir>\MyApp.INI
  • Section: LANGUAGE
  • Parameter: LANGUAGE_INSTALL
  • Value: <Language>
The <Language> keyword will be automatically replaced during the setup by the number of the runtime language of the setup program (this number can be used by Nation).
In this example, if the number of the runtime language is 3, the following parameter will be added into the "MyApp.INI" file:
[LANGUAGE]
LANGUAGE_INSTALL=3

Modifying or creating ".INI" files during the setup

To modify or create ".INI" files during the setup:
  1. Select "Setup parameters.. System configuration".
  2. Specify the relevant ".INI" file. This file will be created if necessary. You can specify:
    • The name and full path of the file.
      The following keywords can be used:
      • <SetupDir>: installation directory chosen by the user.
      • <SetupDrive>: drive of the installation directory chosen by the user.
      • <SetupFile>: data file installation directory. WDInst is used to configure this directory. For more details, see Configuring the data file directory.
      • <WinDir>: Windows directory on user computers.
        For example: "<SetupDir>\MyDirectory\MyFile.INI".
    • The name of the file. The file will be searched for or created in the Windows directory. For example: "MyFile.INI".
    • No file. The "WIN.INI" file will be modified.
  3. Specify the section to modify or to create.
  4. Specify the parameter to modify or to create.
  5. Specify the value of the parameter.
    To retrieve the number of the runtime language for the setup program, use the <Language> keyword.
Modifying or creating entries in the registry

Overview

When installing a WINDEV application, you have the ability to modify or create entries in the registry.
The registry allows you to:
  • Customize the application according to the connected user
  • Define the default parameters of the application
Then the registry can be read and modified from the application directly (RegistrySetValue, RegistryQueryValue , ...).
For example, to save the runtime language of the setup program in the registry, type:
  • Key: HKEY_LOCAL_MACHINE\Software\MyCompany\MyApp\1.0\
  • Name: Language
  • Value: <Language>
The <Language> keyword will be automatically replaced during the setup by the number of the runtime language of the setup program (this number can be used by Nation).

Modifying or creating entries in the registry during the setup

To modify or create entries in the registry during the setup:
  1. Select "Setup parameters.. System configuration".
  2. Specify the relevant key (full path). This key will be created if necessary.
  3. Specify the name of the value to modify. This value will be created if necessary.
  4. Specify the new value.
    To retrieve the number of the runtime language for the setup program, use the <Language> keyword.
Minimum version required
  • Version 9
Comments
Click [Add] to post a comment

Last update: 06/07/2023

Send a report | Local help