Android 关于FileProvider的使用小解

何时使用FileProvider？

简单来讲，就是在安卓手机系统与APP的目标版本，都是7.0以上时，便需要使用FileProvider
换言之，某款手机系统7.0
而APP的开发环境是compileSdkVersion 25，targetSdkVersion 25（注：sdk25对应Android 7.1）
在使用相机功能时，会出现崩溃的问题，而日志的错误显示是：android.os.FileUriExposedException:……
这是因为，即Android6.0后，需要动态获取权限后，Android7.0对于这一部分的管理，变得更加的严格，禁止你使用外部的应用，公开 file:// URI……
换言之，就是存储功能被限制了。
怎么样，是不是很方~
别担心，你有张良计，我有过墙梯。
想要使用相机等存储功能，就必须要授予 URI 临时访问权限，而进行此授权的最简单方式是使FileProvider类

使用FileProvider步骤拆解：

1.声明provider

在AndroidManifest.xml配置这样一段代码：

注：android:authorities=""一栏可以随意配置，只要一一对应即可，建议命名的方式，是公司的域名倒着写。

2.编写resource xml file

在res文件夹下，新建xml文件夹，在内创建update_files.xml文件，里面写上：

注：path是路径名，不可随意命名，需要一一对应，命名错误，会导致失败，在此，因我是调用相机功能拍摄照片，所以path="Pictures"

3.使用FileProvider API

    private void takePhoto() {
        //创建一个临时的共用的目录，去存储相机拍照的文件
        imageFile = null;
        String storagePath;
        File storageDir;
        String timeStamp = new SimpleDateFormat("yyyyMMdd_HHmmss").format(new Date());
        try {
            storagePath =  Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_PICTURES).getAbsolutePath();
            storageDir = new File(storagePath);
            storageDir.mkdirs();
            imageFile = File.createTempFile(timeStamp, ".jpg", storageDir);
        } catch (IOException e) {
            e.printStackTrace();
        }
        tempUri = FileProvider.getUriForFile(mContext, "对应声明provider中的android:authorities",imageFile);

        //相机
        Intent openCameraIntent = new Intent(
                MediaStore.ACTION_IMAGE_CAPTURE);
        openCameraIntent.putExtra(MediaStore.EXTRA_OUTPUT, tempUri); // 授予目录临时共享权限
        openCameraIntent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION | Intent.FLAG_GRANT_WRITE_URI_PERMISSION);
        startActivityForResult(openCameraIntent, TAKE_PICTURE);
    }

关键代码，有三行，即 ：

tempUri = FileProvider.getUriForFile(mContext, "对应声明provider中的android:authorities",imageFile);
openCameraIntent.putExtra(MediaStore.EXTRA_OUTPUT, tempUri); // 授予目录临时共享权限
openCameraIntent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION | Intent.FLAG_GRANT_WRITE_URI_PERMISSION);

4.图片裁剪授权

用相机拍完照后，有时候需要对照片进行裁剪，代码如下：

    /**
     * 裁剪图片方法实现
     *
     * @param uri
     */
    protected void startPhotoZoom(Uri uri) {
        if (uri == null) {
            LogUtils.i("tag", "The uri is not exist.");
        }
        tempUri = uri;
        Intent intent = new Intent("com.android.camera.action.CROP");
        intent.setDataAndType(uri, "image/*");
        // 设置裁剪
        intent.putExtra("crop", "true");
        // aspectX aspectY 是宽高的比例
        intent.putExtra("aspectX", 1);
        intent.putExtra("aspectY", 1);
        // outputX outputY 是裁剪图片宽高
        intent.putExtra("outputX", 150);
        intent.putExtra("outputY", 150);
        intent.putExtra("return-data", true);

        intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
        intent.addFlags(Intent.FLAG_GRANT_WRITE_URI_PERMISSION);

        startActivityForResult(intent, CROP_SMALL_PICTURE);
    }

相较于Android7.0以前，增加了
intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
intent.addFlags(Intent.FLAG_GRANT_WRITE_URI_PERMISSION);
也是为了赋予裁剪照片的读写权限

后记

此前，我们公司开发的app，目标版本 compileSdkVersion，targetSdkVersion，都是7.0以下的，修改为sdk25之后，除了上传头像、上传图片，调用相机时，会出现问题以外，事实上，只要是用到了外部存储的（内部存储无所谓），都需要这样使用FileProvider类，去获取一个临时路径。
在半个月前，我们公司的app上线后，就出现了一个因为未考虑到这个问题，而引发的‘上线事故’。
事情是这样的，我们公司的app，是有自动更新功能的，即在app的内部，每一次打开app之后，便会去检测，用户手机里安装的版本，与最新的版本号，是否一致，若不一致，则提示更新。
具体操作大致是用Intent类发送一个意图，在app的外部，下载一个最新版本的app。
由于，最新版本的app，已经将目标版本更换为了compileSdkVersion 25，targetSdkVersion 25，而这一块，没有使用FileProvider去开辟一个临时路径。
这就会导致，在下一个版本发布时，习惯在app内部更新的那一部分用户，在点击更新按钮后，去下载最新的版本失败。
简而言之，就是app无法再自动更新了。
因此，当天在下班前后，发现了这个重大Bug，我便在最快的时间里，在官网以及各大应用平台，将新上线的app版本撤销的撤销，下架的下架，虽处理及时，却还是影响了一部分用户。
希望其他Android开发人员，引以为戒，不要犯与此相同或类似的错误。
最后，祝你我，能在Android技术这条路上，越走越远，成为更好的自己。