Android FileProvider 的使用

1、前言

从 Android N(7.0) 开始,将严格执行 StrictMode 模式。而从 Android N 开始,将不允许在 App 间,使用 file:// 的方式,传递一个 File ,否者会抛出 FileUriExposedException 的异常引发 Crash。解决方案就是通过 FileProvider 用 content:// 代替 file://,需要开发者主动升级 targetSdkVersion 到 24 才会执行此策略。

2、读取目录

2.1 内部存储

每安装一个 App 系统都会在内部存储空间的 data/data 目录下以应用包名为名字自动创建与之对应的文件夹,这个文件夹用于持久化 App 中的 WebView 缓存页面信息、SharedPreferences、SQLiteDatabase 等应用相关数据。当用户卸载 App 时,系统自动删除 data/data 目录下对应包名的文件夹及其内容。

获取并操作内部存储空间中的应用私有目录的方法如下:

  • context.getFilesDir()
  • context.getCacheDir()
  • context.deleteFile()
  • context.fileList()
  • Environment.getDataDirectory()

2.2 外部存储

考虑到普通用户无法访问应用的内部存储空间,比如用户想从应用里面保存一张图片,那么这张图片应该存储在外部存储空间,用户才能访问的到

外部存储空间路径为:/storage/emulated/0/Android/data/<包名>

外部存储分为应用私有目录公共目录

(1)应用私有目录

默认情况下,系统并不会自动创建外部存储空间的应用私有目录。只有在应用需要的时候,开发人员通过 SDK 提供的 API 创建该目录文件夹和操作文件夹内容。

当用户卸载 App 时,系统也会自动删除外部存储空间下的对应 App 私有目录文件夹及其内容。

获取并操作外部存储空间中的应用私有目录的方法如下:

  • context.getExternalFilesDir()
  • context.getExternalCacheDir()
  • Environment.getExternalStorageDirectory()

(2)公共目录

外部存储空间中的公共目录用来存放当应用被卸载时,仍然可以保存在设备中的信息,如:拍照类应用的图片文件,用户是使用浏览器手动下载的文件等。、

外部存储空间已经为用户默认分类出一些公共目录。开发人员可以通过 Environment 类提供的方法直接获取相应目录的绝对路径,传递不同的 type 参数类型即可:

  • Environment.getExternalStoragePublicDirectory(String type);

Envinonment 类提供诸多 type 参数的常量,比如:

  • DIRECTORY_MUSIC:/storage/emulated/0/Music
  • DIRECTORY_MOVIES:/storage/emulated/0/Movies
  • DIRECTORY_PICTURES:/storage/emulated/0/Pictures
  • DIRECTORY_DOWNLOADS:/storage/emulated/0/Download

3、FileProvider

3.1 什么是 FileProvider

FileProvider 是 ContentProvider的子类 目前 support v4 包 和 androidx的core包里面都有提供。FileProvider 本质上就是一个 ContentProvider ,它其实也继承了 ContentProvider 的特性。其实ContentProvider 就是在可控的范围内,向外部其他的 App 分享数据。而 FileProvider 将这样的数据变成了一个 File 文件而已。

3.2 使用 FileProvider 的场景

在 App 内,通过一个 Intent 传递了一个 file:// 的 Uri 的场景都需要使用 FileProvider ,如:

  • 调用相机拍照
  • 剪裁图片
  • 调用系统安装器去安装 Apk

3.3 如何使用 FileProvider

(1)在 AndroidManifest.xml 中声明

<provider
    android:name="androidx.core.content.FileProvider"
    android:authorities="${applicationId}.fileProvider"
    android:exported="false"
    android:grantUriPermissions="true">
    <meta-data
        android:name="android.support.FILE_PROVIDER_PATHS"
        android:resource="@xml/file_paths"/>
</provider>

可以看到,provider 标签下,配置了几个属性:

  • name:配置当前 FileProvider 的实现类。
  • authorities:配置一个 FileProvider 的名字,它在当前系统内需要是唯一值。
  • exported:表示该 FileProvider 是否需要公开出去,传 false 表示不公开。
  • granUriPermissions:是否允许授权文件的临时访问权限。传 true 表示需要 。

(2)指定可分享的文件路径

没有 xml 目录可自行创建

src/main/res/xml/file_paths.xml

<?xml version="1.0" encoding="utf-8"?>
<paths>
    <!--支持本地路径-->
    <!--表示Environment.getExternalStorageDirectory() 指向的目录-->
    <external-path name="external_storage_root" path="." />

    <!--表示 content.getFileDir() 获取到的目录-->
    <files-path name="files-path" path="." />

    <!--表示 content.getCacheDir() 获取到的目录-->
    <cache-path name="cache-path" path="." />

    <!--表示 ContextCompat.getExternalFilesDirs() 获取到的目录-->
    <external-files-path name="external_file_path" path="." />

    <!--表示 ContextCompat.getExternalCacheDirs() 获取到的目录-->
    <external-cache-path name="external_cache_path" path="." />

    <!--支持根路径-->
    <root-path name="root_path" path="" />
</paths>
TAG Value Path
TAG_ROOT_PATH root-path /
TAG_FILES_PATH files-path /data/data/<包名>/files
TAG_CACHE_PATH cache-path /data/data/<包名>/cache
TAG_EXTERNAL external-path /storage/emulate/0
TAG_EXTERNAL_FILES external-files-path /storage/emulate/0/Android/data/<包名>/files
TAG_EXTERNAL_CACHE external-cache-path /storage/emulate/0/Android/data/<包名>/cache

(3)将 file:// 转为 content://

使用 FileProvider.getUriForFile() 方法将 file:// 转为 content://

// File 转 Uri
private Uri getUriForFile(File file) {
    String packageName = getPackage(this).packageName;
    Uri contentUri = FileProvider.getUriForFile(this, packageName+".fileProvider", file);
    return contentUri;
}

// 获取当前包名
public static PackageInfo getPackage(Context context) {
    PackageManager manager = context.getPackageManager();
    try {
        PackageInfo info = manager.getPackageInfo(context.getPackageName(), 0);
        return  info;
    } catch (PackageManager.NameNotFoundException e) {
        e.printStackTrace();
        return null;
    }
}

4、参考

https://www.jianshu.com/p/c87ff5eda539

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

推荐阅读更多精彩内容