Struct cargo_packager::config::WindowsConfig

#[non_exhaustive]
pub struct WindowsConfig {
    pub digest_algorithm: Option<String>,
    pub certificate_thumbprint: Option<String>,
    pub tsp: bool,
    pub timestamp_url: Option<String>,
    pub allow_downgrades: bool,
    pub sign_command: Option<String>,
}

The Windows configuration.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

digest_algorithm: Option<String>

The file digest algorithm to use for creating file signatures. Required for code signing. SHA-256 is recommended.

certificate_thumbprint: Option<String>

The SHA1 hash of the signing certificate.

tsp: bool

Whether to use Time-Stamp Protocol (TSP, a.k.a. RFC 3161) for the timestamp server. Your code signing provider may use a TSP timestamp server, like e.g. SSL.com does. If so, enable TSP by setting to true.

timestamp_url: Option<String>

Server to use during timestamping.

allow_downgrades: bool

Whether to validate a second app installation, blocking the user from installing an older version if set to false.

For instance, if 1.2.1 is installed, the user won’t be able to install app version 1.2.0 or 1.1.5.

The default value of this flag is true.

sign_command: Option<String>

Specify a custom command to sign the binaries. This command needs to have a %1 in it which is just a placeholder for the binary path, which we will detect and replace before calling the command.

By Default we use signtool.exe which can be found only on Windows so if you are on another platform and want to cross-compile and sign you will need to use another tool like osslsigncode.

Implementations

impl WindowsConfig

pub fn new() -> Self

Creates a new WindowsConfig.

pub fn digest_algorithm<S: Into<String>>(self, digest_algorithm: S) -> Self

Set the file digest algorithm to use for creating file signatures. Required for code signing. SHA-256 is recommended.

pub fn certificate_thumbprint<S: Into<String>>( self, certificate_thumbprint: S ) -> Self

Set the SHA1 hash of the signing certificate.

pub fn tsp(self, tsp: bool) -> Self

Set whether to use Time-Stamp Protocol (TSP, a.k.a. RFC 3161) for the timestamp server. Your code signing provider may use a TSP timestamp server, like e.g. SSL.com does. If so, enable TSP by setting to true.

pub fn timestamp_url<S: Into<String>>(self, timestamp_url: S) -> Self

Set server url to use during timestamping.

pub fn allow_downgrades(self, allow: bool) -> Self

Set whether to validate a second app installation, blocking the user from installing an older version if set to false.

For instance, if 1.2.1 is installed, the user won’t be able to install app version 1.2.0 or 1.1.5.

The default value of this flag is true.

Trait Implementations

impl Clone for WindowsConfig

fn clone(&self) -> WindowsConfig

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for WindowsConfig

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

Formats the value using the given formatter.

impl Default for WindowsConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for WindowsConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for WindowsConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.