webview_flutter_android 4.3.0使用

ops/2025/2/3 6:29:18/

flutter_android_430__0">webview_flutter_android 4.3.0 使用简介

版本：适合未使用前的阅读

文档应包含以下10个核心章节：

  • 一、核心类说明
  • 二、参数类型详解
  • 三、高级配置API
  • 四、性能优化配置
  • 五、调试工具
  • 六、必要配置
  • 七、扩展功能与辅助类
  • 八、生命周期管理
  • 九、高级交互示例
  • 十、疑难解答

==================================================

一、核心类说明

==================================================

1. AndroidWebViewController 类

/// Android平台WebView的核心控制器，继承自PlatformWebViewController
/// 用于管理WebView的生命周期、配置和交互
class AndroidWebViewController {/// 构造函数/// @param params - 平台WebViewController创建参数AndroidWebViewController(PlatformWebViewControllerCreationParams params);/// 设置用户代理字符串/// @param userAgent - 要设置的UA字符串，传null则使用系统默认Future<void> setUserAgent(String? userAgent);/// 设置WebView背景颜色/// @param color - 使用Flutter的Color对象（支持透明度）Future<void> setBackgroundColor(Color color);/// 配置JavaScript执行模式/// @param mode - JavaScript模式枚举：///   - disabled: 完全禁用JS执行///   - unrestricted: 允许执行所有JS代码（包括alert等）Future<void> setJavaScriptMode(JavaScriptMode mode);/// 添加JavaScript通信通道/// @param name - 通道名称（需与JS端保持一致）/// @param onMessageReceived - 消息接收回调/// 示例：JS端调用 window.FlutterBridge.postMessage('Hello')Future<void> addJavaScriptChannel(String name, {required void Function(JavaScriptMessage) onMessageReceived,});/// 加载URL请求/// @param url - 要加载的URL地址/// @param headers - 附加的HTTP请求头（可选）Future<void> loadRequest(String url, {Map<String, String>? headers});/// 执行JavaScript代码/// @param javascript - 要执行的JS代码字符串/// @return 执行结果（可能为null）Future<String?> evaluateJavascript(String javascript);/// 清除缓存（包括内存和磁盘缓存）Future<void> clearCache();
}

2. AndroidNavigationDelegate 类

/// 处理WebView导航事件的委托类
class AndroidNavigationDelegate {/// 构造函数/// @param params - 平台导航委托创建参数AndroidNavigationDelegate(PlatformNavigationDelegateCreationParams params);/// 导航请求回调/// 参数：///   - request: 包含url和isMainFrame的导航请求对象/// 返回值：///   - NavigationDecision.navigate: 允许导航///   - NavigationDecision.prevent: 阻止导航NavigationRequestCallback onNavigationRequest;/// 页面开始加载回调/// @param url - 开始加载的URLPageStartedCallback onPageStarted;/// 页面加载完成回调/// @param url - 加载完成的URLPageFinishedCallback onPageFinished;/// 资源加载错误回调/// @param error - 包含errorCode和description的错误对象WebResourceErrorCallback onWebResourceError;
}

3. AndroidWebViewWidget 类

/// Android平台的WebView渲染组件
class AndroidWebViewWidget extends StatelessWidget {/// 构造函数/// @param controller - WebViewController实例（必须）/// @param navigationDelegate - 导航委托实例（可选）/// @param creationParams - 创建参数（可选）const AndroidWebViewWidget({required PlatformWebViewController controller,PlatformNavigationDelegate? navigationDelegate,PlatformWebViewCreationParams? creationParams,});/// 手势识别器集合/// 用于处理WebView内的手势交互（如滑动、长按等）final Set<Factory<OneSequenceGestureRecognizer>>? gestureRecognizers;/// WebView创建完成回调/// 在WebView实例化完成后触发final WebViewCreatedCallback? onWebViewCreated;/// 是否启用缩放功能/// 默认false（禁用双指缩放）final bool zoomEnabled;
}

==================================================

二、参数类型详解

==================================================

1. JavaScriptMode 枚举

/// JavaScript执行模式配置
enum JavaScriptMode {disabled,    // 完全禁用JavaScriptunrestricted // 允许执行所有JavaScript代码
}

2. NavigationRequest 类

/// 导航请求信息封装
class NavigationRequest {final String url;       // 请求的目标URLfinal bool isMainFrame; // 是否为主框架请求
}

3. WebResourceError 类

/// Web资源错误信息
class WebResourceError {final int errorCode;     // 错误代码（参考Android WebViewClient错误码）final String description;// 错误描述（英文原文）
}

==================================================

三、高级配置API

==================================================

