How to create an installation for a Visual C# application

For many years Visual Installer have had built-in functionality to create an installation for a Visual Basic 6.0 and Visual Basic .NET application, and in the latest version of Visual Installer we have added the same functionality for Visual C#. You can now create an installation for a Visual C# application in an easy way.

Besides collecting necessary files and setting correct destination folders for your project, you can also specify minimum system requirements (for example minimum .NET version) for the installation package. If the necessary .NET versions are not installed, the installer can inform and handle the download directly from the installation wizard.

Read more
Here is some more information about the new function:
> Visual Installer 2020: Visual C# is now supported

And here is a step-by-step tip that show how to use the function:
> Tip: How to create an installation for a Visual C# application

How to delay deletion of a file until reboot

Sometimes a file need to be deleted during an installation, but it can not be done because of the file is active and locked by the system. To handle this we have added a new script command to Visual Installer with the name RDELETE that can be used to mark a file for deletion and let the system delete the file when the computer restarts.

When you use this command, no attempt will be made to delete the file during the installation. Instead Visual Installer will inform the system that the file need to be deleted during the next system reboot.

The command syntax is the following:

RDELETE filepath

Example:

RDELETE %DESTDIR\CleanUp\CleanUp.exe

This command is useful when a file need to be deleted, but there is no hurry to delete the file. You can then call this command and let the system delete it later.

See also
> 4 delete commands available in the script language – when to use which
> Visual Installer’s Scripting Language

Visual Installer 2020 has now been released

We have now released a new version of our setup tool SamLogic Visual Installer. The name of the new version is SamLogic Visual Installer 2020 and the version number is 11.8. Some new features in the new version are:

• Supports the latest version of Windows 10.
• Supports Microsoft .NET Framework 4.7.2 and 4.8.
• Supports AutoCAD 2019 and 2020.
• Supports Visual Basic 2019.
• Supports now also Visual C#.
• You can now comment files in the file list.
• The Registration dialog box now supports region/state and ZIP/postal code.
• Updated Run program after installation function.
• You can now specify your own picture to the uninstallation program/dialog box.

A detailed list of new features in Visual Installer 2020 is available on this web page.

Visual Installer now supports EV code signing

Nowadays it is very important to code sign installation packages. This increases the security and gives less warning messages in Windows and in web browsers.

Since many years back our setup tool Visual Installer has supported standard digital certificates, but in the last update of Visual Installer we have also added support for EV digital certificates. EV digital certificates increases the security even more and the risk for warning messages in Windows and in web browsers (for example in Chrome, Edge and Internet Explorer) is reduced to almost zero. EV digital certificates are more trusted by Windows and web browsers than standard digital certificates.

Updated ‘Setup Options’ dialog box in Visual Installer
The Code Signing tab in the Setup Options dialog box in Visual Installer has been updated to also support EV code signing. An EV digital certificate is always distributed on a USB token and we have added a new option to the Code Signing tab that handles digital certificates on USB tokens. The name of the new option is My digital certificate is located on a USB token and if you select this option, Visual Installer will get the digital certificate from the USB token when a setup package is created.

You can see the new My digital certificate is located on a USB token option in the dialog box picture below:

Visual Installer - Setup Options

Alla binary files that are distributed are EV code signed
As an addition to the above, all SamLogic’s binary files that are distributed to end-users has been code signed with an EV digital certificate. This reduced the risk that Windows reacts (gives a warning message) after a setup package has been unpacked and all files extracted.

See also
> Article: Extended Validation (EV) Code Signing in Windows 8 / Windows 10
> Blog: The file information window now displays info about digital certificates

Visual Installer: The XRUN command now also supports OS and bitness

The XRUN script command in Visual Installer has been updated and extended to handle two more parameters: %OS and %Bitness. These two parameters are optional and allows you to specify in which Windows version and with which Windows bitness (32 bit/64 bit) the program file that XRUN starts can be run in. Below are some more information about the two parameters:

%OS
The %OS parameter is an optional parameter that specifies in which operating system (Windows version) the program can be run in. You can specify if the program can be run in Windows 7, Windows 8, Windows 10, or in any Windows. If you omit this parameter the program will be run in any Windows version.

%Bitness
The %Bitness parameter is an optional parameter that specifies which bitness (32 bit or 64 bit) the operating system (Windows version) must have to let the program start. The program will only be run if the Windows bitness match the bitness that you specify via this parameter. If you omit this parameter the program will be run in a Windows of any bitness (both 32 bit and 64 bit Windows).

Syntax
The definition of XRUN, with all of its parameters, is now:

XRUN %Filename, %Flag, %Param, %OS, %Bitness

The Filename parameter specifies the filename of the executable file. The Flag parameter informs Visual Installer how to start the program. The Param parameters specifies command line parameters to the executable file (if used). And the OS and Bitness parameters are described above

Examples of usage
The example below starts MyWin7App.exe if the operating system is Windows 7. If the operating system is anything else, for example Windows 10, the program is never run.

XRUN  %DESTDIR\MyWin7App.exe, 1, “”, 7

The example below starts MyWin7App.exe if the operating system is a 64 bit Windows 7. If the operating system or bitness is anything else the program is never run.

XRUN  %DESTDIR\MyWin7App.exe, 1, “”, 7, 64

More information about the XRUN command and the %OS and %Bitness parameters is available in Visual Installer´s User Guide.

See also
> Visual Installer’s Scripting Language

The ‘User Options’ setup dialog now also supports radio buttons

The User Options setup dialog box in Visual Installer has been updated to also support radio buttons. So you can now choose if you want to use check boxes or radio buttons in the installation dialog box. When you use radio buttons, only one option at a time can be selected. The options are mutually exclusive.

