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

Android

Android 由 webview_all_android '>=1.4.12 <1.5.0' 提供,webview_all 将它注册为默认 Android 实现。

项值
平台包webview_all_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 功能。
setWebAuthenticationSupport为已关联应用或具备资格的浏览器应用启用 WebAuthn。
setPaymentRequestEnabled开启 Payment Request API。
setInsetsForWebContentToIgnore控制传给网页的 window insets。
await (controller.platform as AndroidWebViewController)
.setMixedContentMode(MixedContentMode.neverAllow);

neverAllow 是生产环境推荐值。

Android WebView 默认关闭 WebAuthn。启用前必须先检查当前设备与 WebView 版本是否支持:

final android = controller.platform as AndroidWebViewController;
if (await android.isWebViewFeatureSupported(
WebViewFeatureType.webAuthentication,
)) {
await android.setWebAuthenticationSupport(
WebAuthenticationSupport.forApp,
);
}

forApp 是普通应用应使用的模式,并且必须通过 Digital Asset Links 关联应用与 relying-party 域名。forBrowser 只适用于经凭据提供方 批准、可代表第三方站点请求凭据的特权浏览器应用,普通应用不应使用它绕过 域名关联。none 用于关闭功能,也是 AndroidX WebKit 的默认值。

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

FileSelectorMode 包括 open、openMultiple 和 save。

getCookies 先按分号拆分,再只按每条 Cookie 的第一个等号拆分,因此能保留 值中的 = 和编码内容。非法百分号编码会按原文返回,不会让整次查询失败;结果 使用请求 URL 的 host 和 /。

Android native 代码可通过 WebViewFlutterAndroidExternalApi 的 FlutterPluginBinding 入口获取插件持有的 WebView;旧 FlutterEngine 重载保留但已弃用。binding 入口使用 engine plugin registry 实现,因此仍兼容 Flutter 3.35。

  • Android WebView postUrl 不支持 POST 自定义 headers。
  • grant() WebView 权限不等于系统运行时权限,宿主应用仍需自己请求。
  • Payment Request 取决于 AndroidX WebKit、系统 WebView/Chrome 版本和 manifest queries。
  • WebAuthn 取决于 AndroidX WebKit、系统 WebView 版本和正确的应用-站点关联; 未通过功能检查就调用设置接口可能产生不支持错误。
  • Android 插件会根据宿主工程的 Android Gradle Plugin 选择 Kotlin 集成方式: AGP 8 及以下使用 Kotlin Gradle Plugin,AGP 9 及以上使用 Built-in Kotlin, 从而兼容旧版 Flutter 工程并避免与新版 Android 构建冲突。