feat(ohos): adapt webdriver and floating window features

- adapt WebDriver script runtime and capture behavior for HarmonyOS
- fix toolbar mode native controls, geometry, and restore behavior

Author: SWangHash

Cargo.lock

@@ -5,7 +5,6 @@
   "windows": ["main", "agent-companion-pet", "spotlight"],
   "permissions": [
     "log:default",
-    "autostart:default",
     "core:default",
     "core:path:default",
     "core:event:default",
@@ -45,12 +44,6 @@
     "core:window:allow-unmaximize",
     "core:window:allow-unminimize",
     "core:window:allow-set-min-size",
-    "dialog:default",
-    "dialog:allow-open",
-    "dialog:allow-save",
-    "dialog:allow-ask",
-    "dialog:allow-confirm",
-    "dialog:allow-message",
     "opener:default",
     "opener:allow-open-url",
     {

src/apps/desktop/capabilities/default.json

@@ -35,7 +35,7 @@ fn default_cdp_port() -> u16 {
 /// no live endpoint to reattach to, it does nothing and leaves the on-demand
 /// path to handle it.
 pub fn init_on_startup() {
-    tokio::spawn(async {
+    tauri::async_runtime::spawn(async {
         if !auto_connect_on_startup_enabled().await {
             return;
         }

src/apps/desktop/src/api/browser_control_api.rs

@@ -275,11 +275,24 @@ export default class EntryAbility extends RustAbility {
     });
     RustModule.registerArktsFunction('set_decorations_ohos', async (err: Error, arg: string): Promise<string> => {
       const req: SetDecorationsArg = JSON.parse(arg);
+      const mainWin = windowStage.getMainWindowSync();
       try {
-        await windowStage.getMainWindowSync().setWindowDecorVisible(req.visible);
+        // Showing native title buttons makes HarmonyOS fall back to hover-only
+        // window decorations. Re-apply the same custom title-bar configuration
+        // used at startup after restoring the buttons.
+        await mainWin.setWindowTitleButtonVisible(
+          req.visible,
+          req.visible,
+          req.visible,
+        );
+        if (req.visible) {
+          mainWin.setWindowDecorHeight(44);
+          mainWin.setWindowTitleMoveEnabled(false);
+          mainWin.setWindowDecorVisible(false);
+        }
       } catch (e) {
         const be = e as BusinessError;
-        hilog.warn(DOMAIN, TAG, `setWindowDecorVisible failed: ${be.message}`);
+        hilog.warn(DOMAIN, TAG, `setWindowTitleButtonVisible failed: ${be.message}`);
       }
       return '';
     });
@@ -334,17 +347,27 @@ export default class EntryAbility extends RustAbility {
         dispWidth = disp.width;
         dispHeight = disp.height;
         scale = disp.densityPixels > 0 ? disp.densityPixels : 1;
+        // A floating window may not intersect the system bar when this query
+        // runs, in which case getWindowAvoidArea() reports zero. The display's
+        // available bounds still exclude the desktop bar, so keep that
+        // right/bottom reservation as a monitor-level fallback.
+        if (disp.availableWidth > 0 && disp.availableWidth <= disp.width) {
+          avoidRight = Math.max(avoidRight, disp.width - disp.availableWidth);
+        }
+        if (disp.availableHeight > 0 && disp.availableHeight <= disp.height) {
+          avoidBottom = Math.max(avoidBottom, disp.height - disp.availableHeight);
+        }
       } catch (e) {
         const be = e as BusinessError;
         hilog.warn(DOMAIN, TAG, `getDefaultDisplaySync failed: ${be.message}`);
       }
       try {
         const avoidArea = windowStage.getMainWindowSync()
           .getWindowAvoidArea(window.AvoidAreaType.TYPE_SYSTEM);
-        avoidTop = avoidArea.topRect.height;
-        avoidBottom = avoidArea.bottomRect.height;
-        avoidLeft = avoidArea.leftRect.width;
-        avoidRight = avoidArea.rightRect.width;
+        avoidTop = Math.max(avoidTop, avoidArea.topRect.height);
+        avoidBottom = Math.max(avoidBottom, avoidArea.bottomRect.height);
+        avoidLeft = Math.max(avoidLeft, avoidArea.leftRect.width);
+        avoidRight = Math.max(avoidRight, avoidArea.rightRect.width);
       } catch (e) {
         const be = e as BusinessError;
         hilog.warn(DOMAIN, TAG, `getWindowAvoidArea failed: ${be.message}`);
@@ -389,7 +412,7 @@ export default class EntryAbility extends RustAbility {
     });
     RustModule.registerArktsFunction('maximize_ohos', async (err: Error, arg: string): Promise<string> => {
       try {
-        await windowStage.getMainWindowSync().maximize();
+        await windowStage.getMainWindowSync().maximize(window.MaximizePresentation.EXIT_IMMERSIVE);
       } catch (e) {
         const be = e as BusinessError;
         hilog.warn(DOMAIN, TAG, `maximize failed: ${be.message}`);

src/apps/ohos/entry/src/main/ets/entryability/EntryAbility.ets

@@ -570,7 +570,7 @@ mod imp {
     }
 }
 
-#[cfg(target_os = "linux")]
+#[cfg(all(target_os = "linux", not(target_env = "ohos")))]
 mod imp {
     use super::*;
 
@@ -594,6 +594,30 @@ mod imp {
     }
 }
 
+#[cfg(target_env = "ohos")]
+mod imp {
+    use super::*;
+
+    pub(super) async fn take_screenshot<R: Runtime>(
+        _webview: Webview<R>,
+        _timeout_ms: u64,
+    ) -> Result<String, WebDriverErrorResponse> {
+        Err(WebDriverErrorResponse::unsupported_operation(
+            "HarmonyOS ArkWeb screenshots require a native capture provider",
+        ))
+    }
+
+    pub(super) async fn print_page<R: Runtime>(
+        _webview: Webview<R>,
+        _timeout_ms: u64,
+        _options: &PrintOptions,
+    ) -> Result<String, WebDriverErrorResponse> {
+        Err(WebDriverErrorResponse::unsupported_operation(
+            "HarmonyOS ArkWeb printing requires a native print provider",
+        ))
+    }
+}
+
 #[cfg(not(any(target_os = "macos", target_os = "windows", target_os = "linux")))]
 mod imp {
     use super::*;

src/crates/adapters/webdriver/src/platform/capture.rs

@@ -27,6 +27,11 @@ pub(crate) async fn evaluate_script<R: tauri::Runtime>(
     async_mode: bool,
     frame_context: &Value,
 ) -> Result<Value, WebDriverErrorResponse> {
+    // OpenHarmony's ArkWeb host currently reaches this generic evaluator via
+    // the Tauri fork's Webview::eval implementation. The injected bridge is
+    // pure page JavaScript, so pointer/wheel/key actions remain shared. A
+    // future ArkWeb-native provider can replace only this branch when it needs
+    // a direct runJavaScript/result callback instead of Tauri IPC.
     #[cfg(target_os = "macos")]
     {
         let _ = state;

src/crates/adapters/webdriver/src/platform/evaluator/mod.rs

@@ -85,5 +85,28 @@ pub(crate) async fn run_script(
     let timeout_ms = session.timeouts.script.max(5_000);
 
     let frame_context = script::serialize_frame_context(&session.frame_context);
-    Err(WebDriverErrorResponse::no_such_window("No such windows"))
+    let window = state
+        .app
+        .get_webview_window(&session.current_window)
+        .ok_or_else(|| {
+            WebDriverErrorResponse::no_such_window(format!(
+                "Window not found: {}",
+                session.current_window
+            ))
+        })?;
+
+    // The JavaScript bridge is platform-neutral. Each host only supplies the
+    // WebView evaluator and result transport in `platform::evaluator` (the
+    // OHOS target uses the generic Tauri bridge until an ArkWeb-native host
+    // adapter is wired in).
+    platform::evaluator::evaluate_script(
+        state,
+        window.as_ref().clone(),
+        timeout_ms,
+        script_source,
+        &args,
+        async_mode,
+        &frame_context,
+    )
+    .await
 }

src/crates/adapters/webdriver/src/runtime/mod.rs

@@ -109,3 +109,23 @@ if (!window.__bitfunWd) {{
         core_tail = core::tail()
     )
 }
+
+#[cfg(test)]
+mod tests {
+    use super::bridge_helper_script;
+
+    #[test]
+    fn bridge_includes_harmony_safe_pointer_actions() {
+        let bridge = bridge_helper_script();
+
+        for symbol in [
+            "performPointerSourceActions",
+            "performWheelSourceActions",
+            "performKeySourceActions",
+            "dispatchPointerClick",
+            "releaseActions",
+        ] {
+            assert!(bridge.contains(symbol), "missing injected symbol: {symbol}");
+        }
+    }
+}

src/crates/adapters/webdriver/src/runtime/script.rs

@@ -111,7 +111,7 @@ pub async fn create(
     let set_window_rect = cfg!(any(
         target_os = "macos",
         target_os = "windows",
-        target_os = "linux"
+        all(target_os = "linux", not(target_env = "ohos"))
     ));
 
     Ok(WebDriverResponse::success(json!({

src/crates/adapters/webdriver/src/server/handlers/session.rs

@@ -16,7 +16,6 @@ tokio-util = { workspace = true, optional = true }
 napi-ohos = { workspace = true }
 napi-derive-ohos = { workspace = true }
 tokio-stream = { workspace = true }
-tokio-util = { workspace = true }
 async-trait = { workspace = true }
 futures = { workspace = true, optional = true }