1. AndroidWebViewCookieManager 类

/// Cookie管理工具类
class AndroidWebViewCookieManager {/// 设置Cookie/// @param cookie - WebViewCookie对象Future<void> setCookie(WebViewCookie cookie);
}/// Cookie数据结构
class WebViewCookie {final String name;   // Cookie名称final String value;  // Cookie值final String domain; // 作用域final String path;   // 路径
}

2. 文件选择器配置

/// 注册文件选择处理器
AndroidWebViewPlatform.instance.registerFileChooserHandler((FileChooserParams params) async {// 返回用户选择的文件路径列表return await FilePicker.platform.pickFiles();}
);

3. 初始化配置

/// 平台初始化配置
AndroidWebViewPlatform.instance.initialize(androidInitializationSettings: AndroidInitializationSettings(hardwareAcceleration: true,  // 启用硬件加速渲染enableHybridComposition: true, // 混合合成模式（必须为true）useTextureView: false,       // 使用SurfaceView替代TextureView)
);

==================================================

四、性能优化配置

==================================================

1. 缓存策略

AndroidWebViewPlatform.instance.setCacheMode(cacheMode: AndroidCacheMode.loadElseNetwork, // 优先使用缓存maxCacheSize: 100 * 1024 * 1024 // 最大缓存100MB
);

2. 性能监控指标

/// 可用监控指标枚举
enum AndroidPerformanceMetric {navigationTiming,  // 导航时间统计resourceTiming,    // 资源加载时间frameTiming,       // 渲染帧率
}

==================================================

五、调试工具

==================================================

/// 启用WebView内容调试（需在debug模式）
if (kDebugMode) {AndroidWebView.setWebContentsDebuggingEnabled(true);
}

==================================================

六、必要配置

==================================================

AndroidManifest.xml 权限

<!-- 必须添加以下权限 -->
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>

build.gradle 最低配置

android {compileSdkVersion 33minSdkVersion 20  // 最低支持Android 5.0...
}

==================================================

七、扩展功能与辅助类

==================================================

1. AndroidWebViewPlatform 类

/// Android平台WebView的全局配置入口
class AndroidWebViewPlatform {/// 单例实例static final instance = AndroidWebViewPlatform();/// 初始化平台设置/// @param androidInitializationSettings - Android专用初始化参数void initialize({required AndroidInitializationSettings androidInitializationSettings,});/// 注册文件选择处理器/// @param handler - 处理函数需返回文件路径列表void registerFileChooserHandler(Future<List<String>?> Function(FileChooserParams params) handler);
}

2. AndroidInitializationSettings 类

/// Android平台初始化参数配置
class AndroidInitializationSettings {final bool hardwareAcceleration; // 是否启用硬件加速（默认true）final bool enableHybridComposition; // 启用混合合成模式（必须为true）final bool useTextureView; // 使用TextureView替代SurfaceView（默认false）
}

3. FileChooserParams 类

/// 文件选择器参数封装
class FileChooserParams {final bool allowMultiple; // 是否允许多选final List<String> mimeTypes; // 允许的MIME类型
}

==================================================

八、生命周期管理

==================================================

1. WebView创建流程

  1. 初始化控制器：
   final controller = AndroidWebViewController(PlatformWebViewControllerCreationParams());
  1. 配置导航委托：
controller.navigationDelegate = AndroidNavigationDelegate(onNavigationRequest: (request) {if (!_validateUrl(request.url)) {return NavigationDecision.prevent;}return NavigationDecision.navigate;}
);
  1. 构建Widget：
AndroidWebViewWidget(controller: controller)

2. 资源释放流程

/// 在State的dispose方法中释放资源
@override
void dispose() {
controller.dispose(); // 释放控制器
_cookieManager.clear(); // 清理Cookie
super.dispose();
}

==================================================

九、高级交互示例

  1. JS与Flutter双向通信
/// Flutter端注册通道
controller.addJavaScriptChannel(
'Scanner',
onMessageReceived: (message) {
final result = await scanBarcode();
controller.evaluateJavascript('onScanResult("$result")');
}
);/// JS端调用
window.Scanner.postMessage('startScan');
  1. 自定义下载管理器
controller.navigationDelegate = AndroidNavigationDelegate(
onNavigationRequest: (request) {
if (request.url.endsWith('.apk')) {
_startDownload(request.url);
return NavigationDecision.prevent;
}
return NavigationDecision.navigate;
}
);

==================================================

十、疑难解答

  1. 混合合成模式异常
    症状：Android 10+设备白屏
    解决方案：
AndroidWebViewPlatform.instance.initialize(androidInitializationSettings: AndroidInitializationSettings(enableHybridComposition: true, // 必须启用)
);
  1. Cookie存储失效
    症状：登录状态无法保持
    解决方案：
<!-- 在AndroidManifest.xml中添加 -->
<applicationandroid:usesCleartextTraffic="true"android:allowBackup="false">
  1. 文件上传兼容性问题
    症状：部分机型无法选择文件
    解决方案：
// 在文件选择回调中处理路径转换
registerFileChooserHandler((params) async {final result = await FilePicker.platform.pickFiles();return result?.files.map((f) => f.path?.replaceFirst('file://', '')).toList();
});

==================================================

文档更新日志

补充混合合成模式配置说明

增加文件选择器路径处理示例

完善生命周期管理章节


http://www.ppmy.cn/ops/155235.html

相关文章

MongoDB 查询文档

MongoDB 查询文档

MongoDB 查询文档 引言 MongoDB 是一个功能强大的文档型数据库，它使用 JSON 格式存储数据，并提供了灵活的查询机制。本文将深入探讨 MongoDB 的查询文档，包括查询基础、查询语法、查询优化以及一些高级查询技巧。 查询基础 MongoDB 的查询语句以 find() 方法开始，它允许…
阅读更多...
Web - CSS3基础语法与盒模型

Web - CSS3基础语法与盒模型

概述 这篇文章是关于 Web 前端 CSS3 的基础语法与盒模型的讲解。包括 CSS3 层叠性及处理冲突规则、伪元素和新增伪类元素、属性选择器等。还介绍了文本与字体属性&#xff0c;如段落和行相关属性、字体文本属性。最后阐述了盒子模型&#xff0c;如元素隐藏、行内与块元素转换、…
阅读更多...
万物皆有联系：驼鸟和布什

万物皆有联系：驼鸟和布什

布什&#xff1f;一块布十块钱吗&#xff1f;不是&#xff0c;大家都知道&#xff0c;美国有两个总统&#xff0c;叫老布什和小布什&#xff0c;因为两个布什总统&#xff08;父子俩&#xff09;&#xff0c;大家就这么叫来着&#xff0c;目的是为了好区分。 布什总统的布什&a…
阅读更多...
【tiktok 国际版抖抖♬♬ __ac_signature算法】逆向分析

【tiktok 国际版抖抖♬♬ __ac_signature算法】逆向分析

一开始的参数是没有X-Bogus和 __ac_signature的 先是加密请求参数得到乱码。最终得到X-Bogus 然后请求参数添加了X-Bogus之后再去生成__ac_signature __ac_signature的生成需要用到X-Bogus
阅读更多...
二叉树-堆（补充）

二叉树-堆（补充）

二叉树-堆 1.二叉树的基本特性2.堆2.1.堆的基本概念2.2.堆的实现2.2.1.基本结构2.2.2.堆的初始化2.2.3.堆的销毁2.2.4.堆的插入2.2.5.取出堆顶的数据2.2.6.堆的删除2.2.7.堆的判空2.2.8.堆的数据个数2.2.9.交换2.2.10.打印堆数据2.2.11.堆的创建2.2.12.堆排序2.2.13.完整代码 3…
阅读更多...
利用metaGPT多智能体框架实现智能体-1

利用metaGPT多智能体框架实现智能体-1

1.metaGPT简介 MetaGPT 是一个基于大语言模型&#xff08;如 GPT-4&#xff09;的多智能体协作框架&#xff0c;旨在通过模拟人类团队的工作模式&#xff0c;让多个 AI 智能体分工合作&#xff0c;共同完成复杂的任务。它通过赋予不同智能体特定的角色&#xff08;如产品经理、…
阅读更多...
R 字符串：深入理解与高效应用

R 字符串：深入理解与高效应用

R 字符串：深入理解与高效应用 引言 在R语言中，字符串是数据处理和编程中不可或缺的一部分。无论是数据清洗、数据转换还是数据分析，字符串的处理都是基础技能。本文将深入探讨R语言中的字符串概念，包括其基本操作、常见函数以及高效应用方法。 字符串基本概念 字符串定…
阅读更多...
【云安全】云原生-K8S-搭建/安装/部署

【云安全】云原生-K8S-搭建/安装/部署

一、准备3台虚拟机 务必保证3台是同样的操作系统&#xff01; 1、我这里原有1台centos7&#xff0c;为了节省资源和效率&#xff0c;打算通过“创建链接克隆”2台出来 2、克隆之前&#xff0c;先看一下是否存在k8s相关组件&#xff0c;或者docker相关组件 3、卸载原有的docker …
阅读更多...
最新文章

Copyright @ 2022~2023