当前位置: 首页 > news >正文

详细介绍:FileProvider 配置必须针对 Android 7.0+(API 24+)做兼容

这个 FileProvider 配置必须针对 Android 7.0+(API 24+)做兼容,否则在 Android 7.0 及以上版本中,通过 file:// 路径访问文件会触发 FileUriExposedException 异常。结合你当前的项目(已适配 Android 10+),需要进一步完善 FileProvider 的配置,确保文件访问在全版本兼容。

一、为什么需要兼容?

Android 7.0 开始引入 StrictMode 安全策略,禁止应用通过 file:// 格式的 Uri 向其他应用暴露文件(如调用系统相机拍照、分享文件等场景),必须使用 content:// 格式的 Uri 替代,而 FileProvider 就是系统提供的用于生成 content:// Uri 的工具类。

你的现有配置已经有了 FileProvider 基础,但还需要补充两点:

  1. 完善 provider_paths.xml 配置(指定可共享的文件路径,适配 Android 10+ 分区存储);
  2. 在代码中通过 FileProvider 生成 Uri(替代直接使用 new File(...) 生成 file:// Uri)。

二、第一步:完善 provider_paths.xml 配置

首先在 res/xml/ 目录下创建 / 修改 provider_paths.xml必须包含 Android 10+ 分区存储下的共享路径(如应用私有目录、媒体库目录),否则高版本系统会提示 “无法访问文件”。

xml



配置说明:

路径标签对应实际路径用途
cache-path应用私有缓存目录临时文件(如缓存图片),无需权限
files-path应用私有文件目录持久化文件,无需权限
external-files-path应用外部私有目录(如 Download)Android 10+ 推荐,无需权限
external-path外部存储公共目录旧版本(Android 9-)访问公共文件
external-media-path媒体库目录Android 10+ 访问图片 / 视频 / 音频

三、第二步:修复 AndroidManifest.xml 中的 FileProvider 配置

你的现有配置中 android:authorities 建议补充包名后缀(避免与其他应用冲突),同时确保 meta-data 的 name 正确(兼容 AndroidX):

xml

android:authorities="com.nyw.anmoapp.fileprovider"android:exported="false"android:grantUriPermissions="true">android:resource="@xml/provider_paths" />

关键修改:

  • android:authorities:从 com.nyw.anmoapp 改为 com.nyw.anmoapp.fileprovider(更规范,避免冲突);
  • 确保 android:exported="false"(禁止外部应用直接访问,必须通过权限授予);
  • android:grantUriPermissions="true"(允许临时授予其他应用访问文件的权限)。

四、第三步:在代码中使用 FileProvider 生成 Uri(核心兼容逻辑)

在需要向其他应用暴露文件的场景(如调用系统相机拍照、打开本地文件、分享文件),必须通过 FileProvider.getUriForFile() 生成 content:// Uri,替代旧的 file:// Uri。

以下是 3 个常见场景的兼容代码示例:

场景 1:调用系统相机拍照(保存到应用私有目录)

java

运行

/*** 调用系统相机拍照(适配 Android 7.0+)*/
private void takePhotoWithCamera() {// 1. 创建保存照片的文件(存到应用私有缓存目录,无需权限)File photoFile = new File(getCacheDir(), "temp_photo.jpg");try {if (photoFile.exists()) {photoFile.delete();}photoFile.createNewFile();} catch (IOException e) {e.printStackTrace();return;}// 2. 生成 Uri(Android 7.0+ 用 FileProvider,低版本直接用 file://)Uri photoUri;if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {// 注意:authorities 必须和 Manifest 中配置的一致photoUri = FileProvider.getUriForFile(this,"com.nyw.anmoapp.fileprovider", // 与 Manifest 中的 android:authorities 对应photoFile);// 授予临时权限(允许相机应用访问该 Uri)grantUriPermission("com.android.camera", // 目标应用包名(相机)photoUri,Intent.FLAG_GRANT_READ_URI_PERMISSION | Intent.FLAG_GRANT_WRITE_URI_PERMISSION);} else {// Android 7.0 以下直接用 file:// UriphotoUri = Uri.fromFile(photoFile);}// 3. 启动相机Intent intent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);intent.putExtra(MediaStore.EXTRA_OUTPUT, photoUri);startActivityForResult(intent, 1001); // 1001 为拍照请求码
}

场景 2:打开本地文件(如 PDF、TXT)

java

运行

/*** 打开本地文件(适配 Android 7.0+)* @param file 要打开的文件*/
private void openLocalFile(File file) {if (!file.exists()) {Toast.makeText(this, "文件不存在", Toast.LENGTH_SHORT).show();return;}// 1. 生成 UriUri fileUri;if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {fileUri = FileProvider.getUriForFile(this,"com.nyw.anmoapp.fileprovider",file);} else {fileUri = Uri.fromFile(file);}// 2. 配置文件打开意图Intent intent = new Intent(Intent.ACTION_VIEW);intent.setDataAndType(fileUri, getMimeType(file.getAbsolutePath())); // 获取文件 MIME 类型intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);// 授予临时权限(允许目标应用访问该 Uri)intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);// 3. 启动应用打开文件try {startActivity(intent);} catch (ActivityNotFoundException e) {Toast.makeText(this, "没有找到可打开该文件的应用", Toast.LENGTH_SHORT).show();}
}
/*** 获取文件 MIME 类型*/
private String getMimeType(String filePath) {String type = null;String extension = MimeTypeMap.getFileExtensionFromUrl(filePath);if (extension != null) {type = MimeTypeMap.getSingleton().getMimeTypeFromExtension(extension.toLowerCase());}return type;
}

场景 3:配合 HttpUtils 下载文件后打开

在 HttpUtils 的 DownloadProgressListener 中,通过 FileProvider 打开下载的文件:

java

运行

HttpUtils.getInstance().download("https://example.com/test.pdf","Download","test.pdf",new HttpUtils.DownloadProgressListener() {@Overridepublic void onProgress(int progress) {// 进度更新}@Overridepublic void onSuccess(String filePath) {// 下载完成,打开文件File downloadFile = new File(filePath);openLocalFile(downloadFile); // 调用上面的 openLocalFile 方法}@Overridepublic void onFail(String errorMsg) {Toast.makeText(MainActivity.this, errorMsg, Toast.LENGTH_SHORT).show();}}
);

五、第四步:Android 10+ 特殊兼容(分区存储)

如果你的文件需要保存到外部存储公共目录(如 /storage/emulated/0/Download/),在 Android 10+ 中还需要注意:

  1. 若使用 MediaStore 保存媒体文件(图片 / 视频 / 音频),无需 WRITE_EXTERNAL_STORAGE 权限,直接通过 ContentResolver 插入即可;
  2. 若保存非媒体文件(如 PDF、TXT),在 Android 10+ 中需通过 SAF(存储访问框架) 让用户选择保存位置,或使用应用私有目录(推荐)。

总结:必须兼容的核心点

  1. provider_paths.xml 必须包含全版本路径:覆盖应用私有目录、外部存储目录、媒体库目录;
  2. Manifest 中 authorities 必须唯一:建议用 “包名 + .fileprovider” 格式;
  3. 代码中必须区分版本生成 Uri:Android 7.0+ 用 FileProvider,低版本用 Uri.fromFile
  4. 必须授予临时权限:通过 grantUriPermission 或 Intent.FLAG_GRANT_READ_URI_PERMISSION 允许其他应用访问文件。

这样配置后,你的 FileProvider 就能在 Android 7.0 到 Android 14+ 全版本中正常工作,避免 FileUriExposedException 等兼容性问题。

http://www.gsyq.cn/news/15701.html

相关文章:

  • pdf翻译
  • Microsoft Access SQL 查询中的通配符 - 详解
  • 洛谷P11738 [集训队互测 2015] 未来程序改
  • 实用指南:[创业之路-645]:手机属于通信?还是属于消费类电子?还是移动互联网?
  • ai提交消息常用的 chore,原来是个单词(琐事/零散任务)+约定,用于非功能性提交
  • 多项式定理
  • 详细介绍:Kafka09-速答-尚硅谷
  • 前端安全障碍深度解析:从原理到实践的全方位防护指南
  • node菜单服务引起的后台异常表象到运维释放从库的数据库连接及驱动修改配置,重新部署生效
  • 深入解析:从零起步学习Redis || 第四章:Cache Aside Pattern(旁路缓存模式)以及优化策略
  • 详细介绍:SpringCloud API Gateway2.0如何解决docker中应用间IP漂移的正确手法
  • 251004
  • gradle Cause: zip END header not found
  • 【性质】CF689D Friends and Subsequences
  • Arduino+数码管 = 量电压 | A+B problem | alphabet
  • 详细介绍:【数据库知识】TxSQL 主从数据库同步底层原理深度解析
  • 完整教程:AI时代如何高效学习Python:从零基础到项目实战de封神之路(2025升级版)
  • cannot resolve method add in T 及 T 泛型类型生成Excel文件,区别是数据Model不同
  • 测试环境elasticSearch数据泄露排查
  • PocoEmit遥遥领先于AutoMapper之打通充血模型的任督二脉
  • Linux基础开发工具 --- vim - 详解
  • 【Clion】【文件编码】Clion内置控制台中文字体乱码的解决方案及编码格式调整
  • Qt纯代码实现智能安防集中管理平台/楼宇对讲管理系统/门禁管理/视频监控
  • DaYe-PhotoStudio-2 v2.0.0 安装教程(64位/AMD64)详细步骤
  • 威胁狩猎实战:终端攻击行为分析与检测
  • 2024年全国大学生信息安全竞赛安徽省赛网络高效的系统建设与运维赛项-网络构建真题
  • 实用指南:基于Hadoop+Spark的人体体能数据分析与可视化系统开源实现
  • 基于Hadoop的肾脏疾病风险分析系统架构设计精髓 - 实践
  • const在for用不了
  • 某工程师入职华为,职级比较高,但还看不懂代码,有点尴尬