tauri-runtime-cef-v3.0.0-alpha.2

puckeditor/pucktauri-runtime-cef-v3.0.0-alpha.2Sep 21, 2026by github-actions[bot]

Upgrading?

AI Summary

The Tauri CEF runtime v3.0.0-alpha.2 adds support for CEF downgrade policies, profile isolation via `data_store_identifier`, and fixes version reporting. It also bumps the Windows crate to fix build compatibility.

Key Highlights

  • Added `Cef::downgrade` and `DowngradePolicy` for handling application rollbacks to older CEF versions
  • Added `data_store_identifier` support for profile isolation
  • Fixed `webview_version` reporting (swapped minor components)
  • Bumped `windows` crate to 0.62 to fix Windows build

Breaking Changes

  • `tauri_runtime::Error::CreateWindow` now carries the underlying error instead of just a string

New Features

  • Downgrade policy support (KeepProfile and ResetProfile)
  • Data store identifier support
  • Documentation updates for unsupported CEF attributes

Full Release Notes

<details>
<summary><em><h4>Cargo Audit</h4></em></summary>

```
Fetching advisory database from `https://github.com/RustSec/advisory-db.git`
      Loaded 1258 security advisories (from /home/runner/.cargo/advisory-db)
    Updating crates.io index
    Scanning Cargo.lock for vulnerabilities (1226 crate dependencies)
Crate:     fxhash
Version:   0.2.1
Warning:   unmaintained
Title:     fxhash - no longer maintained
Date:      2025-09-05
ID:        RUSTSEC-2025-0057
URL:       https://rustsec.org/advisories/RUSTSEC-2025-0057

Crate:     paste
Version:   1.0.15
Warning:   unmaintained
Title:     paste - no longer maintained
Date:      2024-10-07
ID:        RUSTSEC-2024-0436
URL:       https://rustsec.org/advisories/RUSTSEC-2024-0436

Crate:     rustls-pemfile
Version:   2.2.0
Warning:   unmaintained
Title:     rustls-pemfile is unmaintained
Date:      2025-11-28
ID:        RUSTSEC-2025-0134
URL:       https://rustsec.org/advisories/RUSTSEC-2025-0134

Crate:     rustybuzz
Version:   0.20.1
Warning:   unmaintained
Title:     `rustybuzz` is unmaintained
Date:      2026-07-11
ID:        RUSTSEC-2026-0206
URL:       https://rustsec.org/advisories/RUSTSEC-2026-0206

Crate:     ttf-parser
Version:   0.25.1
Warning:   unmaintained
Title:     `ttf-parser` is unmaintained
Date:      2026-06-28
ID:        RUSTSEC-2026-0192
URL:       https://rustsec.org/advisories/RUSTSEC-2026-0192

