Webview runtime installation mode configuration
In Tauri 2, tauri.bundle.windows.webviewFixedRuntimePath was removed and replaced with bundle.windows.webviewInstallMode.
building & bundling
45 notes, read out of this brain and free to use. Each one was extracted from a source and is re-checked against its exam.
License file configuration unified in Tauri 2
In Tauri 2, license configuration was unified: tauri.bundle.macOS.license, tauri.bundle.windows.wix.license, and tauri.bundle.windows.nsis.license were all removed and replaced with bundle.licenseFile at the top level.
Bundle Linux configuration paths change
In Tauri 2, tauri.bundle.deb moved to bundle.linux.deb and tauri.bundle.appimage moved to bundle.linux.appimage.
Bundle macOS DMG configuration path change
In Tauri 2, tauri.bundle.dmg moved to bundle.macOS.dmg.
Cargo feature linux-protocol-body requirements
In Tauri 2, the linux-protocol-body feature enables custom protocol request body parsing for IPC usage and requires webkit2gtk 2.40.
Removed Cargo features in Tauri 2.0
The following Cargo features were removed: reqwest-client (reqwest is the only enabled client); reqwest-native-tls-vendored (use 'native-tls-vendored' instead); process-command-api (use 'shell' plugin); shell-open-api (use 'shell' plugin); windows7-compat (moved to 'notification' plugin); updater (now a plugin); linux-protocol-headers (webkit2gtk minimum upgraded and enabled by default); system-tray (renamed to 'tray-icon').
Configuration migration: bundle platform-specific settings
Move 'tauri > bundle > dmg' to 'bundle > macOS > dmg'. Move 'tauri > bundle > deb' to 'bundle > linux > deb'. Move 'tauri > bundle > appimage' to 'bundle > linux > appimage'. Replace 'bundle > {macOS|windows} > license' with 'bundle > licenseFile'. Replace 'bundle > windows > webviewFixedRuntimePath' with 'bundle > windows > webviewInstallMode'.
New Cargo feature: linux-protocol-body
The 'linux-protocol-body' Cargo feature enables body parsing for custom protocol requests and allows their use in IPC. Requires webkit2gtk 2.40 or later.
Android 16KB memory pages requirement
Google is moving to make 16KB memory pages a requirement in all new Android app submissions. Building with NDK version 28 or higher should automatically generate bundles that meet this requirement. For older NDK versions, add rustflags = ["-C", "link-arg=-Wl,-z,max-page-size=16384"] to [target.aarch64-linux-android] in .cargo/config.toml.
AppImage build tools caching
Tauri 1.1.0 avoids re-downloading AppImage build tools on every build.
tauri icon command for icon generation
Tauri 1.1.0 includes a tauri icon command that generates icons for your Tauri application using a single source PNG. This functionality was previously available through the separate tauricon project but has been rewritten in Rust and integrated into the main Tauri CLI.
Icon file rebuild optimization
Tauri 1.1.0 only rewrites temporary icon files when the content changes, avoiding needless rebuilds.
Codegen rerun on asset or icon changes
Tauri 1.1.0 reruns codegen if assets or icons change.
cargo-binstall support for Tauri CLI
The Tauri CLI can be installed using cargo-binstall, a mechanism to download and install pre-built Rust binaries. Pre-built binaries are available for the main targets and can be installed with: cargo install cargo-binstall followed by cargo binstall tauri-cli.
beforeBundleCommand configuration option
Tauri 1.1.0 adds support for beforeBundleCommand configuration option.
native-tls-vendored Cargo features
Tauri 1.1.0 adds native-tls-vendored and reqwest-native-tls-vendored Cargo features to compile and statically link to a vendored copy of OpenSSL on Linux.
tauri dev --no-watch option
Tauri 1.1.0 adds an option to disable the dev watcher with tauri dev --no-watch.
Sidecar file name collision prevention
Tauri 1.1.0 returns an error if a sidecar is configured with the same file name as the application.
cargo metadata for workspace detection
Tauri 1.1.0 uses cargo metadata to detect the workspace root and target directory instead of manual configuration.
WiX environment variables fix in Tauri 1.2.0 Windows bundling
Tauri 1.2.0 fixed a Windows bundling issue by clearing environment variables on WiX light.exe and candle.exe commands to avoid the "Windows Installer Service could not be accessed" error. Variables prefixed with TAURI are propagated.
Bundle publisher configuration option in Tauri 1.2.0
Tauri 1.2.0 added a configuration option for the bundle publisher.
Tauri 1.2.0 minimum Rust version requirement
Tauri 1.2.0 requires a minimum Rust version of 1.59 to compile.
NSIS installer support in Tauri 1.3
The Tauri CLI can now create Windows application installers using NSIS. This new bundle target is also available on macOS and Linux as an experimental feature, allowing cross-compilation of Windows installers.
Dylib support in macOS frameworks
Tauri 1.3 added dylib support to tauri.bundle.macOS.frameworks.
Windows MSI installer Launch App checkbox default
On Windows, the MSI installer's Launch App checkbox is checked by default in Tauri 1.3.
Icon command --png option for custom sizes
Tauri 1.3 added a --png option for the icon command to generate custom icon sizes.
Windows application manifest support
Tauri 1.3 added WindowsAttributes::app_manifest to specify the application manifest on Windows.
MSI bundle pre-release identifiers and build numbers
Tauri 1.3 added support for pre-release identifiers and build numbers for the .msi bundle target. Only one of each can be used and it must be numeric only. The version must still be semver compatible according to https://semver.org/.
NSIS improvements in Tauri 1.4.0
Tauri 1.4.0 includes NSIS bundle enhancements: custom language files, custom installer template (.nsi file), support for Dutch, Japanese, Korean, Persian, Swedish and Turkish languages, prompt to uninstall WiX-installed applications before NSIS installation, and improved updater install modes support.
Upgrading to Tauri 1.6.0 requires updating NPM and Cargo dependencies
To upgrade to Tauri 1.6.0, both NPM and Cargo dependencies must be updated. NPM dependencies include @tauri-apps/cli and @tauri-apps/api, which can be updated with npm install, yarn upgrade, or pnpm update commands. Cargo dependencies are updated with cargo update.
macOS frameworks custom rpath support
Tauri 1.5 enhanced macOS frameworks support by code signing all custom frameworks injected via `tauri.conf.json > tauri > bundle > macOS > frameworks` and defining the `@rpath` value to fix crashes when updating the app.
Custom Windows codesign script feature backported to 1.7.0
The custom sign command feature was backported from v2 to v1, allowing the use of alternatives to SignTool such as osslsigncode and relic. These alternatives can run on Unix systems and support hardware tokens, Azure Key Vault, and other features.
RPM bundle support added to 1.7.0
RPM packaging, which was previously available only in Tauri v2, is now available in the v1 channel.
DMG installer configuration in 1.7.0
DMG installers became configurable in 1.7.0, allowing users to change the position of icons and the window size to fit better within a custom background.
Tauri v2.0.0-alpha.3 MSRV bumped to Rust 1.64
Tauri v2.0.0-alpha.3 increases the Minimum Supported Rust Version (MSRV) to 1.64. This version satisfies the latest version of windows-rs, which will be updated in the future.
Linux WebKit2GTK-4.1 installation commands
To install WebKit2GTK-4.1 on Linux for Tauri v2.0.0-alpha.3 or later: On Arch Linux/Manjaro run 'sudo pacman -S webkit2gtk-4.1'. On Debian/Ubuntu run 'sudo apt install libwebkit2gtk-4.1-dev'. On Fedora run 'sudo dnf install webkit2gtk4.1-devel'.
Reason for WebKit2GTK-4.1 adoption
The upgrade to WebKit2GTK-4.1 was performed to add Flatpak support, as the Gnome runtime uses webkit2gtk-4.1. Additionally, the upgrade fixes subtle bugs in soup2 that are resolved in soup3.
MSRV update policy in Tauri 2.0
After Tauri v2.0 is released, the MSRV will be updated with minor releases. This approach aims to ease friction for developers who want to stick to a fixed Rust version while updating dependencies.
File associations support in Tauri 2.0 bundler
Tauri 2.0 bundler added support for file associations.
Distribution guides available in Tauri 2.0
Tauri 2.0 provides official guides for shipping applications to the Apple App Store, Google Play, Microsoft Store, CrabNebula Cloud, Flathub, Snapcraft, AUR, and other distribution formats.
GitHub Action status for mobile support
The Tauri GitHub Action (tauri-action) is in progress to support automated building for mobile operating systems but does not yet support them.
Window transparency on exit bug fix in Tauri 2.0
Tauri 2.0 fixed a Windows-specific bug where decorated windows were not transparent initially until resized.
Dock icon click handling on macOS in Tauri 2.0
Tauri 2.0 added `tauri::RunEvent::Reopen` to handle click on dock icon on macOS.
Linux-specific APIs in Tauri 2.0
Tauri 2.0 added `tauri::WebviewWindow::default_vbox` method on Linux to get a reference to the `gtk::Box` that contains the menu bar and the webview. Added `linux-libxdo` cargo feature flag (disabled by default) to enable linking to `libxdo` to make `Cut`, `Copy`, `Paste`, and `SelectAll` native menu items work on Linux. Set the gtk application id to the `identifier` defined in `tauri.conf.json` to ensure app uniqueness; this can be disabled by setting `enableGtkAppId` option to `false`.
macOS-specific APIs in Tauri 2.0
Tauri 2.0 added `tauri::WebviewWindow::ns_view` method on macOS to get a pointer to the `NSWindow` content view.