Android多媒体功能开发(2)——FileProvider

使用系统多媒体界面需要在我们的应用和其他应用之间通过Intent传递音频、图片、视频文件的信息。随着Android版本的升级，对应用数据安全性方面的限制越来越多。

Android 6以后不允许应用在外部存储随便创建目录，只能在Android规定的应用自己的文件目录下创建目录，该目录可以用方法getExternalFilesDir(null)来获得，其实际位置为：

        Android/data/<package-name>/files/

Android 7以前的版本可以直接使用“file://”格式的uri在应用之间传递文件信息，格式为：

        file:// + <路径> + <文件>

例如：file:///storage/emulated/0/Android/data/com.zzk.a1501systemactivity/files/test/audio.acc

Android 7及更高版本使用了更严格的文件分享模式，禁止开发人员在应用外部以 “file://”格式的uri分享应用自己目录下的文件，否则会出现 FileUriExposedException 异常。如果需要向其他应用公开应用自己目录下的文件，需要使用FileProvider。

FileProvider是ContentProvider的一种，格式为：

        content:// + <FileProvider名>+<路径别名>+<文件>

由于采用别名代替了实际路径，避免了直接暴露文件位置，所以更加安全。例如：

        content://com.zzk.a1501systemactivity.fileProvider/testdir/audio.aac

使用FileProvider向其他应用传递文件需要以下步骤：

1. 声明FileProvider
2. 编写一个xml文件，列出共享目录和别名
3. 生成Content URI
4. 授予对方应用访问权限
5. 提供Content URI给其他应用

下面我们具体解释一下这几个步骤。

FileProvider需要在应用配置文件AndroidManifest中声明，和ContentProvider的声明类似。例如： 

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

声明中name属性为FileProvider对应的Java类（androidx.core.content.FileProvider），已经在Android库中存在，不用自己编写。authories一般采用应用包名+“.fileProvider”保证唯一性。meta-data中的FILE_PROVIDER_PATHS指定一个名为file_paths.xml的文件，在该文件中声明要传递的文件所在路径的别名。这个xml文件位于res/xml/目录下，内容类似于：

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

这里声明了一个testdir，实际对应的路径为external-files-path代表的 /Android/data/com.zzk.a1501systemactivity/files/ 路径下的test目录。

除了<external-files-path>标签外，还可以使用下面的标签：

• <root-path>: 设备根目录/
• <files-path>: context.getFilesDir()的目录
• <cache-path>:context.getCacheDir()的目录
• <external-path>:Environment.getExternalStorageDirectory()的目录
• <external-files-path>:ContextCompat.getExternalFilesDirs()下标为0的目录
• <external-cache-path>:ContextCompat.getExternalCacheDirs()下标为0的目录
• <external-media-path>:context.getExternalMediaDirs()下标为0的目录

接下来是生成Content URI，需要使用 FileProvider 类提供的公有静态方法 getUriForFile 生成 Content URI。比如：

Uri uri = FileProvider.getUriForFile(MainActivity.this, fileProviderAuthority, audioFile);

getUriForFile方法的第一个参数是上下文；第二个参数是FileProvider的authorities，需要和配置文件中声明FileProvider时给出的定义（android:authorities="${applicationId}.fileProvider"）相同，一般采用“<应用包名>.fileProvider”以保证唯一性。第三个参数是要传递的文件。

接下来就可以把该uri放到Intent中，再授予对方读/写权限，就可以传递给其他应用使用了。示例代码如下：

Intent intent = new Intent(Intent.ACTION_VIEW);     //  创建intent
intent.setDataAndType(uri, "audio/*");     //  把文件的Content URI放入intent
intent.setFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION); //  授予对方读取文件的权限
startActivity(intent);  //  传递给其他应用