Preferences

EclipseNSIS

These preferences are used to set global settings for NSIS scripts, including command line options for the MakeNSIS compiler. These options are applied during script compilation, unless overridden on the script level (see the Properties section).
The EclipseNSIS Preferences page has two tabs:

General
Defined Symbols

General

EclipseNSIS Preferences General Tab

NSIS Home: Location of NSIS software installation. This is the folder where MakeNSIS.exe can be found. In case there are multiple NSIS installations, e.g. in a development environment, the drop-down combo remembers the locations you specified, so that they are available for quick NSIS home selection. ← Back

Automatically open NSIS console

Automatically open the EclipseNSIS console when compiling a script. If the console is already open, it is brought to the front. There are four settings available:

Always - the console is automatically opened and brought to the front whenever a script is compiled. This means that even if the console view tab is moved to the back in the view site, it will be brought to the front whenever any compilation output is generated.
Errors and warnings - the console is automatically opened and brought to the front if any errors or warnings are encountered while compiling a script.
Errors only - the console is automatically opened and brought to the front only if any errors are encountered while compiling a script.
Never - the console is never automatically opened and/or brought to the front. It will have to be manually opened if compilation output is to be viewed.

← Back

Use Eclipse Platform help browser: Use the Eclipse Platform help browser to display NSIS help. If this option is unchecked, then the EclipseNSIS integrated help browser is used. ← Back

Notify when MakeNSIS.exe has been modified or deleted: EclipseNSIS monitors the status of the MakeNSIS.exe executable in the chosen NSIS home. If this executable is modified, EclipseNSIS needs to reconfigure itself. If EclipseNSIS cannot find a valid MakeNSIS.exe in the current configured NSIS home, it attempts to find an alternate NSIS home by iterating through all previously used NSIS homes in order of last use until it finds a valid NSIS home.
If this option is checked, EclipseNSIS issues visual notifications in the form of a message box alert and a progress dialog, otherwise it is done silently, and a notification is only issued if an alternate NSIS home cannot be found. ←Back

Before compiling save options

This option specifies the action that EclipseNSIS takes when a compile request is made with modified files open in editors. The options available are:

Confirm before saving current/selected NSIS file
Confirm before saving associated NSIS files
Confirm before saving all open NSIS files
Automatically save current/selected NSIS file
Automatically save associated NSIS files
Automatically save all open NSIS files

←Back

Print NSIS header info: Prints out information on what options were used to compile MakeNSIS was compiled with. Equivalent to the /HDRINFO compiler option. ← Back

Print NSIS license: Displays a keen license page. Equivalent to the /LICENSE compiler option. ← Back

Do not include default NSIS config: Disables inclusion of ${NSISDIR}\nsisconf.nsh. Without this parameter, installer defaults are set from nsisconf.nsh.. Equivalent to the /NOCONFIG compiler option. ← Back

Don't change directory: Disables the current directory change to that of the .nsi file. Equivalent to the /NOCD compiler option. ← Back

Verbosity: Sets the verbosity of the compiler output. Equivalent to the /V compiler option. ← Back

Compressor: Sets the default compressor for NSIS scripts. This overrides any compressor settings in the script. When the Best compressor option is selected, all compressors are tried, and the one with the best compression is used for creating the installer. The "Solid" checkbox appears if the specified version of MakeNSIS.exe supports the SetCompressor /SOLID option. The Solid checkbox is enabled only if a compressor is selected explicitly. ← Back

Process Priority: Sets the compiler process priority. Equivalent to the /P compiler option.This setting is only available if the specified version of MakeNSIS.exe supports this option (MakeNSIS 2.24 or better). ← Back

Show warning when High or Realtime process priority is selected: If the compiler process priority is set to High or Realtime, severe performance degradation may occur. If this setting is selected, then EclipseNSIS will display a warning and confirmation if the process priority is set to High or Realtime, whether it is in the EclipseNSIS preferences, the script properties for a resource or even in the launch or project builder configuration settings..This setting is only available if the specified version of MakeNSIS.exe supports setting the compiler process priority (MakeNSIS 2.24 or better). ← Back

Instructions: Instructions for the MakeNSIS compiler to execute prior to compiling the script. Equivalent to the /X compiler option. The following buttons allow the manipulation and configuration of instructions. ← Back

Add: Add a new instruction. ← Back

Edit: Edit the selected instruction. ← Back

Delete: Delete the selected instruction(s). ← Back

Up: Move the selected instruction(s) up in the execution sequence. ← Back

Down: Move the selected instruction(s) down in the execution sequence. ← Back

Back to Preferences

Defined Symbols

EclipseNSIS Preferences Symbols Tab

Defined Symbols: Symbols to be defined by the MakeNSIS compiler prior to compiling the script. Equivalent to the /D compiler option. The following buttons allow the manipulation and configuration of symbol definitions. ← Back

Add: Add a new symbol. ← Back

Edit: Edit the selected symbol. ← Back

Delete: Delete the selected symbol(s). ← Back

Up: Move the selected symbol(s) up in the define sequence. ← Back

Down: Move the selected symbol(s) down in the define sequence. ← Back

Back to Preferences

Previous | Contents | Next