跳转到内容
WebView AllWebView All
这是 1.2.x 版本的文档,最新接口请切换至 latest。

OHOS

OHOS 由 webview_all_ohos 1.2.1 提供,底层使用 ArkWeb。

项值
ControllerOhosWebViewController
WidgetOhosWebViewWidget
DelegateOhosNavigationDelegate
Cookie managerOhosWebViewCookieManager
引擎ArkWeb
最低目标OHOS API 12+
final params = OhosWebViewControllerCreationParams(
domStorageEnabled: true,
javaScriptCanOpenWindowsAutomatically: true,
supportMultipleWindows: true,
loadWithOverviewMode: true,
useWideViewPort: true,
allowFileAccess: true,
mediaPlaybackRequiresUserGesture: false,
supportZoom: true,
textZoom: 100,
);
API作用
OhosWebViewController.enableDebugging全局启用 ArkWeb 调试。
webViewIdentifier原生 WebView 实例 ID。
setAllowFullScreenRotate控制全屏旋转。
setDomStorageEnabled控制 DOM storage。
setSupportMultipleWindows控制多窗口。
setLoadWithOverviewMode / setUseWideViewPort视口相关设置。
setDisplayZoomControls / setBuiltInZoomControls缩放控件。
setAllowFileAccessfile access。
setOnShowFileSelector文件选择。
setGeolocationPermissionsPromptCallbacks定位提示。
setCustomWidgetCallbacks全屏 custom view。
请求支持
GET 无 headers支持。
GET 自定义 headers支持。
POST 无自定义 headers支持。
POST 自定义 headers不支持,抛 UnsupportedError。

ArkWeb postUrl 只接收 URL 和 body,不接收 headers,因此库明确失败。

OHOS 支持 camera、microphone,并扩展 midiSysex、protectedMediaId。

await (WebViewCookieManager().platform as OhosWebViewCookieManager)
.setAcceptThirdPartyCookies(
controller.platform as OhosWebViewController,
true,
);
  • WebView 权限批准不等于系统权限,宿主应用仍需声明并获取权限。
  • ArkWeb 行为可能随 HarmonyOS/OpenHarmony 版本变化,尤其是媒体、文件选择和权限。