Struct tugger_wix::WiXInstallerBuilder

pub struct WiXInstallerBuilder { /* fields omitted */ }

Entity used to build installers using the WiX Toolkit.

Implementations

impl WiXInstallerBuilder

pub fn new<P: AsRef<Path>>(
    id_prefix: String,
    target_triple: String,
    build_path: P
) -> Self

Create a new instance.

pub fn variables(&self) -> Iter<'_, String, Option<String>>

Obtain variables that will be used for light invocations.

pub fn set_variable<S: ToString>(&mut self, key: S, value: Option<S>)

Set a WiX variable with an optional value.

These are passed to light.exe.

pub fn build_path(&self) -> &Path

pub fn wxs_files(&self) -> &BTreeMap<PathBuf, WxsBuilder>

pub fn add_wxs(&mut self, wxs: WxsBuilder)

Add a wxs file to build.

pub fn add_extra_build_file<P: AsRef<Path>>(
    &mut self,
    path: P,
    content: impl Into<FileEntry>
) -> Result<()>

Add an extra file to the build environment.

These files will be materialized next to .wxs files.

pub fn add_extra_build_files(&mut self, manifest: &FileManifest) -> Result<()>

Add additional files to be materialized in the build environment.

Files are specified via a FileManifest and will be materialized next to .wxs files.

pub fn install_files(&self) -> &FileManifest

pub fn install_files_mut(&mut self) -> &mut FileManifest

pub fn auto_sign_signtool(&mut self, settings: SigntoolSign)

Register signtool signing settings to be used to automatically sign binaries.

This will automatically sign all installed binaries as well as the generated installer.

pub fn add_files_manifest_wxs(&mut self, root_directory_id: &str) -> Result<()>

Generate a wxs file containing fragments for all files registered for install.

pub fn build<P: AsRef<Path>>(
    &self,
    logger: &Logger,
    output_path: P
) -> Result<()>

Produce an installer using the configuration in this builder.

The output could be an MSI, exe, or other file formats depending on what the wxs files define.