Android中调用代码打开.doc文件时提示离线不可用错误的问询

问题根源 #

• Uri类型不兼容：Android 7.0（API 24）及以上系统禁止使用file://格式的Uri共享文件，第三方应用无法通过这种Uri获取文件权限，进而触发“无法离线使用”的提示，甚至会抛出FileUriExposedException异常。
• MIME类型错误：.docx文件的正确MIME类型不是application/msword（这是.doc的专属类型），错误的类型会导致文档应用无法正确识别文件格式。
• 权限授予无效：FLAG_GRANT_READ_URI_PERMISSION仅对content://格式的Uri生效，file://Uri下该权限标记无法让第三方应用获得文件读取权限。

解决步骤 #

1. 注册FileProvider

在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>

2. 创建File路径配置文件

在res/xml目录下新建file_paths.xml（无xml目录则手动创建），配置文件的存储路径（示例为外部存储根目录，可根据实际存储位置调整）：

<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <external-path name="external_files" path="." />
</paths>

常用路径配置说明：

• <files-path>：对应应用内部存储的/data/data/包名/files/目录
• <external-path>：对应外部存储根目录
• <external-files-path>：对应应用外部存储的/Android/data/包名/files/目录

3. 修改打开文件的代码

File targetFile = ...; // 替换为你的目标文件对象
Intent viewIntent = new Intent(Intent.ACTION_VIEW);
Uri fileUri;

// 根据系统版本选择Uri生成方式
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
    // Android7.0+用FileProvider生成content://Uri
    fileUri = FileProvider.getUriForFile(activity, activity.getPackageName() + ".fileprovider", targetFile);
    // 授予读写权限给目标应用
    viewIntent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION | Intent.FLAG_GRANT_WRITE_URI_PERMISSION);
} else {
    // 低版本直接使用file://Uri
    fileUri = Uri.fromFile(targetFile);
}

// 设置正确的MIME类型
String mimeType;
if (targetFile.getName().endsWith(".docx")) {
    mimeType = "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
} else if (targetFile.getName().endsWith(".doc")) {
    mimeType = "application/msword";
} else {
    mimeType = "*/*"; // 未知类型，让系统自动识别
}

viewIntent.setDataAndType(fileUri, mimeType);
viewIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);

// 检查是否有可处理该Intent的应用，避免崩溃
if (viewIntent.resolveActivity(activity.getPackageManager()) != null) {
    activity.startActivity(viewIntent);
} else {
    Toast.makeText(activity, "未找到可打开文档的应用", Toast.LENGTH_SHORT).show();
}

关键注意事项 #

• 确保FileProvider的authorities参数与getUriForFile方法的第二个参数完全一致，推荐使用${applicationId}避免包名冲突。
• 若文件存储在特定目录，需调整file_paths.xml中的路径配置，确保FileProvider能访问到目标文件。
• 必须添加resolveActivity检查，防止因无对应应用而引发崩溃。

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