快速使用FileProvider解决Android7.0文件权限问题

升级到Android7.0之后，启动系统相机或者截图，传入URI的时候可能会导致程序闪退崩溃。这是因为7.0的新的文件权限导致的。下面是解决这个问题的快速解决方案。

问题代码

在7.0可能会出问题的代码：

final String CACHE_IMG = Environment.getExternalStorageDirectory()+"/demo/"
final int TAG_PHOTO_CAMERA=200;


Intent intent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);

String fileName = "defaultImage.jpg";

File file = new File(CACHE_IMG, fileName);

Uri uri = Uri.fromFile(file);

intent.putExtra(MediaStore.EXTRA_OUTPUT, uri);

startActivityForResult(intent, TAG_PHOTO_CAMERA);

其中Uri uri = Uri.fromFile(file);这里会导致闪退。

解决方法

step1. 将Uri的生成方式改为由FileProvider提供的临时授权路径，并且在intent中添加flag
修改后代码如下

final String CACHE_IMG = Environment.getExternalStorageDirectory()+"/demo/"
final int TAG_PHOTO_CAMERA=200;

Intent intent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);

String fileName = "defaultImage.jpg";

File file = new File(CACHE_IMG, fileName);

Uri imageUri=FileProvider.getUriForFile(activity,"me.xifengwanzhao.fileprovider", file);//这里进行替换uri的获得方式

intent.putExtra(MediaStore.EXTRA_OUTPUT, imageUri);

intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);//这里加入flag

startActivityForResult(intent, TAG_PHOTO_CAMERA);

step2.在AndroidManifest.xml中的application标签中添加provider的配置

   <application
       ...>
         <provider
            android:name="android.support.v4.content.FileProvider"
            android:authorities="me.xifengwanzhao.fileprovider"//这里需要和上面部分字符串相同
            android:exported="false"
            android:grantUriPermissions="true">
            <meta-data
                android:name="android.support.FILE_PROVIDER_PATHS"
                android:resource="@xml/file_paths" />
        provider>
    application>

step3.在res/xml中新建一个文件file_paths.xml

<resource xmlns:android="http://schemas.android.com/apk/res/android">
    <external-path
        name="images"
        path="demo/" />
resource>

OK，大功告成，这样就不会崩溃了

代码解释

我们先看Google官方的7.0行为变更介绍 （不需要）

对于面向 Android 7.0 的应用，Android 框架执行的 StrictMode API 政策禁止在您的应用外部公开 file:// URI。如果一项包含文件 URI 的 intent 离开您的应用，则应用出现故障，并出现 FileUriExposedException 异常。

要在应用间共享文件，您应发送一项 content:// URI，并授予 URI 临时访问权限。进行此授权的最简单方式是使用 FileProvider 类。如需了解有关权限和共享文件的详细信息，请参阅共享文件。

根据文档提示我们使用FileProvider进行处理，同时利用xml对FileProvider进行配置
参考如下

java根路径产生方式	对应xml根节点名称
Context.getFilesDir()	files-path
getCacheDir()	cache-path
Environment.getExternalStorageDirectory()	external-path
Context#getExternalFilesDir(String) Context.getExternalFilesDir(null)	external-files-path
Context.getExternalCacheDir()	external-cache-path

节点中的name 不可重名，path为自定义

关于相册选图和相机裁剪

有同学反映相册选图和相机裁剪时候的报错问题，这里也说一下
系统相册选图返回的Uri是可以直接使用的，不需要也不能使用FileProvider进行转换
如果需要根据uri获得转换后的uri 可以参考如下方式

Uri fromUri;
if (uri.getScheme() != null && uri.getScheme().startsWith("file")) {
    fromUri =
         FileProvider.getUriForFile(mContext,"me.xifengwanzhao.fileprovider", new File(FileUtils.getPath(mContext, uri)));//这里进行替换uri的获得方式
    intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);//这里加入flag
} else {
     //相册选图适配
     fromUri = uri;
}

关于相机裁剪
相机裁剪 intent.setDataAndType(fromUri, “image/*”);这里是需要对uri进行转换的，
而 intent.putExtra(MediaStore.EXTRA_OUTPUT, Uri.fromFile(file));这里使用原来的方式获取uri就可以了
那么启动系统裁剪的方法可以写成这样

    /**
     * 开启截图,启动系统的截图方法 返回requestCode为 {Constant.IMG_ZOOM}
     *
     * @param mContext 必须为activity
     * @param uri      需要进行裁剪的图片的uri
     * @param size     截图的大小宽和高的数值，这里仅限截图为1:1的正方形
     * @return path 截图返回的路径
     * @see Constant#IMG_ZOOM
     */
    public static String startPhotoZoom(Activity mContext, Uri uri, int size) {
        //这里生成一个保存截图用的临时路径并且返回出去
        String imgPath;
        File file = new File(Constant.ZOOM_IMAGE, Constant.getNewestImageName(mContext));
        imgPath = file.getPath();

        Intent intent = new Intent("com.android.camera.action.CROP");
        Uri fromUri;
        if (uri.getScheme() != null && uri.getScheme().startsWith("file")) {
            fromUri = FileProvider.getUriForFile(mContext, "me.xifengwanzhao.fileprovider", new File(FileUtils.getPath(mContext, uri)));//这里进行替换uri的获得方式
            intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);//这里加入flag
        } else {
            //相册选图适配
            fromUri = uri;
        }
        intent.setDataAndType(fromUri, "image/*");
        intent.putExtra("crop", "true");
        intent.putExtra(MediaStore.EXTRA_OUTPUT, Uri.fromFile(file));
        if (android.os.Build.MANUFACTURER.contains("HUAWEI")) {// 华为特殊处理 不然会显示圆
            intent.putExtra("aspectX", 9998);
            intent.putExtra("aspectY", 9999);
        } else {
            intent.putExtra("aspectX", 1);
            intent.putExtra("aspectY", 1);
        }
        intent.putExtra("outputX", size);
        intent.putExtra("outputY", size);
        mContext.startActivityForResult(intent, Constant.IMG_ZOOM);
        return imgPath;
    }

参考文档

[1]Android N 调用相册crash- FileUriExposedException
[2]根据 Android Training课程写的FileProvider小例子
[3]使用FileProvider共享文件
[4]Android7.0适配教程与心得
[5]Android N 调用相册crash- FileUriExposedException