Struct tauri_utils::config::NsisConfig

pub struct NsisConfig {
    pub template: Option<PathBuf>,
    pub header_image: Option<PathBuf>,
    pub sidebar_image: Option<PathBuf>,
    pub installer_icon: Option<PathBuf>,
    pub install_mode: NSISInstallerMode,
    pub languages: Option<Vec<String>>,
    pub custom_language_files: Option<HashMap<String, PathBuf>>,
    pub display_language_selector: bool,
    pub compression: Option<NsisCompression>,
    pub installer_hooks: Option<PathBuf>,
}

Configuration for the Installer bundle using NSIS.

Fields

template: Option<PathBuf>

A custom .nsi template to use.

header_image: Option<PathBuf>

The path to a bitmap file to display on the header of installers pages.

The recommended dimensions are 150px x 57px.

sidebar_image: Option<PathBuf>

The path to a bitmap file for the Welcome page and the Finish page.

The recommended dimensions are 164px x 314px.

installer_icon: Option<PathBuf>

The path to an icon file used as the installer icon.

install_mode: NSISInstallerMode

Whether the installation will be for all users or just the current user.

languages: Option<Vec<String>>

A list of installer languages. By default the OS language is used. If the OS language is not in the list of languages, the first language will be used. To allow the user to select the language, set display_language_selector to true.

See https://github.com/kichik/nsis/tree/9465c08046f00ccb6eda985abbdbf52c275c6c4d/Contrib/Language%20files for the complete list of languages.

custom_language_files: Option<HashMap<String, PathBuf>>

A key-value pair where the key is the language and the value is the path to a custom .nsh file that holds the translated text for tauri’s custom messages.

See https://github.com/tauri-apps/tauri/blob/dev/tooling/bundler/src/bundle/windows/templates/nsis-languages/English.nsh for an example .nsh file.

Note: the key must be a valid NSIS language and it must be added to NsisConfig languages array,

display_language_selector: bool

Whether to display a language selector dialog before the installer and uninstaller windows are rendered or not. By default the OS language is selected, with a fallback to the first language in the languages array.

compression: Option<NsisCompression>

Set the compression algorithm used to compress files in the installer.

See https://nsis.sourceforge.io/Reference/SetCompressor

installer_hooks: Option<PathBuf>

A path to a .nsh file that contains special NSIS macros to be hooked into the main installer.nsi script.

Supported hooks are:

• NSIS_HOOK_PREINSTALL: This hook runs before copying files, setting registry key values and creating shortcuts.
• NSIS_HOOK_POSTINSTALL: This hook runs after the installer has finished copying all files, setting the registry keys and created shortcuts.
• NSIS_HOOK_PREUNINSTALL: This hook runs before removing any files, registry keys and shortcuts.
• NSIS_HOOK_POSTUNINSTALL: This hook runs after files, registry keys and shortcuts have been removed.

Example

!define NSIS_HOOK_PREINSTALL "NSIS_HOOK_PREINSTALL_"
!macro NSIS_HOOK_PREINSTALL_
  MessageBox MB_OK "PreInstall"
!macroend

!define NSIS_HOOK_POSTINSTALL "NSIS_HOOK_POSTINSTALL_"
!macro NSIS_HOOK_POSTINSTALL_
  MessageBox MB_OK "PostInstall"
!macroend

!define NSIS_HOOK_PREUNINSTALL "NSIS_HOOK_PREUNINSTALL_"
!macro NSIS_HOOK_PREUNINSTALL_
  MessageBox MB_OK "PreUnInstall"
!macroend

!define NSIS_HOOK_POSTUNINSTALL "NSIS_HOOK_POSTUNINSTALL_"
!macro NSIS_HOOK_POSTUNINSTALL_
  MessageBox MB_OK "PostUninstall"
!macroend

Trait Implementations

impl Clone for NsisConfig

fn clone(&self) -> NsisConfig

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for NsisConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for NsisConfig

fn default() -> NsisConfig

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for NsisConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for NsisConfig

fn eq(&self, other: &NsisConfig) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for NsisConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for NsisConfig

impl StructuralPartialEq for NsisConfig