Android开发中FileProvider的使用方法

android开发中fileprovider的使用方法。

android 7.0 在应用间共享文件

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

解决方案:

要在应用间共享文件，您应发送一项content://uri，并授予uri临时访问权限。进行此授权的最简单方式是使用fileprovider类。

fileprovider简介

fileprovider是contentprovider的一个特殊的子类，它让应用间共享文件变得更加容易，其通过创建一个content uri来代替file uri。

一个content uri 允许开发者可赋予一个临时的读或写权限。当创建一个包含content uri的intent的时候，为了能够让另一个应用也可以使用这个uri，你需要调用intent.setflags()来添加权限。只要接收activity的栈是活跃的，则客户端应用就可以获取到这些权限。如果该intent是用来启动一个service，则只要该service是正在运行的，则也可以获取到这些权限。

相比之下，如果想要通过file uri来控制权限，开发者必须修改底层文件的权限。这些权限会对任意的app开放，直到你修改了它。这种级别的访问基本上是不安全的。

通过content uri来提高文件访问的安全性，使得fileprovider成为android安全基础设置的一个关键部分。

fileprovider的使用

定义一个fileprovider 指定有效的文件 从一个file得到一个对应的content uri 对uri赋予临时权限 分享这个uri给另一个app

1. 定义一个fileprovider

由于fileprovider中已经包含了为file生成content uri的基本代码了，所以开发者不必再去定义一个fileprovider的子类。你可以在xml文件中指定一个fileprovider：在manifest中使用标签来指定。

    ...
    
        ...
        
            ...
        
        ...
    

说明：

name的值一般都固定为android.support.v4.content.fileprovider。如果开发者继承了fileprovider，则可以写上其绝对路径。 authorities字段的值用来表明使用的使用者，在fileprovider的函数geturiforfile需要传入该参数。 exported 的值为false，表示该fileprovider只能本应用使用，不是public的。 granturipermissions 的值为true，表示允许赋予临时权限。

2. 指定有效的文件

只有事先指定了目录，一个fileprovider才可以为文件生成一个对应的content uri。要指定一个路径，需要在xml文件中指定其存储的路径。使用标签。例如:

上边的paths 元素指定/data/data//files/images/为共享的目录。(file-path所对应的目录与context.getfilesdir()所对应，即/data/data//files)。其中：name属性表示在uri中的描述，path属性表示文件实际存储的位置。

里边的元素必须是一下的一个或者多个：

对应context.getfilesdir() + “/path/”，即/data/data//files/path/。 对应context.getcachedir() + “/path/”，即/data/data//cache/path/。 对应context.getexternalfilesdir(null) + “/path/”，即/storage/emulated/0/android/data//files/path/。 对应context.getexternalcachedir() + “/path/”，即/storage/emulated/0/android/data//cache/path/。 对应environment.getexternalstoragedirectory() + “/path/”，即/storage/emulated/0/path/。

这些paths里边有相同的子元素，即name和path。

name

这是uri的path。为了加强安全性，这个值隐藏了分享文件的子目录，具体的文件真实路径在path字段中保存。

a uri path segment. to enforce security, this value hides the name of the subdirectory you’re sharing. the subdirectory name for this value is contained in the path attribute.

path

分享文件的真实路径。需要注意的是，这个值表示的是一个子目录，不是一个具体的文件或者多个文件。开发者不能通过文件名来分享一个文件，也不能通过一个通配符来分享文件。

the subdirectory you’re sharing. while the name attribute is a uri path segment, the path value is an actual subdirectory name. notice that the value refers to a subdirectory, not an inpidual file or files. you can’t share a single file by its file name, nor can you specify a subset of files using wildcards.

将paths里边的内容放在一个xml文件中，将该文件放在res/xml/目录下，然后在manifest的provider标签中指定它：

res/xml/file_paths.xml

androidmanifest.xml

3. 从一个file得到一个对应的content uri

        file file = new file(mcontext.getfilesdir() + "/text", "hello.txt");
        uri data;
        if (build.version.sdk_int >= build.version_codes.n) {
            data = fileprovider.geturiforfile(mcontext, "com.ysx.fileproviderserver.fileprovider", file);
        } else {
            data = uri.fromfile(file);
        }

需要注意的是，

文件的绝对路径与第二步指定的文件目录保持一致：(假设包名为com.ysx.fileproviderserver)。如上边的代码的文件的绝对路径为/data/data/com.ysx.fileproviderserver/files/text/hello.txt，对应paths中的内容为:。 geturiforfile()的第二个参数是authority，与manifest文件中声明的authorities保持一致。

这时候，我们得到的uri的串为：content://com.ysx.fileproviderserver.fileprovider/my_files/hello.txt。

4. 赋予临时权限

两种方法：（通常使用第2种）

context.granturipermission(package, uri, mode_flags) intent.setflags()

intent.addflags(intent.flag_grant_read_uri_permission | flag_grant_write_uri_permission);

flag_grant_read_uri_permission：表示读取权限；
flag_grant_write_uri_permission：表示写入权限。

你可以同时或单独使用这两个权限，视你的需求而定。

5. 分享这个uri给另一个app

通常是通过intent来传递的。eg.

    private void sharefile() {
        log.d(tag, "sharefile: ");
        intent intent = new intent();
        componentname componentname = new componentname("com.ysx.fileproviderclient",
                "com.ysx.fileproviderclient.mainactivity");
        intent.setcomponent(componentname);
        file file = new file(mcontext.getfilesdir() + "/text", "hello.txt");
        uri data;
        if (build.version.sdk_int >= build.version_codes.n) {
            data = fileprovider.geturiforfile(mcontext, file_provider_authorities, file);
            // 给目标应用一个临时授权
            intent.addflags(intent.flag_grant_read_uri_permission);
        } else {
            data = uri.fromfile(file);
        }
        intent.setdata(data);
        startactivity(intent);
    }

常见的使用场景：

调用照相机，指定照片存储路径。 调用系统安装器，传递apk文件。

调用照相机：

    /**
     * @param activity 当前activity
     * @param authority fileprovider对应的authority
     * @param file 拍照后照片存储的文件
     * @param requestcode 调用系统相机请求码
     */
    public static void takepicture(activity activity, string authority, file file, int requestcode) {
        intent intent = new intent();
        uri imageuri;
        if (build.version.sdk_int >= build.version_codes.n) {
            imageuri = fileprovider.geturiforfile(activity, authority, file);
            intent.addflags(intent.flag_grant_read_uri_permission);
        } else {
            imageuri = uri.fromfile(file);
        }
        intent.setaction(mediastore.action_image_capture);
        intent.putextra(mediastore.extra_output, imageuri);
        activity.startactivityforresult(intent, requestcode);
    }

调用安装器：

    /**
     * 调用系统安装器安装apk
     *
     * @param context 上下文
     * @param authority fileprovider对应的authority
     * @param file apk文件
     */
    public static void installapk(context context, string authority, file file) {
        intent intent = new intent(intent.action_view);
        uri data;
        if (build.version.sdk_int >= build.version_codes.n) {
            data = fileprovider.geturiforfile(context, authority, file);
            intent.addflags(intent.flag_grant_read_uri_permission);
        } else {
            data = uri.fromfile(file);
        }
        intent.setdataandtype(data, install_type);
        context.startactivity(intent);
    }