Cordova使用file-opener2打开文件遇Android权限报错求助

这个错误的核心原因是Android 7.0（API Level 24）及以上版本的StrictMode安全政策：应用不能直接通过file:// URI向外部应用（比如PDF阅读器）暴露私有文件，必须使用content:// URI通过FileProvider来安全共享文件。下面是具体的分步解决方案：

1. 确保使用最新版的cordova-plugin-file-opener2 #

首先把插件更新到支持FileProvider的版本（至少v2.2.0+）：

cordova plugin rm cordova-plugin-file-opener2
cordova plugin add cordova-plugin-file-opener2

2. 配置FileProvider到你的Cordova项目 #

在config.xml中添加Android平台专属配置，完成FileProvider的注册：

<platform name="android">
    <!-- 复制FileProvider路径配置文件到项目目录 -->
    <resource-file src="resources/android/xml/file_paths.xml" target="app/src/main/res/xml/file_paths.xml" />
    
    <!-- 在AndroidManifest.xml中注册FileProvider组件 -->
    <config-file parent="/manifest/application" target="AndroidManifest.xml">
        <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>
    </config-file>
</platform>

接着在项目中创建resources/android/xml/file_paths.xml文件，定义FileProvider可以访问的文件路径范围：

<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <files-path name="files" path="." /> <!-- 应用私有files目录 -->
    <external-files-path name="external_files" path="." /> <!-- 应用外部files目录 -->
    <cache-path name="cache" path="." /> <!-- 应用私有cache目录 -->
</paths>

3. 修改代码适配FileProvider逻辑 #

调整下载路径为Cordova提供的标准路径，同时让fileOpener2自动处理URI转换：

// 使用cordova-plugin-file提供的标准路径，避免手动写cdvfile路径
var downloadPath = cordova.file.dataDirectory + 'test.pdf';

var fileTransfer = new FileTransfer();
fileTransfer.download(
  encodeURI('http://rp.delaat.net/2014-2015/p75/report.pdf'),
  downloadPath,
  function (entry) {
    var fileUrl = entry.toURL();
    window.cordova.plugins.fileOpener2.open(
      fileUrl,
      'application/pdf',
      {
        error: function (error) {
          console.error('打开文件失败:', error);
        },
        success: function () {
          console.log('文件打开成功');
        },
        // 可选：如果文件存储在外部目录，开启这个参数更稳妥
        useExternalFilesDir: true
      }
    );
  },
  function (error) {
    console.error('下载失败:', error);
  }
);

额外适配说明 #

• 若目标Android版本为10+（API Level 29），需要在config.xml中添加兼容配置，避免Scoped Storage限制：

  <platform name="android">
      <edit-config file="AndroidManifest.xml" mode="merge" target="/manifest/application">
          <application android:requestLegacyExternalStorage="true" />
      </edit-config>
  </platform>
  

• 确保已安装cordova-plugin-file（file-transfer插件依赖它），未安装则执行：

  cordova plugin add cordova-plugin-file
  

内容的提问来源于stack exchange，提问作者M. Suurland