ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

This content has been translated automatically.  Click here  to view the French version.
Help / Installing applications and websites / WINDEV application / Creating the setup program (wizard)
  • Overview
  • Basic setting
  • Default path of setup on the end-user computer
  • Default path of reference setup (network setup only)
  • Advanced setting of installation directory
  • Allow the user to save the replaced files
  • Run a program at the end of setup
  • Configure a silent setup
  • Modify the identifier used to uninstall the application
  • Modify or create the "AutoExec.BAT" file
  • Modify or create the ".INI" files
  • Modify or create values in the registry
  • Implementing the UAC for the installer
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
Stored procedures
Overview
The setup creation wizard allows you to specify the installation directory.
In the "Installation directory" step of wizard, you have the ability to specify:
Basic setting

Default path of setup on the end-user computer

The setup configuration is used to select the installation directory proposed by default. The user will be able to modify this directory when installing the application.
This directory is "C:\Program Files\<ApplicationName>" by default.

Default path of reference setup (network setup only)

The setup configuration is used to select the installation directory of reference setup proposed by default. The user will be able to modify this directory when installing the application.
This path is optional.
Advanced setting of installation directory

Allow the user to save the replaced files

When updating an application, an additional plane can be included in the setup program. This additional plane allows the user to save the replaced files in a backup directory. This backup directory will be named "Backup_<BackupDate>_<BackupTime>" by default.
Backup of replaced files
This backup can be used if the setup fails for example. To use this backup, the user will have to copy the files found in the backup directory into the installation directory of application.
The backup of replaced files is proposed by default to the users.

Run a program at the end of setup

By default, the setup program proposes to the user to run the application executable at the end of setup. The option "Start the program" is checked. The executable is automatically run when clicking the "Done" button.
The setup program creation wizard allows you to specify the executable that must be run and to associate parameters with this executable. Only an executable (".EXE" file) can be run.
The executable to run corresponds to:
  • the name and full path of the executable file. The following keywords can be used:
    • <RepInst>: installation directory chosen by the user during installation.
    • <LectInst>: reader of the installation directory chosen by the user during installation.
    • <FicInst>: installation directory for data files. The setup program creation wizard allows you to configure this directory. For more details, see Configuring the data file directory.
    • <WinDir>: Windows directory on the user computers.
    • <RepSys>: system directory.
    • <RepRef>: Reference directory for installations with automatic updates only.
  • the runtime parameters of the program installed (if necessary).
For example: "<RepInst>\MyAppli.EXE /Param".
Note: If any changes are made to the "AutoExec.BAT" file, it is advisable not to run any program at the end of the installation.. Indeed, the modifications performed in this file will be taken into account when the computer is restarted.

Configure a silent setup

The setups of reference version and client version can be performed in silent mode. In this case, the setup will be done without any user intervention. The options defined by default will be automatically used.
The available options are as follows:
  • Silent client installation: end-user application installation requires no action on the part of the user.
  • Silent reference version deployment (only available for installations with automatic updates): installation of the network installation's reference version will be carried out without user intervention..

Modify the identifier used to uninstall the application

If you have chosen to allow your application to be uninstalled, a specific identifier is automatically created in the registry. This identifier can be modified via the setup program creation wizard.
By default, this identifier is "<ApplicationNameWithoutSpace>". For example, "WDCustomer" for the "WD Customer" application. This identifier may contain spaces.
This identifier will be created in the key:
  • "HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Uninstall" in Windows 2000 and NT.
  • "HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Uninstall" in Windows 98 and Me.

Modify or create 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 directory of the application executable into the PATH.
  • start the application when starting the setup computer.
  • ...
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.

Modify or create 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).
Example of modification
For example, to save the setup program runtime language to the "MyAppli.INI" file (in the application installation directory):
  • .INI" file: <RepInst>\MyAppli.INI
  • Section: LANGUAGE
  • Parameter: LANGUE_INSTALL
  • Value: <Langue>
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

Modify or create values in the registry

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, ...).
Example of modification
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: <Langue>
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).
Implementing the UAC for the installer
By default, installing a WINDEV application triggers the UAC.
To access the setting regarding the implementation of UAC, click the "Implementing the UAC" button.
The window that is displayed allows you to modify this operating mode via "The installer DOES NOT require the administrator rights":
  • for individual installations: UAC is disabled for installation on the end-user workstation.
  • for the network setups with automatic update. In this case, the UAC can be disabled:
    • for the installer of the end user,
    • for the installer of the reference version,
    • for both.
Please note: The "Do not require administrator rights" option has certain restrictions: no installation of files in system directories (Program Files, Windows...), no modification of system files and parameters (win.ini, path, ...)..
The setup will fail if the rights are not sufficient. Whenever possible, the setup wizard will guide the user in his choices so that he can install the application.
Note: UAC support for the installer can also be configured in advanced options of the installer.. These options are accessible in the "Medium" step of the setup creation wizard.
Minimum version required
  • Version 11
Comments
Click [Add] to post a comment

Last update: 10/04/2024

Send a report | Local help