Flutter中如何通过flutter_inappwebview下载.ics文件？

flutter_inappwebview默认会直接在WebView内打开.ics这类文件，而非触发下载。要实现将文件保存到设备的功能，你需要拦截下载请求并手动处理文件保存流程，具体操作如下：

1. 准备依赖 #

确保pubspec.yaml中添加了所需依赖：

dependencies:
  flutter_inappwebview: ^6.0.0 # 使用最新稳定版
  path_provider: ^2.0.0
  dio: ^5.0.0 # 也可替换为http库，dio对下载场景支持更友好

2. 拦截.ics文件的下载请求 #

在InAppWebView组件中配置onDownloadStartRequest回调，识别并拦截.ics文件的下载请求：

InAppWebView(
  initialUrlRequest: URLRequest(url: Uri.parse("你的目标网页URL")),
  onDownloadStartRequest: (controller, downloadStartRequest) async {
    // 判断请求是否指向.ics文件
    if (downloadStartRequest.url.path.endsWith(".ics")) {
      // 触发手动下载逻辑
      await _handleIcsDownload(downloadStartRequest.url.toString());
    }
  },
)

3. 实现文件下载与保存 #

编写下载方法，将文件保存到设备的指定目录：

import 'dart:io';
import 'package:path_provider/path_provider.dart';
import 'package:dio/dio.dart';

Future<void> _handleIcsDownload(String fileUrl) async {
  final dio = Dio();
  Directory? saveDirectory;

  // 根据平台获取存储目录
  if (Platform.isAndroid) {
    saveDirectory = await getExternalStorageDirectory();
    // 指定到系统Download文件夹
    saveDirectory = Directory("${saveDirectory!.path}/Download");
  } else if (Platform.isIOS) {
    saveDirectory = await getApplicationDocumentsDirectory();
  }

  if (saveDirectory == null) return;

  // 创建目录（不存在则自动生成）
  await saveDirectory.create(recursive: true);

  // 从URL提取文件名，或自定义文件名
  final fileName = fileUrl.split("/").last;
  final savePath = "${saveDirectory.path}/$fileName";

  try {
    await dio.download(fileUrl, savePath);
    // 可选：下载完成后提示用户，可使用fluttertoast等组件
    // Fluttertoast.showToast(msg: "文件已保存至: $savePath");
  } catch (e) {
    print("下载失败: $e");
    // 可选：提示用户下载失败
  }
}

4. Android权限配置 #

在AndroidManifest.xml中添加存储权限：

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

针对Android 13及以上版本，需适配新的媒体权限，可添加READ_MEDIA_IMAGES等权限（根据需求调整）。

5. iOS可选配置（让文件可被系统访问） #

若希望用户能通过系统"文件"应用查看下载的.ics文件，在Info.plist中添加：

<key>UIFileSharingEnabled</key>
<true/>
<key>LSSupportsOpeningDocumentsInPlace</key>
<true/>

完成以上配置后，WebView中触发的.ics文件请求会自动保存到设备指定目录，而非直接打开。

内容的提问来源于stack exchange，提问作者Snof