Android开发-在应用之间共享文件

難釋懷
340 阅读3分钟

在Android应用开发中，跨应用共享文件是一项常见且重要的需求。例如，用户希望将某个图片、PDF或文档从你的应用发送到微信、QQ、邮件客户端等第三方应用进行查看或上传时，就需要用到文件的跨应用共享功能。

然而，由于Android系统的安全机制（如沙箱隔离和路径限制），直接暴露文件路径已经不再被允许。本文将详细介绍如何在Android中安全地实现应用间文件共享，重点介绍使用 FileProvider 的方式，并提供完整代码示例。

一、为什么不能直接传递文件路径？

从 Android 7.0（API 24）开始，系统引入了 FileUriExposedException 异常机制，禁止将 file:// 类型的 Uri 暴露给其他应用，这是为了防止恶意应用通过文件路径访问敏感数据。

因此，如果你尝试这样启动一个Intent：

Intent intent = new Intent(Intent.ACTION_VIEW);
intent.setDataAndType(Uri.fromFile(file), "application/pdf");
startActivity(intent);

在 Android 7.0 及以上设备上会抛出异常：

android.os.FileUriExposedException: file:///... exposed beyond app through Intent.getData()

解决方法是使用 FileProvider 来生成一个内容 URI（content://），从而安全地共享文件。

二、什么是 FileProvider？

FileProvider 是 Android 提供的一个特殊的 ContentProvider 子类，用于帮助你在不同应用之间安全地共享文件。它不会暴露真实的文件路径，而是通过授权的方式为文件生成一个临时的 content:// Uri。

三、使用 FileProvider 实现跨应用文件共享

步骤1：添加权限声明（Manifest）

在 AndroidManifest.xml 文件中注册 FileProvider 并声明读写权限：

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"
    android:maxSdkVersion="28"/> <!-- 仅适用于Android 9及以下 -->

<application>
    <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>
</application>

注意：android:authorities 推荐使用 ${applicationId}.fileprovider 这种形式来保证唯一性。

步骤2：定义 FileProvider 路径配置（XML）

在 res/xml/ 目录下创建一个名为 file_paths.xml 的文件（如果目录不存在请手动创建）：

<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <!-- 允许共享外部存储根目录下的文件 -->
    <external-path name="external_files" path="." />

    <!-- 允许共享应用私有目录中的文件 -->
    <files-path name="files" path="." />

    <!-- 允许共享缓存目录中的文件 -->
    <cache-path name="cache" path="." />

    <!-- 允许共享特定子目录（如Downloads） -->
    <external-files-path name="downloads" path="Download/" />
</paths>

你可以根据实际需要选择开放哪些路径。

步骤3：生成 content:// Uri 并传递文件

File file = new File(Environment.getExternalStoragePublicDirectory(
        Environment.DIRECTORY_DOWNLOADS), "example.pdf");

Uri contentUri = FileProvider.getUriForFile(this,
        getPackageName() + ".fileprovider", file);

Intent intent = new Intent(Intent.ACTION_VIEW);
intent.setDataAndType(contentUri, "application/pdf");
intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION); // 授予临时读取权限

try {
    startActivity(intent);
} catch (ActivityNotFoundException e) {
    Toast.makeText(this, "没有可以打开该文件的应用", Toast.LENGTH_SHORT).show();
}

这段代码的作用是：

  • 使用 FileProvider 生成 content Uri；
  • 启动一个 ACTION_VIEW Intent；
  • 将 Uri 传递给支持 PDF 阅读的第三方应用。

四、适配 Android 10 及以上（Scoped Storage）

从 Android 10 开始，Google 推出了 Scoped Storage（作用域存储），进一步限制对公共目录的直接访问。

对于文件共享场景，推荐的做法是：

  • 使用 MediaStore API 或 Storage Access Framework（SAF）让用户选择文件；
  • 如果必须操作文件路径，请申请 MANAGE_EXTERNAL_STORAGE 权限（适用于特殊场景，需审核）；
  • 继续使用 FileProvider 安全分享已有的文件。

五、最佳实践与注意事项

建议说明
✅ 使用 FileProvider 生成 Uri避免暴露真实文件路径，提升安全性
✅ 添加 FLAG_GRANT_READ_URI_PERMISSION确保目标应用能正常读取文件
❌ 不要硬编码文件路径如 /sdcard/xxx，应使用系统API获取
✅ 在 Android 10+ 使用 SAF 或 MediaStore更符合现代Android的文件访问规范
✅ 处理无匹配应用的情况如提示“未找到可用应用”

六、结语

感谢您的阅读！如果你有任何疑问或想要分享的经验，请在评论区留言交流！

avatar
文章
阅读
粉丝