Below is a basic example of how the updated User Options dialog box may look like when using radio buttons:

The 'User Options' setup dialog box

As before, you can set the text for the dialog box title, the information area and the options freely. Switching between check boxes and radio buttons is done via a new setting in the editor:

The 'Settings' dialog box

More information about the ‘User Options’ setup dialog
In this blog post from 2016 you can read more about the User Options setup dialog. There is also a long tip available in this tip page.

You can now change font for Visual Installer’s and CD-Menu Creator’s editor

Using one and the same font in a software with all versions of Windows, graphic cards, displays and DPI settings, and expecting the result always to be perfect, is nearly an impossible mission. And then you must also take into account that people also prefer different fonts.

To handle this situation in the best way in our software we have updated Visual Installer and CD-Menu Creator to allow you to choose your own font for the editor. We have included some fonts that you can choose among, and we will increase the list with fonts with time.

Too large font size?
The new font handling in Visual Installer and CD-Menu Creator will also solve the problem with “too large font size” that sometimes happens when a system font with a requested size is not available in the system and the substitute font (chosen by Windows) is somewhat larger and the text will therefore not fit in the space that is reserved for the text. This is a rare condition, but will happen in special circumstances *.

In Visual Installer 2018 and CD-Menu Creator 2018 this problem does not exists anymore because both editors will automatically search for a font that has the same size as the font that has a problem. So the editors will automatically switch font if this problem occur. But you can, of course, choose another font manually if you prefer to do this.

How to change font for the editor manually
In Visual Installer 2018 you can change font by choosing the Editor options menu item in the Special menu. In CD-Menu Creator 2018 you can change font by choosing the Options menu item in the File menu. In both cases there will be a new Font tab available in the dialog box that is shown. Via this new tab you can change the font for the editor.

*) This problem may occur if the connected display is over a certain resolution when Windows is first installed in the computer. Windows will then set the DPI to 120 instead of the usual 96, and the “MS Sans Serif” font that Visual Installer’s and CD-Menu Creator’s editor uses as default may be affected by this. The font may not be available in smaller sizes. If this problem happens, it does not help that you afterwards change the DPI from 120 to 96. The font size is still not available. More information about this problem is available in this blog post on Microsoft’s blog.

Visual Installer 2018 has now been released

We have now released a new version of our setup tool SamLogic Visual Installer. The name of the new version is SamLogic Visual Installer 2018 and the version number is 11.5. Some new features in the new version are:

• Supports the latest version of Windows 10.
• Supports Microsoft .NET Framework 4.7 and 4.7.1.
• Supports AutoCAD 2018.
• A new function makes it easier to add all files in a folder to Visual Installer’s file list.
• The ‘User Options’ setup dialog box has been updated to also support radio buttons.
• The code signing function now supports USB tokens and EV digital certificates.
• All redistributable binary files are now code signed with an EV digital certificate.
• New script commands has been added to the script language.
• The XRUN script command has been updated to handle more options.
• You can now change the font for Visual Installer’s editor.

A detailed list of new features in Visual Installer 2018 is available on this web page.

Using the ‘Add tree’ function in Visual Installer

If you already have created a folder structure on your hard drive, with the files that you want to install, and want to create a similar folder structure on the destination drive, there is a very useful function in Visual Installer that you can use. The name of the function is Add tree and you can access it via the List menu in Visual Installer, by choosing the List – Add – Add tree menu item (see the picture below):

The 'Add tree' menu option

After you have chosen this menu item, the following dialog box is shown:

The 'Select folder' dialog box (1)

Via this dialog box you can browse to the folder, with sub folders and files, that you want to add to Visual Installer’s file list. For example like:

The 'Select folder' dialog box (2)

You can see the current folder path to the right of the Folder field name in the dialog box.

After you have selected your folder, you can click on the OK button to continue. The following dialog box will now be shown:

Collect files from folders and sub folders

In the option frame (above the three buttons) you can choose how the folder structure will be built in Visual Installer’s file list. You can choose between replacing the root level of the folder tree with the %DESTDIR variable, or add the folder tree to the %DESTDIR variable.

When you have decided how you want to build the folder tree, you can press the Add files button. Now Visual Installer’s file list will be filled with the files and folders. And you can see how many files that were collected in the No. files field name in the dialog box:

Ready!

To return to the file list, just press Close in the dialog box.

The collected files

How to obtain only folders of a folder tree
Instead of collecting the files in a folder tree you can also extract only the folders (directories) of the tree and skip all files. In this blog post we explain how to do this.

How to add a folder tree to Visual Installer’s file list

With the Add tree function in Visual Installer you can add a folder structure including files to Visual Installer’s file list in an easy way. It is also possible to add a folder structure without files to Visual Installer’s file list with the same Add tree function. We will show below how to do this.

1. Open the List menu and choose the Add – Add tree menu item.

The 'Add tree' menu option

2. Select a folder in the Select folder dialog box and click OK.

The 'Select folder' dialog box

3. Click on the More options button in the Collect files from folders and sub folders dialog box that now appears.

Collect files from folders and sub folders

4. Select the Only add folders option in the More options dialog box that now is shown.

The 'More options' dialog box

5. Click OK to close the dialog box. The text in the previous opened dialog box will be updated to:

Collect folders from folders and sub folders

6. Now click on the Add folders button to start collecting folder. All folders and sub folders in the selected folder (in step 2) will be added to Visual Installer’s file list. The number of collected folders will be displayed after the No. files field name in the dialog box.

Ready!

7. Click the Close button in the dialog box to return to the file list.

The collected folders