当前位置: 首页 > 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.jsqmd.com/news/8179/

相关文章:

  • 题解:P14124 [SCCPC 2021] Nihongo wa Muzukashii Desu
  • 上位机知识篇---服务器脚本一直运行方法 - 详解
  • QBXT2025S Day3题
  • python+vue在线视频课程学习系统设计(源码+文档+调试+基础修改+答疑) - 详解
  • DeepSeek V3.1-Terminus、阿里 Qwen3-Max、ChatGPT Pulse 同周登场!| AI Weekly 9.22-9.28 - 实践
  • 【做题记录】CF2600左右有趣的思维题1
  • pdf翻译
  • OpenEuler 25.03 installed UKUI but cant run msedge and chrome
  • 实用指南:iPhone美区账号登录指南:轻松下载ChatGPT应用
  • 网络调整config.xml的android.mk解析
  • 【Android】RuntimeShader 应用
  • 【Rive】rive-android源码分析
  • 完整教程:基于Spring Boot的爱琴海购物公园网上商城系统的设计与实现
  • Microsoft Access SQL 查询中的通配符 - 详解
  • 洛谷P11738 [集训队互测 2015] 未来程序改
  • mcp 面试题
  • 6_什么是知识图谱
  • 实用指南:[创业之路-645]:手机属于通信?还是属于消费类电子?还是移动互联网?
  • 【开题答辩过程】以《基于SpringBoot+Vue+uni-app的智慧校园服务系统的设计与搭建》为例,不会开题答辩的可能进来看看
  • 微信ipad协议个微机器人开发API
  • 面向对象编程(OOP)的三大特性之一(封装、继承、多态)就是第八章聚焦于C++的多态(Polymorphism),这
  • ai提交消息常用的 chore,原来是个单词(琐事/零散任务)+约定,用于非功能性提交
  • 答疑解惑:无人机是否一定有主控,主控和飞控是一个东西吗,无人机是否只有飞控就可以飞行???
  • 多项式定理
  • The Brain in Your Toes: Can Tiny Foot Movements Boost BDNF and Sharpen the Mind? - 教程
  • 一直好奇无人机飞控上的SD卡槽是不是用来装系统盘的,结果发现这个其实就是个数据存储的作用,飞控板子上自带系统盘存储芯片
  • 四旋翼无人机 —— 飞控硬件推荐 —— 微空MicoAir743 V2飞控双IMU蓝牙调参 支持APM/PX4/INAV/BF固件
  • 详细介绍:OpenAI近日推出了一项名为 ChatGPT Pulse 的全新功能
  • 详细介绍:Kafka09-速答-尚硅谷
  • GPT‑5 都更新了些什么? - 实践