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

Linux

Linux 由 webview_all_linux 1.2.1 提供,底层使用 WebKitGTK。

项值
ControllerLinuxWebViewController
WidgetLinuxWebViewWidget
DelegateLinuxNavigationDelegate
Cookie managerLinuxWebViewCookieManager
引擎WebKitGTK
系统依赖webkit2gtk-4.1

Linux WebView 是 native GTK widget,需要 GtkOverlay 与 Flutter view 共享窗口。完整代码见平台设置。

final params = const LinuxWebViewControllerCreationParams(
developerExtrasEnabled: true,
mediaPlaybackRequiresUserGesture: false,
pageCacheEnabled: true,
allowFileAccessFromFileUrls: false,
allowUniversalAccessFromFileUrls: false,
zoomFactor: 1.0,
);

所有字段都可为 null,表示保留 WebKitGTK 默认值。

API作用
setDeveloperExtrasEnabled启用开发者功能。
openDevTools打开 Web Inspector。
setJavaScriptCanOpenWindowsAutomatically控制 JS popup。
setMediaPlaybackRequiresUserGesture控制媒体自动播放。
setMediaPlaybackAllowsInline控制内联媒体播放。
setPageCacheEnabled控制 page cache。
setAllowFileAccessFromFileUrls允许 file 页面读其他 file URL。
setAllowUniversalAccessFromFileUrls允许 file 页面访问所有 origin。
setDefaultFontSize / setMinimumFontSize字号设置。
setZoomFactor页面缩放。
dispose释放 native WebView。

Linux 通过 event channel 上报 URL、页面生命周期、进度、history、title、资源错误、HTTP 错误、JS channel、console、scroll、导航请求、HTTP auth、SSL auth、权限请求和 JS dialog。

  • WebView 是 GTK 原生 widget,层叠和裁剪遵循 GTK overlay 行为。
  • 不可信本地文件不要启用 universal file URL access。
  • 不同发行版 WebKitGTK 版本差异明显,媒体、权限和 dialog 需要在目标发行版验证。