关于Android7.0FileProvider的使用

就在昨天，手机接收到Android7.0的推送，我也是第一时间进行了更新。体验了一番，应用的安装速度确实是得到了提高。然后，写了图片选择的小demo，发现再Android7.0上会出现问题。查了一下，发现是Android7.0的一个新特性，将解决办法记录一下。

这里模仿一下上传头像的过程，既可以拍照上传，也可以从图库中直接选择。然后就是一个裁切的动作。在Android7.0以前可以这样写：

Android 7.0 以前

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
private void takePhoto() {
       mOutputImage = new File(Environment.getExternalStorageDirectory(), "/MyImage/" + System.currentTimeMillis() + ".jpg");
       if (!mOutputImage.getParentFile().exists()) {
           mOutputImage.getParentFile().mkdirs();
       }
       imageUri = Uri.fromFile(mOutputImage);
       Intent intent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);
       intent.putExtra(MediaStore.EXTRA_OUTPUT, imageUri);
       startActivityForResult(intent, TAKE_PHOTO);
   }
private void choosePhoto() {
       if (ContextCompat.checkSelfPermission(MainActivity.this, Manifest.permission
               .WRITE_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) {
           ActivityCompat.requestPermissions(MainActivity.this, new String[]{
                   Manifest.permission.WRITE_EXTERNAL_STORAGE
           }, 1);
       } else {
           openAlbum();
       }
   }
private void openAlbum() {
       Intent intent = new Intent(Intent.ACTION_PICK);
       intent.setType("image/*");
       startActivityForResult(intent, CHOOSE_PHOTO);
   }
@Override
   protected void onActivityResult(int requestCode, int resultCode, Intent data) {
       switch (requestCode) {
           case TAKE_PHOTO:
               if (resultCode == RESULT_OK) {
                   cropImage(imageUri);
               }
               break;
           case CHOOSE_PHOTO:
               if (resultCode == RESULT_OK) {
                   imageUri = data.getData();
                   cropImage(imageUri);
               }
               break;
           case CROP_PHOTO:
               pictrue.setImageURI(imageUri);
               break;
           default:
       }
   }
private void cropImage(Uri uri) {
       Intent intent = new Intent("com.android.camera.action.CROP");
       intent.setDataAndType(uri, "image/*");
       intent.putExtra("crop", "true");
       intent.putExtra("aspectX", 1);
       intent.putExtra("aspectY", 1);
       intent.putExtra(MediaStore.EXTRA_OUTPUT, imageUri);
       startActivityForResult(intent, CROP_PHOTO);
   }

上面choosePhoto()中进行了运行时权限的处理，以防止在Android6.0上出现问题。然后一切很简单了，就是调用系统的相机以及相册，然后剪切，最后将剪切后的图片设置到一个ImageView中。在Android7.0以前上面的代码是没有问题的。但是，如果将上述代码运行在7.0以上的设备中就会报错了。

报出了 FileUriExposedException异常。后来一查，发现在Android7.0，Android 框架执行的 StrictMode API 政策禁止在您的应用外部公开 file:// URI。如果一项包含文件 URI 的 intent 离开您的应用，则应用出现故障，并出现 FileUriExposedException 异常。所以，上述异常的问题在于我们使用的URI是 file:// URI类型的从而导致错误。在7.0上解决的方法是应用FileProvider。FileProvider，就是 ContentProvider 的一个特殊子类，帮助我们将访问受限的 file:// URI 转化为可以授权共享的 content:// URI。

Android 7.0

一.注册provider

既然FileProvider是ContentProvider的子类，所以它也是需要注册的。

1
2
3
4
5
6
7
8
9
<provider
           android:name="android.support.v4.content.FileProvider"
           android:authorities="com.example.cameraalbumtest.fileprovider"
           android:exported="false"
           android:grantUriPermissions="true">
           <meta-data
               android:name="android.support.FILE_PROVIDER_PATHS"
               android:resource="@xml/file_paths"/>
       </provider>

这里，name的写法是固定的，authorities大都是包名后接上fileprovider。可以不写死，而是动态应用${applicationId}.fileprovider。exported为false与grantUriPermissions为true，这都是固定的。之后标签中的name也是固定写法。resource引用了xml下的文件。

二.添加引用文件

上边引用了file_path文件，需要新建一个xml文件夹，在文件夹下新建一个file_path文件。

1
2
3
4
5
6
7
<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <external-path
        name="my_images"
        path=""/>
</paths>

这里为URI共享的路径，name值紧随其后，path值为共享具体的目录，什么都不写则共享整个外部存储空间。

  • ：内部存储空间应用私有目录下的 files/ 目录，等同于 Context.getFilesDir() 所获取的目录路径；

  • ：内部存储空间应用私有目录下的 cache/ 目录，等同于 Context.getCacheDir() 所获取的目录路径；

  • ：外部存储空间根目录，等同于 Environment.getExternalStorageDirectory() 所获取的目录路径；

  • ：外部存储空间应用私有目录下的 files/ 目录，等同于 Context.getExternalFilesDir(null) 所获取的目录路径；

  • ：外部存储空间应用私有目录下的 cache/ 目录，等同于 Context.getExternalCacheDir()；

三.使用FileProvider

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
private void takePhoto() {
       mOutputImage = new File(Environment.getExternalStorageDirectory(), "/MyImage/" + System.currentTimeMillis() + ".jpg");
       if (!mOutputImage.getParentFile().exists()) {
           mOutputImage.getParentFile().mkdirs();
       }
       if (Build.VERSION.SDK_INT >= 24) {
           imageUri = FileProvider.getUriForFile(MainActivity.this,
                   "com.example.cameraalbumtest.fileprovider", mOutputImage);
           Log.d(TAG, "uri " + imageUri);
           Toast.makeText(MainActivity.this, "Android 7.0", Toast.LENGTH_SHORT).show();
       } else {
           imageUri = Uri.fromFile(mOutputImage);
       }
       Intent intent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);
       intent.putExtra(MediaStore.EXTRA_OUTPUT, imageUri);
       startActivityForResult(intent, TAKE_PHOTO);
   }

