Flutter Webview网页文件下载无响应问题技术咨询
解决方案
1. 为什么flutter_webview_plugin无法触发下载
flutter_webview_plugin早已停止维护,原生层未实现下载相关的事件监听逻辑,遇到Content-Disposition: attachment类型的响应不会将事件传递到Flutter层,因此点击下载按钮无响应是预期现象,不建议继续使用该包。
2. flutter_inappwebview下载监听未触发的修复方案
建议使用5.0.0以上的稳定版flutter_inappwebview,按以下步骤配置即可正常触发下载监听:
2.1 提前配置平台权限
- 安卓端:在
android/app/src/main/AndroidManifest.xml中添加存储、通知权限<!-- 安卓12及以下存储权限 --> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> <!-- 安卓13及以上权限 --> <uses-permission android:name="android.permission.READ_MEDIA_IMAGES" /> <uses-permission android:name="android.permission.READ_MEDIA_VIDEO" /> <uses-permission android:name="android.permission.POST_NOTIFICATIONS" /> - iOS端:在
ios/Runner/Info.plist中添加存储权限说明<key>NSDocumentDirectoryUsageDescription</key> <string>需要存储权限保存下载文件</string>
2.2 正确注册下载监听回调
注意不要使用已废弃的onDownloadStart回调,需使用新版onDownloadStartRequest监听,示例代码如下:
InAppWebView( initialUrlRequest: URLRequest(url: Uri.parse("你的网页地址")), // 下载监听回调 onDownloadStartRequest: (controller, downloadStartRequest) async { // 这里拿到下载请求的所有信息,包括url、文件名、文件类型等 String downloadUrl = downloadStartRequest.url.toString(); String? fileName = downloadStartRequest.suggestedFilename; // 方案1:调用系统浏览器下载,适配成本最低 // 需提前引入url_launcher包 // if (await canLaunchUrl(Uri.parse(downloadUrl))) { // await launchUrl(Uri.parse(downloadUrl)); // } // 方案2:配合flutter_downloader包实现应用内下载 // 需提前引入flutter_downloader包并做初始化配置 // await FlutterDownloader.enqueue( // url: downloadUrl, // savedDir: '你的本地存储目录', // fileName: fileName, // showNotification: true, // openFileFromNotification: true, // ); }, )
2.3 特殊场景兼容
如果前端使用Blob动态生成下载链接的场景没有触发下载监听,可额外添加资源请求拦截逻辑,判断响应头为下载类型时手动触发下载:
onLoadResource: (controller, resource) async { if (resource.response?.headers?.value("Content-Disposition")?.contains("attachment") == true) { // 手动调用下载逻辑 String downloadUrl = resource.url.toString(); // 后续处理逻辑同上 } }
内容的提问来源于stack exchange,提问作者Jashwanth Neela
相关产品推荐
相关产品推荐

