feat(core): add no_redirection_bitmap API on Windows

Author: zetaloop

.changes/no-redirection-bitmap-config.md

@@ -0,0 +1,6 @@
+---
+'tauri': 'minor:feat'
+'tauri-utils': 'minor:feat'
+---
+
+Added `app > windows > noRedirectionBitmap` config option to disable the window redirection bitmap on Windows.

.changes/no-redirection-bitmap.md

@@ -0,0 +1,7 @@
+---
+'tauri': 'minor:feat'
+'tauri-runtime': 'minor:feat'
+'tauri-runtime-wry': 'minor:feat'
+---
+
+Added `WindowBuilder/WebviewWindowBuilder::no_redirection_bitmap` method to disable the window redirection bitmap on Windows.

crates/tauri-cli/config.schema.json

@@ -425,6 +425,11 @@
             "null"
           ]
         },
+        "noRedirectionBitmap": {
+          "description": "Disables the window redirection bitmap. **Windows only**.",
+          "default": false,
+          "type": "boolean"
+        },
         "theme": {
           "description": "The initial window theme. Defaults to the system theme. Only implemented on Windows and macOS 10.14+.",
           "anyOf": [

crates/tauri-runtime-wry/src/lib.rs

@@ -978,6 +978,8 @@ impl WindowBuilder for WindowBuilderWrapper {
       window = window.window_classname(window_classname);
     }
 
+    window = window.no_redirection_bitmap(config.no_redirection_bitmap);
+
     if let Some(prevent_overflow) = &config.prevent_overflow {
       window = match prevent_overflow {
         PreventOverflowConfig::Enable(true) => window.prevent_overflow(),
@@ -1301,6 +1303,16 @@ impl WindowBuilder for WindowBuilderWrapper {
     self
   }
 
+  #[cfg(windows)]
+  fn no_redirection_bitmap(mut self, enable: bool) -> Self {
+    self.inner = self.inner.with_no_redirection_bitmap(enable);
+    self
+  }
+  #[cfg(not(windows))]
+  fn no_redirection_bitmap(self, _enable: bool) -> Self {
+    self
+  }
+
   #[cfg(target_os = "android")]
   fn activity_name<S: Into<String>>(mut self, class_name: S) -> Self {
     self.inner = self.inner.with_activity_name(class_name.into());

crates/tauri-runtime/src/window.rs

@@ -498,6 +498,11 @@ pub trait WindowBuilder: WindowBuilderBase {
   #[must_use]
   fn window_classname<S: Into<String>>(self, window_classname: S) -> Self;
 
+  /// Disables the window redirection bitmap. This can avoid the white flash that may appear
+  /// before the webview content is rendered when using a transparent window. **Windows only**.
+  #[must_use]
+  fn no_redirection_bitmap(self, enable: bool) -> Self;
+
   /// The name of the activity to create for this webview window.
   #[cfg(target_os = "android")]
   fn activity_name<S: Into<String>>(self, class_name: S) -> Self;

crates/tauri-schema-generator/schemas/config.schema.json

@@ -425,6 +425,11 @@
             "null"
           ]
         },
+        "noRedirectionBitmap": {
+          "description": "Disables the window redirection bitmap. **Windows only**.",
+          "default": false,
+          "type": "boolean"
+        },
         "theme": {
           "description": "The initial window theme. Defaults to the system theme. Only implemented on Windows and macOS 10.14+.",
           "anyOf": [

crates/tauri-utils/src/config.rs

@@ -2053,6 +2053,10 @@ pub struct WindowConfig {
   pub skip_taskbar: bool,
   /// The name of the window class created on Windows to create the window. **Windows only**.
   pub window_classname: Option<String>,
+  /// Disables the window redirection bitmap. This can avoid the white flash that may appear
+  /// before the webview content is rendered when using a transparent window. **Windows only**.
+  #[serde(default, alias = "no-redirection-bitmap")]
+  pub no_redirection_bitmap: bool,
   /// The initial window theme. Defaults to the system theme. Only implemented on Windows and macOS 10.14+.
   pub theme: Option<crate::Theme>,
   /// The style of the macOS title bar.
@@ -2327,6 +2331,7 @@ impl Default for WindowConfig {
       content_protected: false,
       skip_taskbar: false,
       window_classname: None,
+      no_redirection_bitmap: false,
       theme: None,
       title_bar_style: Default::default(),
       traffic_light_position: None,
@@ -3873,6 +3878,7 @@ mod build {
       let content_protected = self.content_protected;
       let skip_taskbar = self.skip_taskbar;
       let window_classname = opt_str_lit(self.window_classname.as_ref());
+      let no_redirection_bitmap = self.no_redirection_bitmap;
       let theme = opt_lit(self.theme.as_ref());
       let title_bar_style = &self.title_bar_style;
       let traffic_light_position = opt_lit(self.traffic_light_position.as_ref());
@@ -3938,6 +3944,7 @@ mod build {
         content_protected,
         skip_taskbar,
         window_classname,
+        no_redirection_bitmap,
         theme,
         title_bar_style,
         traffic_light_position,

crates/tauri/src/test/mock_runtime.rs

@@ -464,6 +464,10 @@ impl WindowBuilder for MockWindowBuilder {
     self
   }
 
+  fn no_redirection_bitmap(self, enable: bool) -> Self {
+    self
+  }
+
   fn shadow(self, enable: bool) -> Self {
     self
   }

crates/tauri/src/webview/webview_window.rs

@@ -599,6 +599,14 @@ impl<'a, R: Runtime, M: Manager<R>> WebviewWindowBuilder<'a, R, M> {
     self
   }
 
+  /// Disables the window redirection bitmap. This can avoid the white flash that may appear
+  /// before the webview content is rendered when using a transparent window. **Windows only**.
+  #[must_use]
+  pub fn no_redirection_bitmap(mut self, enable: bool) -> Self {
+    self.window_builder = self.window_builder.no_redirection_bitmap(enable);
+    self
+  }
+
   /// Sets whether or not the window has shadow.
   ///
   /// ## Platform-specific

crates/tauri/src/window/mod.rs

@@ -611,6 +611,14 @@ impl<'a, R: Runtime, M: Manager<R>> WindowBuilder<'a, R, M> {
     self
   }
 
+  /// Disables the window redirection bitmap. This can avoid the white flash that may appear
+  /// before the webview content is rendered when using a transparent window. **Windows only**.
+  #[must_use]
+  pub fn no_redirection_bitmap(mut self, enable: bool) -> Self {
+    self.window_builder = self.window_builder.no_redirection_bitmap(enable);
+    self
+  }
+
   /// Sets whether or not the window has shadow.
   ///
   /// ## Platform-specific