这里做了一下判断，在7.0上才使用FileProvider，以下还是使用原来的方法。看一下具体的使用，只是用FileProvider.getUriForFile()方法代替了Uri.fromfile()。这里的参数分别是Context，authorities，file，这里的authorities就是我们刚刚注册provider时的那个authorities。这样就将一个File://URI装换成一个Content://URI。这里看一下Log，生成的uri是下面的样子。
content://com.example.cameraalbumtest.fileprovider/my_images/MyImage/1501138971453.jpg

可以看出前一部分是一个authorities，后面紧接着name值（在path_file中设置的，name值代替真实的path值）。然后后面接着图片的具体目录。那看一下原先的file：URI：
file:///storage/emulated/0/MyImage/1501140051699.jpg
两者对比发现，FileProvider很好的隐藏掉了图片的存储位置，增加了安全性。

这里就介绍完了FileProvider的基本使用。但是运行上面代码在7.0设备上还是会出错，这次出错在剪切逻辑上。会发现拍照完成之后并不能进行剪切，而从图库中选择的图片就可以剪切。解决方法如下：

1
2
3
4
5
6
7
8
9
10
11
private void cropImage(Uri uri) {
        Intent intent = new Intent("com.android.camera.action.CROP");
        intent.setDataAndType(uri, "image/*");
        intent.putExtra("crop", "true");
        intent.putExtra("aspectX", 1);
        intent.putExtra("aspectY", 1);
        intent.putExtra(MediaStore.EXTRA_OUTPUT, imageUri);
        intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
        intent.addFlags(Intent.FLAG_GRANT_WRITE_URI_PERMISSION);
        startActivityForResult(intent, CROP_PHOTO);
    }

之所以加上addFlags()是为了授予其他应用访问权限。
授权方式有两种：

第一种方式，使用 Context 提供的 grantUriPermission(package, Uri, mode_flags) 方法向其他应用授权访问 URI 对象。三个参数分别表示授权访问 URI 对象的其他应用包名，授权访问的 Uri 对象，和授权类型。其中，授权类型为 Intent 类提供的读写类型常量：

FLAG_GRANT_READ_URI_PERMISSION

FLAG_GRANT_WRITE_URI_PERMISSION

或者二者同时授权。这种形式的授权方式，权限有效期截止至发生设备重启或者手动调用 revokeUriPermission() 方法撤销授权时。

第二种方式，配合 Intent 使用。通过 setData() 方法向 intent 对象添加 Content URI。然后使用 setFlags() 或者 addFlags() 方法设置读写权限，可选常量值同上。这种形式的授权方式，权限有效期截止至其它应用所处的堆栈销毁，并且一旦授权给某一个组件后，该应用的其它组件拥有相同的访问权限。

拥有授予权限的 Content URI 后，便可以通过 startActivity() 或者 setResult() 方法启动其他应用并传递授权过的 Content URI 数据。

鸿洋大神的这一篇可以看一看，对Android7.0的适配给出了解决办法。

Android 7.0 行为变更 通过FileProvider在应用间共享文件吧

参考链接：
关于 Android 7.0 适配中 FileProvider 部分的总结

Android7.0适配心得

赏

谢谢你请我喝咖啡~~~

支付宝
微信

扫一扫，分享到微信

微信分享二维码

tag:

    缺失模块。
    1、请确保node版本大于6.2
    2、在博客根目录（注意不是yilia根目录）执行以下命令：
    npm i hexo-generator-json-content --save

    3、在根目录_config.yml里添加配置： 

      jsonContent:
    meta: false
    pages: false
    posts:
      title: true
      date: true
      path: true
      text: false
      raw: false
      content: false
      slug: false
      updated: false
      comments: false
      link: false
      permalink: false
      excerpt: false
      categories: false
      tags: true

I'm Kevin Jern，<br>一名在校大学生，<br>自由主义、理想主义以及完美主义者<br><br>热爱科技，热爱技术<br/>目前是一名小白Android Developer<br/><br/>竹杖芒鞋轻胜马，谁怕？一蓑烟雨任平生。<br>回首向来萧瑟处，归去，也无风雨也无晴。