Flutter使用android_intent_plus打开本地PDF报错如何解决

你遇到的ActivityNotFoundException是多个配置错误共同导致的：

• Intent Action常量值写错：你用的android.os.Intent.ACTION_VIEW是错误值，系统可识别的View Action正确值为android.intent.action.VIEW
• 传入的Uri格式非法：直接传裸文件路径，没有加Uri Scheme（既不是file://也不是Android 7.0+要求的content://格式），系统无法解析该地址
• 未适配高版本安卓文件访问规则：API 24及以上系统禁止直接向第三方应用暴露file://格式的文件Uri，必须通过FileProvider生成带临时授权的content://格式Uri，否则会触发FileUriExposedException
• 未指定文件MIME类型：系统无法根据无类型的Uri匹配能处理PDF的应用，即使路径正确也可能找不到对应Activity
• 冗余权限flag：你添加的FLAG_GRANT_PERSISTABLE_URI_PERMISSION是用于持久化Uri授权的，临时打开文件不需要这个flag，容易触发权限异常

1. 配置安卓端FileProvider #

首先在android/app/src/main/AndroidManifest.xml的<application>节点内添加FileProvider配置：

<provider
    android:name="androidx.core.content.FileProvider"
    android:authorities="${applicationId}.fileprovider"
    android:exported="false"
    android:grantUriPermissions="true">
    <meta-data
        android:name="android.support.FILE_PROVIDER_PATHS"
        android:resource="@xml/file_paths" />
</provider>

然后在android/app/src/main/res/下新建xml目录，在目录内创建file_paths.xml文件，添加Download目录访问授权：

<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <!-- 授权访问公共Download目录 -->
    <external-path name="download_dir" path="Download/" />
</paths>

2. 配置必要权限 #

根据应用的targetSdk版本添加对应权限，在AndroidManifest.xml的<manifest>节点下添加：

• 若targetSdk <= 32：添加<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
• 若targetSdk >= 33，需要访问非本应用创建的Download文件时，添加<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" />，并在运行时引导用户开启所有文件访问权限

3. 修正Dart层代码 #

替换原有错误的Intent逻辑，注意替换authority字段的包名为你自己应用的实际包名：

import 'dart:io';
import 'package:android_intent_plus/android_intent.dart';
import 'package:android_intent_plus/flag.dart';

Future<void> openPdfInDownload() async {
  final file = File("/storage/emulated/0/Download/myfile.pdf");
  // 先判断文件是否存在
  if (!await file.exists()) {
    print("目标PDF文件不存在");
    return;
  }

  try {
    final AndroidIntent intent = AndroidIntent(
      action: 'android.intent.action.VIEW', // 修正Action值
      // 设置content格式的Uri，authority必须和Manifest中配置的一致
      data: Uri(
        scheme: 'content',
        authority: '替换为你的应用包名.fileprovider', // 比如com.example.demo.fileprovider
        path: '/download_dir/myfile.pdf', // 对应file_paths.xml里配置的name值+文件名
      ).toString(),
      type: 'application/pdf', // 指定PDF对应的MIME类型
      flags: [
        Flag.FLAG_GRANT_READ_URI_PERMISSION,
        Flag.FLAG_ACTIVITY_NEW_TASK,
      ], // 移除不需要的持久化权限flag
    );
    await intent.launch();
  } catch (e) {
    // 捕获该异常一般是设备未安装PDF阅读器，此时可以弹窗提示用户安装
    print("打开PDF失败：$e");
  }
}

• 测试前确认设备上已经安装至少一款可以打开PDF的应用（比如WPS、系统自带PDF阅读器），没有对应应用时也会抛出找不到Activity的错误
• FileProvider的authority值必须和Manifest中配置的完全一致，否则会触发权限拒绝错误
• 如果是打开应用自身创建在Download目录的文件，不需要申请额外存储权限，系统默认授予应用对自身创建文件的访问权

内容的提问来源于stack exchange，提问作者Ariel Soriano Vassia