PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Overview
  • Creating a shortcut
  • Creating a shortcut
  • Managing the collisions
  • Managing the collisions
  • Saving the replaced files
  • Proposing the backup of replaced files
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
WDINST: configuring the characteristics of file setup
Overview
The setup editor WDINST is used to configure the characteristics of file setup:
  • Create a shortcut for each file installed (with a command line if necessary).
  • Manage the collisions when updating the application (replace or not the existing files).
  • Save the replaced files when the application is updated (automatic backup of existing files).
The characteristics of file setup are configured in the setup editor WDINST. To start WDInst, select "Tools .. WDINST - Setup editor". To start WDInst, on the "Tools" pane, in the "Utilities" group, click "WDInst".
The setup editor WDINST proposes an advanced management of the characteristics for file setup, and we advise you to use it rather than the wizard for creating the setup program.
Creating a shortcut
For each file to install, the setup editor WDINST allows you to create:
  • A shortcut on the desktop of the setup computer.
  • A shortcut in a group of programs.
  • A shortcut in the launch bar.
By default, for each executable installed, a shortcut will be created:
  • on the desktop of the setup computer.
  • in a group of programs.
  • in the launch bar.
Note: The caption of the shortcuts will be created in the runtime language of the setup program.

Creating a shortcut

To create a shortcut:
  1. Select the requested file in the "List of setup files" window.
  2. Display the "Shortcut" tab of the "File description" window.
  3. Check the requested option:
    • "Create a shortcut on the desktop" to create the application shortcut on the desktop of the user computer.
    • "Create a shortcut in a program group" to create the shortcut in the specified group.
    • "Create a shortcut in the taskbar" to create the shortcut in the Windows launch bar.
      All these options can be cumulated.
  4. Enter the caption of the shortcut in each language supported by the setup program.
  5. Enter (if necessary) the group of programs where the shortcut must be created.
    Note: This group of programs will be created if it does not exist on the user computer.
  6. Specify (if necessary) the parameters of the shortcut. The execution of this shortcut will start a command line.
    For example, the command line: "C:\MyDirectory\MyApplication.EXE /Login = Bill" contains:
    • The full path of the file associated with the shortcut.
      In our example: "C:\MyDirectory\MyApplication.EXE".
    • The parameters of the shortcut.
      In our example: "/Login = Bill".
Managing the collisions
By default, when updating an application, if files with the same already exist in the setup directory, these files are replaced (except if the files already found on the computer are more recent than the ones found in the setup). No warning window is displayed to confirm these replacements.
The setup editor WDINST is used to configure the setup program in order to:
  • Install the files even if files with the same name and more recent are found in the setup directory.
  • Avoid installing the files if files with the same name are found in the setup directory.
  • Ask the user to confirm whether the files must be replaced or not.
  • Rename the existing files.

Managing the collisions

To manage the collisions:
  1. Select the requested files in the "List of setup files" window.
    To select several files simultaneously, keep the [Ctrl] or [Shift] key down when selecting the files.
  2. Display the "Version" tab of the "File description" window:
    • To avoid installing the selected files if files with the same name are found in the setup directory, check "Don't install if the file already exists (no other checks will be performed)".
    • To replace the existing files (even if these files are more recent), check "Replace the file even if it is more recent".
    • To ask the user to confirm whether the selected files must be replaced or not, check "Ask for confirmation before replacing the file".
    • To rename the existing files in the setup directory before installing new files, check "Rename the replaced file to the name specified below". Enter the name and extension of the replaced file.
      For example: MyImage_Bak.GIF".
      Note: This operation must be performed for each replaced file that must be renamed.
Saving 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 the application.
The backup of replaced files is proposed by default to the users.

Proposing the backup of replaced files

To propose the backup of replaced files:
  1. In the setup editor WDINST: select "Parameters of setup .. Wizard".
  2. Check "Propose to save the elements replaced by the setup program".
    When installing the application, the user will be able to:
    • Choose to save the replaced files.
    • Modify the backup directory proposed by default.
Minimum required version
  • Version 9
Comments
Click [Add] to post a comment