Android 配置两个 FileProvider 的详细指南

在 Android 开发中，FileProvider 是一个非常重要的组件，它允许应用以安全的方式共享文件给其他应用。通过使用 FileProvider，开发者能够通过内容 URI 安全地暴露文件，而不是直接将文件路径提供给其他应用。本文将详细介绍如何在 Android 中配置两个 FileProvider，并通过示例代码演示其使用方法。

什么是 FileProvider？

FileProvider 是一个特殊的内容提供者（ContentProvider），它允许你为文件提供分享的功能。使用 FileProvider 的主要好处是安全性，它通过使用临时的内容 URI，而不是文件路径，来防止文件的直接访问。

配置两个 FileProvider

接下来，我们将展示如何在 Android 项目中配置两个 FileProvider。

1. 在 AndroidManifest.xml 中声明 FileProvider

首先，我们需要在 AndroidManifest.xml 中声明两个 FileProvider，并为每一个提供文件的访问路径。

<manifest xmlns:android="
    package="com.example.fileproviderdemo">

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">

        <!-- 第一个 FileProvider -->
        <provider
            android:name="androidx.core.content.FileProvider"
            android:authorities="${applicationId}.fileprovider1"
            android:exported="false"
            android:grantUriPermissions="true">
            <meta-data
                android:name="android.support.FILE_PROVIDER_PATHS"
                android:resource="@xml/file_paths1" />
        </provider>

        <!-- 第二个 FileProvider -->
        <provider
            android:name="androidx.core.content.FileProvider"
            android:authorities="${applicationId}.fileprovider2"
            android:exported="false"
            android:grantUriPermissions="true">
            <meta-data
                android:name="android.support.FILE_PROVIDER_PATHS"
                android:resource="@xml/file_paths2" />
        </provider>
    </application>

</manifest>

2. 创建 file_paths.xml 文件

接下来，我们需要为两个 FileProvider 创建路径配置。在 res/xml 目录下，创建两个 XML 文件：file_paths1.xml 和 file_paths2.xml。

file_paths1.xml

这个文件定义了第一个 FileProvider 然后使用它来共享内部文件。

<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="
    <files-path name="internal_files" path="." />
</paths>
file_paths2.xml

这个文件定义了第二个 FileProvider，用于共享某个特定的外部文件。

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

3. 使用 FileProvider 共享文件

现在我们来看看如何使用这两个 FileProvider 来共享文件。

共享内部文件
File internalFile = new File(getFilesDir(), "my_internal_file.txt");
Uri internalUri = FileProvider.getUriForFile(this, BuildConfig.APPLICATION_ID + ".fileprovider1", internalFile);
Intent intent = new Intent(Intent.ACTION_SEND);
intent.setType("text/plain");
intent.putExtra(Intent.EXTRA_STREAM, internalUri);
intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
startActivity(Intent.createChooser(intent, "Share Internal File"));
共享外部文件
File externalFile = new File(Environment.getExternalStorageDirectory(), "my_external_file.txt");
Uri externalUri = FileProvider.getUriForFile(this, BuildConfig.APPLICATION_ID + ".fileprovider2", externalFile);
Intent intent = new Intent(Intent.ACTION_SEND);
intent.setType("text/plain");
intent.putExtra(Intent.EXTRA_STREAM, externalUri);
intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
startActivity(Intent.createChooser(intent, "Share External File"));

旅行图

在使用 FileProvider 的过程中，可以将其视为一场旅行，从创建文件到分享文件，整个过程中有多个节点参与。以下是用 Mermaid 语法表示的旅行图：

journey
    title 分享文件的旅行
    section 文件创建
      创建内部文件: 5: 内部存储
      创建外部文件: 4: 外部存储
    section 文件分享
      使用 FileProvider 共享内部文件: 3: FileProvider
      使用 FileProvider 共享外部文件: 3: FileProvider

关系图

在我们的应用中，FileProvider 与文件和 Intent 之间的关系可以通过下面的关系图来表示：

erDiagram
    FILE_PROVIDER {
        string id
        string authority
    }
    FILE {
        string id
        string path
    }
    INTENT {
        string action
        string type
    }
    FILE_PROVIDER ||--o{ FILE : provides
    FILE_PROVIDER ||--o{ INTENT : handles

结尾

本文详细介绍了如何在 Android 中配置两个 FileProvider，并展示了如何使用它们来共享文件。通过安全地使用 FileProvider，我们可以确保文件的共享过程安全可靠，避免了直接暴露文件路径的风险。

希望这篇文章能为你在 Android 开发中处理文件共享问题提供有效的指导。如果你对 FileProvider 或其他 Android 相关主题有任何疑问，欢迎在评论区讨论！