一、前言
从 Android 7.0 开始，安卓系统不允许在应用间使用 file:// 形式的 Uri，来传递一个 FIle，否则就会抛出 FileUriExposedException 异常，因为安卓出于以下原因考虑：
- 接收方 app 可能没有申请
Manifest.permission.READ_EXTERNAL_STORAGE权限，从而导致崩溃
那么我们如果在应用间传递一个文件呢？
官方给出了解决方案，就是使用 content:// 形式的 Uri 来使接收方 app 获得临时权限。
虽然只有在 Android 7.0 以上的系统才会抛出异常，但是还是强烈建议不要使用 file:// 的形式来传递文件
二、使用 FileProvider
FileProvider 是 ContentProvider 的子类，它提供更高级别的文件访问安全性，是 Android 安全基础结构的关键部分。
在 app 开发过程中需要用到 FileProvider 的场景有使用相机拍照、图片裁剪。
通过以下步骤来使用 FileProvider：
-
定义 FileProvider
-
指定可共享的文件
-
生成 content:// 形式的 Uri
-
授予 Uri 临时权限
-
向另一个应用提供 content:// 形式的 Uri
定义 FileProvider
- 在 Manifest.xml 中增加 <provider> 标签
-
android:name固定都写androidx.core.content.FileProvider -
android:authorities设为包名.fileprovider，例如com.mydomain.fileprovider -
android:exported固定都写false -
android:grantUriPermissions固定都写true，来为文件授予临时访问权限
完整示例如下：
<manifest>
...
<application>
...
<provider
android:name="androidx.core.content.FileProvider"
android:authorities="com.mydomain.fileprovider"
android:exported="false"
android:grantUriPermissions="true">
...
</provider>
...
</application>
</manifest>
如果你需要自定义 FileProvider，那么就将 android:name 标签设为自己 FileProvider 的完整目录，比如 support 包就为 android.support.v4.content.FileProvider
指定可共享的文件
FileProvider 只能为预先指定过目录的文件生成 content:// 形式的 Uri。要指定目录，需要在 xml 格式的文件中使用 <paths> 标签来指定其存储路径，例如：
<paths xmlns:android="http://schemas.android.com/apk/res/android">
<files-path name="my_images" path="images/"/>
</paths>
解释一下：
- file-path，等同于
Context.getFilesDir()，其目录为/data/user/0/包名/files - name，为了加强安全性，此值将隐藏您要共享的子目录的名称
- path，会在
/data/user/0/包名/files目录下会生成一个 images 的文件夹
也就是说现在你的 /data/user/0/包名/files/images/ 下面的文件具备了提供给外部应用共享的能力了
当然，除了 files-path 标签之外还有许多标签，道理都是一样的，只是路径改变了而已
Context.getFilesDir() /data/user/0/com.mydomain/files
<files-path name="name" path="path/"/>
Context.getFilesDir() /data/user/0/com.mydomain/cache
<cache-path name="name" path="path" />
Environment.getExternalStorageDirectory() /storage/emulated/0
<external-path name="name" path="path" />
Context.getExternalFilesDir(null) /storage/emulated/0/Android/data/com.mydomain/files
<external-files-path name="name" path="path" />
Context.getExternalCacheDir() /storage/emulated/0/Android/data/com.mydomain/cache
<external-cache-path name="name" path="path" />
Context.getExternalMediaDirs() /storage/emulated/0/Android/media/com.mydomain
<external-media-path name="name" path="path" />
最后，将这个 xml 文件应用在你的应用中，假设 xml 名为 res/xml/file_paths，那么示例如下：
<provider
android:name="androidx.core.content.FileProvider"
android:authorities="com.mydomain.fileprovider"
android:exported="false"
android:grantUriPermissions="true">
<meta-data
android:name="android.support.FILE_PROVIDER_PATHS"
android:resource="@xml/file_paths" />
</provider>
生成 content:// 形式的 Uri
生成一个 content:// 形式的 Uri 可以分为三步：
- 在具有共享能力的文件夹下创建一个文件夹
- 在上面的文件夹中创建图片文件
- 在 getUriForFile 方法中传入 authority 和 上面创建的图片文件，返回获得 content:// 形式的 Uri
代码如下：
File imagePath = new File(Context.getFilesDir(), "images");
File newFile = new File(imagePath, "default_image.jpg");
if (!imagePath.exists()) {
imagePath.mkdirs();
}
Uri contentUri = getUriForFile(getContext(), "com.mydomain.fileprovider", newFile);
最终返回的 contentUri 为 content://com.mydomain.fileprovider/my_images/default_image.jpg
授予 Uri 临时权限
通过以下任意一步，来为 getUriForFile 返回的 uri 授予访问权限
- 使用
Context.grantUriPermission(package, Uri, mode_flags)。package 参数用来指定获取临时访问权限的包名，mode_flags 设置为Intent.FLAG_GRANT_READ_URI_PERMISSION或Intent.FLAG_GRANT_WRITE_URI_PERMISSION或两者都设置 - 调用 Intent 的 setData() 方法，把 uri 传入
- 调用 Intent 的 setFlags() 方法，设置
Intent.FLAG_GRANT_READ_URI_PERMISSION或Intent.FLAG_GRANT_WRITE_URI_PERMISSION或两者都设置
注意：当接收 Activity 的堆栈处于活动状态时，在 Intent 中授予的权限仍然有效。堆栈完成后，权限将自动删除。在客户端应用程序中授予一个 Activity 的权限会自动扩展到该应用程序的其他组件。
向另一个应用提供 content:// 形式的 Uri
传递一个 content:// 形式的 Uri 给其他应用有许多方式，最常用的一种是通过 startActivityForResult()，将 Intent 传递给另一个应用。
实现选择图片、拍照、裁剪| 本文源码：https://github.com/Linfeng1028/FileProvider
参考文章：https://developer.android.com/reference/androidx/core/content/FileProvider?hl=en
网友评论