跳转到内容
WebView AllWebView All

Android

Android 由 webview_all_android ^1.5.2 提供,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。

System WebView 支持 GET_COOKIE_INFO 时,getCookies 返回原生 domain/path、 过期时间及安全属性,缺失的 SameSite 保留为未知。旧版内核只返回名称和值, domain/path 使用请求 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 构建冲突。

以下 Android 扩展自 1.5.1 提供,返回值表示设置是否成功:

final android = controller.platform as AndroidWebViewController;
await android.setAlgorithmicDarkeningAllowed(true);
await android.setDomStorageEnabled(false);
await android.setCacheMode(AndroidWebViewCacheMode.noCache);

请在加载网页前设置。算法暗化取决于应用的原生主题和网页自身样式,不会强制 所有网页变暗或注入 CSS。不支持的内核或 target SDK 低于 33 时返回 false 并打印原因,不使用旧 forceDark 接口替代。

DOM 存储默认开启;关闭后不删除已有数据,也不隔离 Cookie,重新开启后仍可 访问之前保存的数据。

缓存模式包括 defaultMode(遵循 HTTP 缓存策略)、cacheElseNetwork (优先已有缓存,包括过期内容)、noCache(不读缓存)和 cacheOnly (仅缓存,未命中时失败)。Service Worker 自己维护的缓存不由此设置控制。 有限无痕视图只接受 noCache,其他模式返回 false 并保留原策略。 需要删除数据时使用网站数据管理接口。