安卓开发学习之利用FileProvider获取文件uri

介绍

FileProvider是Android中推荐的获取文件Uri方式，将取代Uri.fromFile()方法

老方式的问题

在安卓7.0版本中，直接根据内部存储中的文件获取Uri会程序崩溃，相关代码如下：

Uri uri = Uri.fromFile(file);

运行的话，会报错：

解决方法，就是引入FileProvider

FileProvider的使用

现在，我一步一步来给大家演示FileProvider的用法

声明

我们首先要在清单文件中application节点下，声明一个FileProvider子节点

<provider
  android:authorities="com.example.songzeceng.myFileProvider"
  android:name="android.support.v4.content.FileProvider"
  android:exported="false"
  android:grantUriPermissions="true">
  <meta-data android:name="android.support.FILE_PROVIDER_PATHS"
             android:resource="@xml/updatepath"></meta-data>
</provider>

里面的属性和节点解释如下：

provider:表示这是一个provider

android:authorities:provider的名字，跟ContentProvider的这个属性一样，是这个provider的标识

android:name:固定的，要用FileProvider就必须声明成代码中的样子

android:exported:可否导出，必须为false

android:grantUriPermissions:是否被赋予uri权限，必须为true

android:name:分享目录的名字，固定写死的

android:resource:路径对应的xml文件，这个应该在res目录下新建一个对应的xml文件

创建分享xml文件

现在我们要创建一个跟上文说的android:resource标签对应的xml文件-->xml/updatepath.xml

<?xml version="1.0" encoding="utf-8"?>
<resources xmlns:android="http://schemas.android.com/apk/res/android">
    <paths>
        <files-path path="files" name="files" />
        <cache-path path="files" name="cache" />
        <external-path path="files" name="external" />
        <external-files-path path="files" name="externalfiles"/>
        <!-- 此标签需要 support 25.0.0以上才可以使用-->
        <external-cache-path  path="files" name="externalcache"/>
    </paths>
</resources>

其中标签 file-path、cache-path这些表示手机内存中的某个目录，path属性是这个目录下的子目录，name属性是假名，这个假名将替代path目录的绝对路径

图中涉及的子标签对应的路径如下：

子标签

子标签对应的绝对路径(不加path)

子标签对应的绝对路径(加path)

假名

files-path

app私有存储区域下的files目录

(context.getFilesDir())

files目录加上path

(context.getFilesDir()/files)

files

cache-path

(context.getCacheDir())

私有缓存目录加上path

(context.getCacheDir()/files)

cacheexternal-path外存根目录(Environment.getExternalStorageDirectory())外存根目录加上path(Environment.getExternalStorageDirector()/files)external

external-files

-path

(context.getExternalFilesDir())

文件目录加上path

(context.getExternalFilesDir()/files)

externalfiles

external-cache

-path

(context.getExternalCacheDir())

缓存目录加上path

(context.getExternalCacheDir()/files)

externalcaches

最后的结果，就是外部app获取到的分享目录，不是路径，而是假名

而且，每添加一个分享目录，就要添加一个对应的子标签

比如我添加一个新的分享目录，是外存根目录下的一个文件夹，就添加一个子标签如下：

<external-path name = "fp_pictures" path = "/Pictures/dongqiudi/"></external-path>

就可以了

利用FileProvider获取文件Uri

代码如下：

String path = Environment.getExternalStorageDirectory().getPath() + "/Pictures/dongqiudi/1523624189281.jpg";
File file = new File(path);
if (file.exists()) {
   Uri uri = FileProvider.getUriForFile(MainActivity.this, "com.example.songzeceng.myFileProvider", file);
   Log.i(TAG, "uri:" + uri.toString());
}

代码很简单，只不过为了以防出错，我判断了一下文件是否存在(不存在会怎样，我没试过)

结果

可以看到，它确实把我们指定的分享目录路径，换成了假名fp_pictures。这个uri和以前的路径uri不一样，但不影响使用，他还是会正确地找到我们的文件的。

结语

这个例子只是验证了一下，看一下FileProvider是否正确解析并转换文件uri，以及程序是否崩溃，发现一切正常，之后我们就可以根据自己的业务，使用新生成的uri了