Android FileProvider的基本使用

关于FileProvider

FileProvider是一个ContentProvider的子类，它取代了“file://”形式的Uri 通过“content://”形式的Uri实现了App间的安全通信。content Uri 可以赋予你临时的读写权限。当你创建一个包含ContentUri的Intent，并且打算将Intent发送给一个ClientApp，你可以通过该Intent.setFlags来设置权限。并且只要接收activity所在的栈是存活的，这些权限之于ClientApp都是可用的。同理，对于一个发给Service的Intent，只有这个Service是运行的，这些权限也是可用的。
相比较而言，file Uri形式，必须通过修改对应的文件的系统权限，来实现文件间的共享，这是不安全的。conent Uri提高了的文件访问安全性使得FileProvider成为了Android安全框架的一个核心点。
https://developer.android.google.cn/reference/androidx/core/content/FileProvider

FileProvider的基本使用

在XML中指定要共享的文件夹

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

authorities：一个标识，在当前系统内必须是唯一值，一般用包名。
exported：表示该 FileProvider 是否需要公开出去。
granUriPermissions：是否允许授权文件的临时访问权限。这里需要，所以是 true。

指定可访问的文件

FileProvider实例只能够为你预先指定的目录下的文件生成Content Uri。你需要在xml中paths的子结点下指定存文件目录、储区域或者存储路径。如下所示，paths告知了FileProvider你期望为你私有文件区域的image子目录请求Uri。

<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <files-path name="my_images" path="images/"/>
    ...
</paths>

xml 属性：
1.name=“name”
一个Uri的路径段，处于安全性考虑，该值隐藏了你正在分析的目录名称。这个目录名称包含于path属性之中
2.path=“path”
你将要分享的子目录。尽管name属性是uri路径的一部分，但是path的value才是一个实际的文件名。注意这是一个文件夹名称，不是一个文件。

paths下标签和路径对应关系：

标签名	对应API	对应路径
root-path	TAG_ROOT_PATH	/
files-path	Context.getFilesDir()	/data/user/0/com.example.demo/files
cache-path	Context.getCacheDir()	/data/user/0/com.example.demo/cache
external-path	Environment.getExternalStorageDirectory()	/storage/emulated/0
external-files-path	Context.getExternalFilesDir(String type)	/storage/emulated/0/Android/data/com.example.demo/files
external-cache-path	Context.getExternalCacheDir()	/storage/emulated/0/Android/data/com.example.demo/cache
external-media-path	Context.getExternalMediaDirs()	/storage/emulated/0/Android/media/com.example.demo

为了通过content Uri 实现应用间 共享文件，你的app 必须生成一个content Uri。那怎么生成content Uri呢？ 你需先针对要分享的文件实例化一个File对象，然后将其传给getUriForFile()方法。再然后将返回值通过Intent传给另一个Intent。接收到Intent的app能够打开并且访问它的内容，通过ParcelFileDescriptor（ContentResolver.openFileDescriptor实现FD解析）。

File imagePath = new File(Context.getFilesDir(), "images");
File newFile = new File(imagePath, "default_image.jpg");
Uri contentUri = getUriForFile(getContext(), "com.mydomain.fileprovider", newFile);

上述代码段返回的结果是：
content://com.mydomain.fileprovider/my_images/default_image.jpg.