[test] re;ease 0.3.14.post40

Author: Ghua8088

pyproject.toml

@@ -13,7 +13,7 @@ namespaces = false
 
 [project]
 name = "pytron-kit"
-version = "0.3.14.post39"
+version = "0.3.14.post40"
 description = "An Electron-like library for Python to build Cross Platform Apps"
 readme = "README.md"
 requires-python = ">=3.7"

pytron/engines/native/src/webview.rs

@@ -348,7 +348,20 @@ impl NativeWebview {
         });
 
         let webview = builder.build()
-             .map_err(|e| PyErr::new::<pyo3::exceptions::PyRuntimeError, _>(format!("Failed to build WebView: {}", e)))?;
+             .map_err(|e| {
+                 #[cfg(target_os = "linux")]
+                 {
+                     use raw_window_handle::HasRawWindowHandle;
+                     let handle_kind = format!("{:?}", window.raw_window_handle());
+                     PyErr::new::<pyo3::exceptions::PyRuntimeError, _>(format!(
+                         "Failed to build WebView: {}\nHandle: {}", e, handle_kind
+                     ))
+                 }
+                 #[cfg(not(target_os = "linux"))]
+                 {
+                     PyErr::new::<pyo3::exceptions::PyRuntimeError, _>(format!("Failed to build WebView: {}", e))
+                 }
+             })?;
 
         // Re-hide on Linux after successful build so it stays hidden until explicitly shown
         #[cfg(target_os = "linux")]

pytron/webview.py

@@ -128,19 +128,29 @@ def _init_native_engine(self, config):
                 f"Cause: {details}\n"
             )
 
+        orig_wayland = None
+        orig_winit = None
+        orig_gdk = None
+        is_wayland = False
+
         if sys.platform.startswith("linux"):
             self.logger.warning("Linux Native Engine is still experimental.")
             import os
 
             session_type = os.environ.get("XDG_SESSION_TYPE", "").lower()
             if session_type == "wayland":
-                if not os.environ.get("WINIT_UNIX_BACKEND"):
-                    self.logger.info(
-                        "Wayland session detected, forcing WINIT_UNIX_BACKEND=x11 for better native stability."
-                    )
-                    os.environ["WINIT_UNIX_BACKEND"] = "x11"
-                if not os.environ.get("GDK_BACKEND"):
-                    os.environ["GDK_BACKEND"] = "x11"
+                is_wayland = True
+                self.logger.info(
+                    "Wayland session detected. Forcing X11 backend temporarily to initialize native webview."
+                )
+                orig_wayland = os.environ.get("WAYLAND_DISPLAY")
+                orig_winit = os.environ.get("WINIT_UNIX_BACKEND")
+                orig_gdk = os.environ.get("GDK_BACKEND")
+
+                if "WAYLAND_DISPLAY" in os.environ:
+                    del os.environ["WAYLAND_DISPLAY"]
+                os.environ["WINIT_UNIX_BACKEND"] = "x11"
+                os.environ["GDK_BACKEND"] = "x11"
 
         raw_url = config.get("url", "")
         debug = config.get("debug", False)
@@ -196,6 +206,22 @@ def _init_native_engine(self, config):
                 ) from e
 
             raise NativeEngineError(f"Failed to initialize Native WebView: {e}") from e
+        finally:
+            if is_wayland:
+                import os
+
+                if orig_wayland is not None:
+                    os.environ["WAYLAND_DISPLAY"] = orig_wayland
+                else:
+                    os.environ.pop("WAYLAND_DISPLAY", None)
+                if orig_winit is not None:
+                    os.environ["WINIT_UNIX_BACKEND"] = orig_winit
+                else:
+                    os.environ.pop("WINIT_UNIX_BACKEND", None)
+                if orig_gdk is not None:
+                    os.environ["GDK_BACKEND"] = orig_gdk
+                else:
+                    os.environ.pop("GDK_BACKEND", None)
 
     def _setup_native_window(self, config):
         """Applies window settings and platform helpers for native engine."""