warning: 5 allowed warnings found
```

</details>

## [3.0.0-alpha.2]

### New Features

- [`e2af2c298`](https://www.github.com/tauri-apps/tauri/commit/e2af2c29824e675382ca9601ea5f1ec630504811) Added `Cef::downgrade` and `DowngradePolicy`, for an application whose release is rolled back to an older CEF. The runtime now records the Chromium version in the root cache path (`Last Version`, the breadcrumb Chrome's own downgrade manager keeps and CEF does not write) and, when a newer Chromium milestone last used the profile, either keeps it and logs a warning (`DowngradePolicy::KeepProfile`, the default and what Chrome does) or moves it aside so Chromium starts on an empty profile and deletes the old one in the background (`DowngradePolicy::ResetProfile`). A downgrade within a milestone, and a profile another running instance of the application holds, are left alone.
- [`9c3bb4d28`](https://www.github.com/tauri-apps/tauri/commit/9c3bb4d28b58d4ede705a04fe0c8cf96f6730ea3) `data_store_identifier` is now supported on the CEF runtime: the identifier names a profile directory under the runtime's cache path, giving the same isolation `data_directory` does (`data_directory` wins when both are set). The runtime also logs a warning when a webview sets an attribute it cannot honour — `transparent`, `accept_first_mouse`, `browser_extensions_enabled` / `extensions_path`, a `background_throttling` policy or an overlay `scroll_bar_style` — naming the runtime-wide `Cef` API that does the same thing where one exists. The attributes' documentation on `tauri` and `tauri-utils` now describes each one's CEF behaviour.

### Enhancements

- [`8d0e40b45`](https://www.github.com/tauri-apps/tauri/commit/8d0e40b45213afe90c98f624617974391f75da70) Log a warning when a webview sets `additional_browser_args`, which the CEF runtime does not support: Chromium's command line is per process, so switches go through `Cef::command_line_arg` instead. The attribute's documentation on `tauri`, `tauri-runtime` and `tauri-utils` now says so.
- [`e2af2c298`](https://www.github.com/tauri-apps/tauri/commit/e2af2c29824e675382ca9601ea5f1ec630504811) The build script now passes the CEF binary distribution `cef-dll-sys` resolved on to the build scripts of dependents, as `DEP_TAURI_RUNTIME_CEF_CEF_DIR`.

### Bug Fixes

- [`e2af2c298`](https://www.github.com/tauri-apps/tauri/commit/e2af2c29824e675382ca9601ea5f1ec630504811) `webview_version` now reports Chromium's version as `MAJOR.MINOR.BUILD.PATCH`; the last two components were swapped.

### Dependencies

- Upgraded to `tauri-utils@3.0.0-alpha.1`
- Upgraded to `tauri-runtime@3.0.0-alpha.1`
- Upgraded to `tauri-macros@3.0.0-alpha.1`
- Upgraded to `tauri@3.0.0-alpha.2`
- [`dfa2f0a5c`](https://www.github.com/tauri-apps/tauri/commit/dfa2f0a5c0516852ee6a7631dc2f4ed63bc4814f) Bump the `windows` crate to 0.62 to match `tauri-runtime`, fixing the Windows build (`HWND` type mismatch in the `WindowBuilder::owner`/`parent` implementations).

### Breaking Changes

- [`4e03a1bb2`](https://www.github.com/tauri-apps/tauri/commit/4e03a1bb298d95526b4c97fde0a367cde9b544c2) ([#16043](https://www.github.com/tauri-apps/tauri/pull/16043)) `tauri_runtime::Error::CreateWindow` now carries the underlying error (`CreateWindow(Box<dyn std::error::Error + Send + Sync>)`), like `CreateWebview`.

<details>
<summary><em><h4>Cargo Publish</h4></em></summary>

```
Updating crates.io index
   Packaging tauri-runtime-cef v3.0.0-alpha.2 (/home/runner/work/tauri/tauri/crates/tauri-runtime-cef)
    Updating crates.io index
    Packaged 71 files, 841.5KiB (220.9KiB compressed)
   Verifying tauri-runtime-cef v3.0.0-alpha.2 (/home/runner/work/tauri/tauri/crates/tauri-runtime-cef)
 Downloading crates ...
  Downloaded wayland-client v0.31.15
  Downloaded unit-prefix v0.5.2
  Downloaded as-raw-xcb-connection v1.0.1
  Downloaded cairo-rs v0.22.9
  Downloaded wayland-scanner v0.31.11
  Downloaded cairo-sys-rs v0.22.9
  Downloaded wayland-protocols v0.32.13
  Downloaded wayland-sys v0.31.11
  Downloaded x11rb v0.13.2
  Downloaded winit-core v0.31.0-beta.3
  Downloaded xcursor v0.3.11
  Downloaded xkbcommon-dl v0.4.2
  Downloaded wayland-backend v0.3.17
  Downloaded winit-common v0.31.0-beta.3
  Downloaded xkeysym v0.2.1
  Downloaded x11rb-protocol v0.13.2
  Downloaded block2 v0.6.2
  Downloaded libloading v0.8.9
  Downloaded objc2-encode v4.1.0
  Downloaded polling v3.11.0
  Downloaded proc-macro-crate v3.5.0
  Downloaded dioxus-debug-cell v0.1.1
  Downloaded download-cef v3.0.0
  Downloaded gdk4 v0.11.4
  Downloaded gdk-pixbuf-sys v0.22.9
  Downloaded glib-macros v0.22.9
  Downloaded gobject-sys v0.22.9
  Downloaded glib-sys v0.22.9
  Downloaded html5ever v0.29.1
  Downloaded kuchikiki v0.8.8-speedreader
  Downloaded markup5ever v0.14.1
  Downloaded nodrop v0.1.14
  Downloaded pango v0.22.9
  Downloaded pango-sys v0.22.9
  Downloaded phf v0.10.1
  Downloaded phf_generator v0.8.0
  Downloaded rand_pcg v0.2.1
  Downloaded servo_arc v0.2.0
  Downloaded system-deps v9.0.0
  Downloaded calloop v0.14.4
  Downloaded dirs v6.0.0
  Downloaded dlib v0.5.3
  Downloaded downcast-rs v1.2.1
  Downloaded fxhash v0.2.1
  Downloaded gethostname v1.1.0
  Downloaded phf_generator v0.10.0
  Downloaded phf_shared v0.10.0
  Downloaded scoped-tls v1.0.1
  Downloaded string_cache_codegen v0.5.4
  Downloaded siphasher v0.3.11
  Downloaded cfg-expr v0.20.9
  Downloaded cssparser v0.29.6
  Downloaded cssparser-macros v0.6.1
  Downloaded derive_more v0.99.20
  Downloaded gdk4-sys v0.11.4
  Downloaded gio-sys v0.22.9
  Downloaded graphene-rs v0.22.8
  Downloaded graphene-sys v0.22.9
  Downloaded matches v0.1.10
  Downloaded phf v0.8.0
  Downloaded phf_shared v0.8.0
  Downloaded cargo-platform v0.3.3
  Downloaded cursor-icon v1.2.0
  Downloaded cargo_metadata v0.23.1
  Downloaded cookie_store v0.22.1
  Downloaded dispatch2 v0.3.1
  Downloaded document-features v0.2.12
  Downloaded indicatif v0.18.6
  Downloaded getrandom v0.1.16
  Downloaded litrs v1.0.0
  Downloaded phf v0.11.3
  Downloaded objc2-core-foundation v0.3.2
  Downloaded objc2 v0.6.4
  Downloaded phf_codegen v0.11.3
  Downloaded phf_shared v0.11.3
  Downloaded objc2-foundation v0.3.2
  Downloaded phf_generator v0.11.3
  Downloaded portable-atomic v1.15.0
  Downloaded rand_core v0.5.1
  Downloaded rand v0.7.3
  Downloaded rand_chacha v0.2.2
  Downloaded quick-xml v0.41.0
  Downloaded phf_macros v0.10.0
  Downloaded proc-macro-hack v0.5.20+deprecated
  Downloaded string_cache v0.8.9
  Downloaded target-lexicon v0.13.5
  Downloaded tendril v0.4.3
  Downloaded console v0.16.4
  Downloaded selectors v0.24.0
  Downloaded toml_edit v0.25.13+spec-1.1.0
  Downloaded match_token v0.1.0
  Downloaded convert_case v0.4.0
  Downloaded mac v0.1.1
  Downloaded futf v0.1.5
  Downloaded phf_codegen v0.8.0
  Downloaded system-deps v7.0.8
  Downloaded glib v0.22.9
  Downloaded cef-dll-sys v152.3.0+152.0.6
  Downloaded gdk4-x11 v0.11.4
  Downloaded gdk-pixbuf v0.22.0
  Downloaded gdk4-x11-sys v0.11.0
  Downloaded cef v152.3.0+152.0.6
  Downloaded gsk4-sys v0.11.4
  Downloaded gdk4-wayland v0.11.4
  Downloaded gtk4-macros v0.11.4
  Downloaded tauri-winit-gtk4 v0.31.0-beta.3
  Downloaded gsk4 v0.11.4
  Downloaded gio v0.22.9
  Downloaded gtk4 v0.11.4
  Downloaded tauri-winit v0.31.0-beta.3
  Downloaded gtk4-sys v0.11.4
  Downloaded tauri-winit-x11 v0.31.0-beta.3
  Downloaded gdk4-wayland-sys v0.11.0
   Compiling serde_core v1.0.229
   Compiling winnow v1.0.4
   Compiling toml_datetime v1.1.1+spec-1.1.0
   Compiling target-lexicon v0.13.5
   Compiling system-deps v9.0.0
   Compiling yoke v0.8.3
   Compiling zerovec v0.11.8
   Compiling cfg-expr v0.20.9
   Compiling tinystr v0.8.4
   Compiling toml_parser v1.1.3+spec-1.1.0
   Compiling zerotrie v0.2.5
   Compiling icu_locale_core v2.3.0
   Compiling potential_utf v0.1.6
   Compiling toml v1.1.5+spec-1.1.0
   Compiling icu_collections v2.3.0
   Compiling serde v1.0.229
   Compiling bitflags v2.13.1
   Compiling icu_provider v2.3.1
   Compiling getrandom v0.2.17
   Compiling zerocopy v0.8.56
   Compiling icu_properties v2.3.0
   Compiling semver v1.0.28
   Compiling glib-sys v0.22.9
   Compiling gobject-sys v0.22.9
   Compiling system-deps v7.0.8
   Compiling gio-sys v0.22.9
   Compiling futures-util v0.3.34
   Compiling rand_core v0.6.4
   Compiling siphasher v0.3.11
   Compiling pango-sys v0.22.9
   Compiling gdk-pixbuf-sys v0.22.9
   Compiling cairo-sys-rs v0.22.9
   Compiling darling_core v0.24.1
   Compiling glib-macros v0.22.9
   Compiling futures-executor v0.3.34
   Compiling ppv-lite86 v0.2.21
   Compiling getrandom v0.1.16
   Compiling rand_chacha v0.3.1
   Compiling rand v0.8.8
   Compiling gdk4-sys v0.11.4
   Compiling rustc_version v0.4.1
   Compiling icu_normalizer v2.3.0
   Compiling idna_adapter v1.2.2
   Compiling bytes v1.12.1
   Compiling darling_macro v0.24.1
   Compiling phf_shared v0.11.3
   Compiling darling v0.24.1
   Compiling rustix v1.1.4
   Compiling serde_with_macros v3.23.0
   Compiling idna v1.1.0
   Compiling rand_core v0.5.1
   Compiling glib v0.22.9
   Compiling string_cache v0.9.0
   Compiling libloading v0.8.9
   Compiling syn v1.0.109
   Compiling linux-raw-sys v0.12.1
   Compiling ring v0.17.14
   Compiling web_atoms v0.2.6
   Compiling url v2.5.8
   Compiling tendril v0.5.1
   Compiling graphene-sys v0.22.9
   Compiling serde_json v1.0.151
   Compiling zeroize v1.9.0
   Compiling rustls-pki-types v1.15.1
   Compiling cssparser v0.37.0
   Compiling markup5ever v0.39.0
   Compiling dlib v0.5.3
   Compiling rand_chacha v0.2.2
   Compiling rand_pcg v0.2.1
   Compiling phf_generator v0.11.3
   Compiling phf_shared v0.8.0
   Compiling servo_arc v0.4.3
   Compiling proc-macro-hack v0.5.20+deprecated
   Compiling untrusted v0.9.0
   Compiling gio v0.22.9
   Compiling cairo-rs v0.22.9
   Compiling httparse v1.10.1
   Compiling selectors v0.38.0
   Compiling rand v0.7.3
   Compiling html5ever v0.39.0
   Compiling http v1.5.0
   Compiling camino v1.2.5
   Compiling phf_shared v0.10.0
   Compiling gsk4-sys v0.11.4
   Compiling portable-atomic v1.15.0
   Compiling rustls v0.23.45
   Compiling schemars v1.2.2
   Compiling dom_query v0.28.0
   Compiling cargo_metadata v0.19.2
   Compiling phf_generator v0.10.0
   Compiling tracing v0.1.44
   Compiling phf_generator v0.8.0
   Compiling rustls-webpki v0.103.15
   Compiling phf_codegen v0.11.3
   Compiling string_cache_codegen v0.5.4
   Compiling urlpattern v0.6.0
   Compiling serde_with v3.23.0
   Compiling fs-err v3.3.1
   Compiling dpi v0.1.2
   Compiling wayland-sys v0.31.11
   Compiling mac v0.1.1
   Compiling subtle v2.6.1
   Compiling once_cell v1.21.4
   Compiling unicode-width v0.2.2
   Compiling console v0.16.4
   Compiling futf v0.1.5
   Compiling tokio v1.53.1
   Compiling tauri-utils v3.0.0-alpha.1
   Compiling pango v0.22.9
   Compiling gdk-pixbuf v0.22.0
   Compiling gdk4 v0.11.4
   Compiling markup5ever v0.14.1
   Compiling phf_macros v0.10.0
   Compiling ureq-proto v0.6.2
   Compiling phf_codegen v0.8.0
   Compiling xattr v1.6.1
   Compiling cssparser v0.29.6
   Compiling webpki-roots v1.0.9
   Compiling field-offset v0.3.6
   Compiling socks v0.3.4
   Compiling gtk4-sys v0.11.4
   Compiling wayland-backend v0.3.17
   Compiling keyboard-types v0.8.3
   Compiling toml_edit v0.25.13+spec-1.1.0
   Compiling clap_derive v4.6.4
   Compiling filetime v0.2.29
   Compiling libbz2-rs-sys v0.2.5
   Compiling utf8-zero v0.8.1
   Compiling unit-prefix v0.5.2
   Compiling ureq v3.4.1
   Compiling indicatif v0.18.6
   Compiling clap v4.6.6
   Compiling bzip2 v0.6.1
   Compiling tendril v0.4.3
   Compiling tar v0.4.46
   Compiling proc-macro-crate v3.5.0
   Compiling phf v0.10.1
   Compiling selectors v0.24.0
   Compiling string_cache v0.8.9
   Compiling http-body v1.1.0
   Compiling graphene-rs v0.22.8
   Compiling phf v0.11.3
   Compiling embed-resource v3.0.11
   Compiling quick-xml v0.41.0
   Compiling cssparser-macros v0.6.1
   Compiling scoped-tls v1.0.1
   Compiling wayland-client v0.31.15
   Compiling convert_case v0.4.0
   Compiling sha1_smol v1.0.1
   Compiling nodrop v0.1.14
   Compiling matches v0.1.10
   Compiling downcast-rs v1.2.1
   Compiling servo_arc v0.2.0
   Compiling download-cef v3.0.0
   Compiling wayland-scanner v0.31.11
   Compiling derive_more v0.99.20
   Compiling gsk4 v0.11.4
   Compiling tauri-winres v0.3.6
   Compiling gtk4-macros v0.11.4
   Compiling phf v0.8.0
   Compiling fxhash v0.2.1
   Compiling gdk4-wayland-sys v0.11.0
   Compiling gdk4-x11-sys v0.11.0
   Compiling cargo_toml v1.0.1
   Compiling cmake v0.1.58
   Compiling uuid v1.26.0
   Compiling match_token v0.1.0
   Compiling xkeysym v0.2.1
   Compiling smol_str v0.3.6
   Compiling cursor-icon v1.2.0
   Compiling html5ever v0.29.1
   Compiling winit-core v0.31.0-beta.3
   Compiling xkbcommon-dl v0.4.2
   Compiling tauri-build v3.0.0-alpha.1
   Compiling cfb v0.14.0
   Compiling cef-dll-sys v152.3.0+152.0.6
   Compiling gtk4 v0.11.4
   Compiling jsonptr v0.7.1
   Compiling polling v3.11.0
   Compiling gethostname v1.1.0
   Compiling erased-serde v0.4.10
   Compiling serde_spanned v1.1.1
   Compiling x11rb-protocol v0.13.2
   Compiling xcursor v0.3.11
   Compiling as-raw-xcb-connection v1.0.1
   Compiling hyper v1.11.1
   Compiling wayland-protocols v0.32.13
   Compiling tower v0.5.3
   Compiling serde-untagged v0.1.9
   Compiling calloop v0.14.4
   Compiling kuchikiki v0.8.8-speedreader
   Compiling json-patch v4.2.0
   Compiling ico v0.5.0
   Compiling tauri v3.0.0-alpha.2
   Compiling infer v0.22.0
   Compiling winit-common v0.31.0-beta.3
   Compiling plist v1.10.1
   Compiling png v0.18.1
   Compiling x11rb v0.13.2
   Compiling muda v0.20.0
   Compiling bytemuck v1.25.2
   Compiling cfg_aliases v0.2.2
   Compiling tauri-winit v0.31.0-beta.3
   Compiling tauri-winit-x11 v0.31.0-beta.3
   Compiling tokio-util v0.7.19
   Compiling hyper-util v0.1.20
   Compiling tauri-codegen v3.0.0-alpha.1
   Compiling gdk4-x11 v0.11.4
   Compiling gdk4-wayland v0.11.4
   Compiling tower-http v0.6.11
   Compiling http-body-util v0.1.5
   Compiling cargo-platform v0.3.3
   Compiling serialize-to-javascript v0.1.2
   Compiling cargo_metadata v0.23.1
   Compiling tauri-runtime v3.0.0-alpha.1
   Compiling reqwest v0.13.4
   Compiling tauri-winit-gtk4 v0.31.0-beta.3
   Compiling tauri-macros v3.0.0-alpha.1
   Compiling tauri-runtime-cef v3.0.0-alpha.2 (/home/runner/work/tauri/tauri/target/package/tauri-runtime-cef-3.0.0-alpha.2)
   Compiling dirs v6.0.0
   Compiling dioxus-debug-cell v0.1.1
   Compiling cef v152.3.0+152.0.6
    Finished `dev` profile [unoptimized + debuginfo] target(s) in 2m 07s
   Uploading tauri-runtime-cef v3.0.0-alpha.2 (/home/runner/work/tauri/tauri/crates/tauri-runtime-cef)
    Uploaded tauri-runtime-cef v3.0.0-alpha.2 to registry `crates-io`
note: waiting for tauri-runtime-cef v3.0.0-alpha.2 to be available at registry `crates-io`
help: you may press ctrl-c to skip waiting; the crate should be available shortly
   Published tauri-runtime-cef v3.0.0-alpha.2 at registry `crates-io`
```

</details>

Related Repositories