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配置这样一段代码:

   <provider
            android:name="android.support.v4.content.FileProvider"
            android:authorities=""
            android:exported="false"
            android:grantUriPermissions="true">
            <meta-data
                android:name="android.support.FILE_PROVIDER_PATHS"
                android:resource="@xml/update_files" />
        </provider>

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

2.编写resource xml file

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

<resources xmlns:android="http://schemas.android.com/apk/res/android">
    <paths>
        <!--<files-path path="files" name="files" />-->
        <!--<cache-path path="files" name="cache" />-->
        <external-path name="temp"  path="Pictures" />
        <!--<external-files-path path="files" name="externalfiles"/>-->
        <!--&lt;!&ndash; 此标签需要 support 25.0.0以上才可以使用&ndash;&gt;-->
        <!--<external-cache-path  path="files" name="externalcache"/>-->
        <!--<root-path name="name" path="path" />-->
    </paths>
</resources>

注: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技术这条路上,越走越远,成为更好的自己。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 159,117评论 4 362
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,328评论 1 293
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,839评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 44,007评论 0 206
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,384评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,629评论 1 219
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,880评论 2 313
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,593评论 0 198
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,313评论 1 243
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,575评论 2 246
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,066评论 1 260
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,392评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,052评论 3 236
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,082评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,844评论 0 195
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,662评论 2 274
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,575评论 2 270

推荐阅读更多精彩内容

  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 170,569评论 25 707
  • 由于 Android 7.0 或更高版本的系统在国内手机市场上的占比不是很高,很多 Android 开发人员并没有...
    亦枫阅读 4,020评论 1 39
  • 当反复抛1万次硬币的时候,出现正面和出现反面的概率就会接近1:1 “最近真是倒霉。”求君又跟我吐槽最近的求职经历。...
    文学社社长阅读 459评论 0 0
  • 前段时间有朋友咨询我面瘫后遗症应该如何处理。我回答是要看具体哪些问题。 两年前接诊过一个病人,周围性面瘫。42岁,...
    大中医戴戴阅读 1,571评论 4 1
  • 说到牙膏这个问题,任何有关牙齿的问题都应该去咨询牙医,牙膏都只是作为日常清洁的辅助,起的并不是主要作用。重要的是当...
    一只汤圆在南方阅读 599评论 0 0