@tauri-apps/cli-v3.0.0-alpha.4

tauri-apps/tauri@tauri-apps/cli-v3.0.0-alpha.4Oct 1, 2026by github-actions[bot]

Upgrading?

AI Summary

Tauri v3 alpha CLI release introducing migration tools and significant API changes.

Key Highlights

  • `tauri migrate` command added to migrate v2 apps to v3
  • Removed `macos-private-api` feature
  • Renamed NSIS `install-icon` to `installer-icon`
  • Runtime selection changes (`.runtime()`, `DynRuntime`)

Breaking Changes

  • Removed the `macos-private-api` Cargo feature and the `app > macOSPrivateApi` configuration option. Window transparency and the `fullScreenEnabled` preference no longer rely on macOS private APIs, so they are always available.

New Features

  • `tauri migrate` now migrates Tauri v2 apps to v3

Full Release Notes

## [3.0.0-alpha.4]

### New Features

- [`49dc7cc39`](https://www.github.com/tauri-apps/tauri/commit/49dc7cc39017f63b81adb09303d9b82d5b71207a) `tauri migrate` now migrates Tauri v2 apps to v3 (v1 and v2 beta apps continue to v3 after their existing migration):
    
    - The Tauri crates and official plugins are updated to v3 in `Cargo.toml` and `package.json`, and the app depends on `tauri-runtime-wry`, which receives the `devtools`, `unstable`, `tracing`, `x11`, `dbus` and `macos-proxy` features (including the ones enabled through the app's own `[features]`). The removed `wry`, `macos-private-api` and `objc-exception` features are dropped.
    - The `app > macOSPrivateApi` option is removed and the NSIS `install-icon` key is renamed to `installer-icon` in the main and platform-specific configuration files, keeping their formatting and comments.
    - The Rust sources select the runtime with `.runtime(tauri_runtime_wry::Wry::default())` on `tauri::Builder::default()`, use `tauri::DynRuntime` instead of `tauri::Wry`, and pick up the renamed `with_inner_blocking`, `initialization_script`, `run_invoke_handler`, `tauri_runtime_wry::{tao, wry, android_binding, webview_version}` APIs.

### Dependencies

- Upgraded to `tauri-cli@3.0.0-alpha.4`

### Breaking Changes

- [`b9a77ebb8`](https://www.github.com/tauri-apps/tauri/commit/b9a77ebb8ab57480a354ec47aa45c6898ec9bfda) Removed the `macos-private-api` Cargo feature and the `app > macOSPrivateApi` configuration option. Window transparency and the `fullScreenEnabled` preference no longer rely on macOS private APIs, so they are always available.


Related Repositories