Flutter项目中FileReaderView仅Android平台引擎加载失败求助

排查与修复步骤 #

1. 检查依赖版本与配置 #

• 确保pubspec.yaml中flutter_filereader使用最新稳定版，避免版本兼容问题：

  dependencies:
    flutter_filereader: ^最新稳定版本号
  

• 执行flutter pub get重新拉取依赖。

2. 配置Android文件访问权限 #

• 在android/app/src/main/AndroidManifest.xml中添加必要权限：

  <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
  <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="32"/>
  <!-- Android 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.READ_MEDIA_AUDIO"/>
  

• 运行时主动申请权限，可借助permission_handler包实现：

  import 'package:permission_handler/permission_handler.dart';
  
  Future<void> requestFilePermissions() async {
    var storageStatus = await Permission.storage.request();
    if (storageStatus.isDenied) {
      // 提示用户前往设置开启权限
    }
    // Android 13+ 处理管理外部存储权限
    if (await Permission.manageExternalStorage.isDenied) {
      await Permission.manageExternalStorage.request();
    }
  }
  

  进入FileViewerScreen前调用该方法获取权限。

3. 验证文件路径有效性 #

• 确认传入的filePath为绝对路径且文件真实存在：

  import 'dart:io';
  
  // 在构建FileReaderView前添加验证逻辑
  if (!await File(widget.filePath).exists()) {
    return const Center(child: Text("目标文件不存在"));
  }
  

• 避免使用相对路径或系统限制访问的临时目录路径。

4. 配置Android项目基础参数 #

• 检查android/app/build.gradle中minSdkVersion是否≥21（该库最低要求SDK版本为21）：

  defaultConfig {
      minSdkVersion 21
      // 其他配置项...
  }
  

• 确认项目已包含该库所需的so文件，若缺失可手动从包的Android目录复制到android/app/src/main/jniLibs目录下。

5. 清理缓存并重建项目 #

• 执行以下命令清理项目缓存后重新构建：

  flutter clean
  flutter pub get
  cd android && ./gradlew clean && cd ..
  flutter run
  

补充排查方向 #

若上述步骤无效，可尝试：

• 测试不同格式的文件（如PDF、DOCX），排除特定格式的兼容问题；
• 通过adb logcat查看Android端详细日志，定位引擎加载失败的具体报错信息。

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