Android 7.0 FileProvider 的使用与疑惑

Android 7.0 设备已经逐渐普及了。然而和 6.0 系统的 运行时权限 类似， Google 又针对这个版本做了一些出于安全性考虑的改动。如果针对 24+ 的 SDK 版本 进行开发，你不得不做一些适配工作。

FileUriExposedException

我们创建一个项目，目标 SDK 设置为 24 或者更大。
首先写一个布局文件，取名 activity_main 。
很简单，一个帧布局，里面一个按钮。

对应的 MainActivity ，也很简单，声明赋值按钮，然后添加点击事件。
事件里调用 系统自带 的相机应用，这是 Google 推荐的方式，可以不用额外申请权限。
因为仅仅为了测试，就不写回调了，直接打开系统相机的活动。

package com.example.jin.fileprovidertest;

import android.content.Intent;
import android.net.Uri;
import android.os.Environment;
import android.provider.MediaStore;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;

import java.io.File;

public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        Button btn = (Button) findViewById(R.id.ac_main_btn);
        btn.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                Uri uri = Uri.fromFile(new File(Environment.getExternalStorageDirectory().getPath()));
                Intent intent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);
                intent.putExtra(MediaStore.EXTRA_OUTPUT, uri);
                startActivity(intent);
            }
        });
    }
}

然后在一台 Android 7.0 设备上启动之，结果一点按钮就崩溃了——

1.gif

查看 logcat ，报了一个异常叫 FileUriExposedException
原来这是 Android 7.0 的一处安全性改动： 不允许再直接使用真实路径的URI。 因此不能再直接调 Uri.fromFile() 方法了，需要用到本文的主角 FileProvider 。

FileProvider

这是 Android 7.0 新增的一个类，位于 v4 包下，继承自四大组件之一的 ContentProvider ，因此需要 在清单配置文件里注册。
首先在资源文件夹下新建一个 xml 目录，里面包含一个文件 test ——

1.png

文件内容如下——

外两层写法是固定的，重点在第三层。
首先是节点名 ，它对应前面代码中 Environment.getExternalStorageDirectory() 方法获取到的存储路径。
如果是其它路径，节点名要做相应改变——
，对应 Context.getFilesDir() 方法；
，对应 getCacheDir() 方法；
，Google 官方文档和网上多数文章都说，是对应 Environment.getExternalStorageDirectory() 方法，但在现有设备上亲测均无效，会报 IllegalArgumentException 异常。
，对应 Context.getExternalFilesDir() 方法；
，对应 Context.getExternalCacheDir() 方法。
然后是 path 属性，Google 官方文档和网上多数文章同样都说，传空，代表你整个对应路径都可以用于共享；传入一个相对路径，代表只有这个路径的指向才能用于共享。但在现有设备上亲测同样均无效，会报 IllegalArgumentException 异常。
以上二处原因不明，请指教。
完成 test.xml 后，我们去 AndroidManifest 文件里注册——

需要注意的就是 authorities 属性，Google 官方推荐的写法是「包名 + .fileprovider」。其它属性写法固定，resource 的值应指向你之前的 xml 文件。
好了，现在修改我们的 MainAcitivity ，将 onClick()方法的内容修改为——

final String authority = "com.example.jin.fileprovidertest.fileprovider";
boolean b = Build.VERSION.SDK_INT >= 24;
File file = new File(Environment.getExternalStorageDirectory().getPath());
Uri uri = b
        ? FileProvider.getUriForFile(MainActivity.this, authority, file)
        : Uri.fromFile(file);
Intent intent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);
intent.putExtra(MediaStore.EXTRA_OUTPUT, uri);
startActivity(intent);

然后启动，完美！

2.gif

---

最近看了一些文章，补充更新：

• 建议自己创建一个类 MyProvider 继承 FileProvider（类里面可以什么都不写），然后将 name 属性的值设为 .MyProvider。这样做的好处是可以确保当进行组件化开发时，不同组件之间的 merge 不会发生冲突。
• authority 属性的值更规范一点的写法是 ${applicationId}.fileprovider。相应的在代码中，它的赋值为 getPackageName() + ".fileprovider"（需要有上下文环境）。
• xml 文件的 节点可以剥掉，直接用 做根节点。

---

本文结束，欢迎拍砖吐槽 and 指教～～