Advanced setting of setup directory
To access the advanced setting regarding the setup of your application, click the "Advanced" button.
These advanced parameters are used to:
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.
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 setup 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:
- <SetupDir>: setup directory chosen by the user during the setup.
- <SetupDrive>: drive of the setup directory chosen by the user during the setup.
- <SetupFile>: setup directory of data files. The setup program creation wizard allows you to configure this directory. For more details, see Configuring the directory of data files.
- <WinDir>: Windows directory of user computers
- <SysDir>: system directory.
- <RefDir>: reference directory for the setups with automatic update only.
- the runtime parameters of the program installed (if necessary).
For example: "<SetupDir>\MyApp.EXE /Param".
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.
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:
- Silent client setup: the application setup for the end user does not require any user action.
- Silent deployment of reference version (available during a setup with automatic update): the reference version of network setup will be installed without any 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 (or may not) contain space characters.
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 have the ability to modify or create the "AutoExec.BAT" file on the setup 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.
- The PATH lists the directories in which the executables (".EXE" files) and the libraries ("DLL" files) are sought in priority.
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 setup 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
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 alloows you to:
- customize the application according to the connected user.
- define the default parameters of the application.
- ...
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: <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).