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

Android

Android 由 webview_flutter_android ^4.12.0 提供,webview_all 将它注册为默认 Android 实现。

项值
平台包webview_flutter_android
ControllerAndroidWebViewController
WidgetAndroidWebViewWidget
DelegateAndroidNavigationDelegate
Cookie managerAndroidWebViewCookieManager
引擎Android WebView
最低要求API 24+
API作用
AndroidWebViewController.enableDebugging全局启用 WebView 调试。
setAllowFileAccess控制 file URL 访问。
setMediaPlaybackRequiresUserGesture控制媒体自动播放。
setTextZoom设置文字缩放百分比。
setUseWideViewPort启用 viewport meta/wide viewport。
setAllowContentAccess控制 content:// 访问。
setGeolocationEnabled启用定位。
setOnShowFileSelector处理 <input type="file">。
setGeolocationPermissionsPromptCallbacks处理 Geolocation API 提示。
setCustomWidgetCallbacks处理视频等全屏 custom view。
setMixedContentMode控制 HTTPS 页面加载 HTTP 内容。
isWebViewFeatureSupported查询 AndroidX WebView 功能。
setPaymentRequestEnabled开启 Payment Request API。
setInsetsForWebContentToIgnore控制传给网页的 window insets。
await (controller.platform as AndroidWebViewController)
.setMixedContentMode(MixedContentMode.neverAllow);

neverAllow 是生产环境推荐值。

await (controller.platform as AndroidWebViewController)
.setOnShowFileSelector((FileSelectorParams params) async {
return <String>['/sdcard/Download/file.png'];
});

FileSelectorMode 包括 open、openMultiple 和 save。

  • Android WebView postUrl 不支持 POST 自定义 headers。
  • grant() WebView 权限不等于系统运行时权限,宿主应用仍需自己请求。
  • Payment Request 取决于 AndroidX WebKit、系统 WebView/Chrome 版本和 manifest queries。