FileProvider文件共享

关注

原创最新推荐文章于 2026-07-31 10:09:59 发布 8.4w 阅读 AI 写同款· GEO 优化 ›

Android Content URI解析：应对分区存储与厂商文件管理器的兼容性挑战在Android开发中，文件访问是一个基础且关键的技术环节。随着Android系统权限模型的演进，特别是分区存储（Scoped Storage）的引入，传统的基于绝对路径的文件操作方式发生了根本性变化。其核心原理是通过Content URI机制，将文件访问抽象为基于URI的权限令牌，从而在保障用户隐私安全的前提下，实现跨应用数据共享。这一转变带来了显著的技术价值：应用无需申请宽泛的存储权限即可访问用户授权的特定文件，同时系统能更好地管理文件生命周期。然而，在实际工程实践中，尤其是在处理用户通过系统文件管理器阅读详情

本文是在查看Android文档关于拍照与文件共享知识，看到关于FileProvider相关内容后，尝试使用并遇到一些问题时决定做的笔记。

一、FileProvider

1.FileProvider的出现

Android7.0之前，使用file://URI通常会给出该文件的全部访问权限，这是不安全的，应该只有应用自己才有权限。在7.0之后，为了更好的保护用户隐私，不再使用file://URI来提供文件的路径，而是使用content://URI。我们常做的功能中，点击头像拍照，就会用到这个方式。在API23之前，使用file://URI是没问题的，但是24之后就会抛出FileUriExposedException。当然，如果你的应用targetSdkVersion小于24，你仍可以使用这个方法，但是作为开发者，不论是出于产品对Android版本的适配，还是从技术学习角度，都要把app做好。

2.FileProvider使用步骤：

1）定义一个FileProvider

一般来说，我们不需要自定义一个FileProvider，因为Android在supportv4库中已经提供了一个android.support.v4.content.FileProvider类，只需要在manifest进行注册。

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

authorities为基于包名的权限控制，一般就是自己的包名。exported为false，不需要对外公开此provider。grantUriPermission为true，临时授予获取文件权限。meta-data中的resource指定可生成URI目录的描述文件。

2）指定可以获取的文件

FileProvider只可以对预先指定的文件夹内的文件生成content URI.上面的@xml/file_paths即为指定的目录描述。一般是在res的xml文件夹中定义该文件。名称和上面的resource中的配置一致，该例子就是file_paths.xml。

<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <files-path name="my_images" path="images/"/>
    <files-path name="my_docs" path="docs/"/>
</paths>

name为生成的contentURI中的代表指定路径的片段，path为可访问的子目录。如上述配置，生成的目录为：content：//com.example.android.fileprovider/my_images/文件名。这里有些东西要着重强调，paths内的元素，files-path有很多替换，但是每个都代表了不同的系统文件夹路径，这些会在下面列出。

3）为文件生成URI

File imagePath = new File(Context.getFilesDir(), "images");
File newFile = new File(imagePath, "default_image.jpg");
Uri contentUri = getUriForFile(getContext(), "com.mydomain.fileprovider", newFile);

之后可以将该URI放在Intent中传递给需要的地方。其他的app可以通过Content.openFileDescription来获取文件描述符。

二、URI生成与匹配遇到的问题

一般来说，主要的问题，在于上面的path与目录的匹配上，匹配不到就会抛出IllegalArgumentException: Failed to find configured root that contains /storage/emulated/0/...等异常。下面列出各种path以及匹配的获取系统目录的api。

<files-path name="name" path="path" />

对应Context.getFilesDir();

<cache-path name="name" path="path" />

对应Context.getCahceDir();

<external-path name="name" path="path" />

对应Environment.getExternalStorageDirectory();

这个着重强调一下，因为还支持Enviroment.getExternalStoragePublicDirectory(String)以及Context.getExternalFilesDir(String)。

举个栗子，比如path设置为“Android/data/com.david.study/files/DCIM”。

Contxt.getExternalFilesDir(Enviroment.DIRECTORY_DCIM)可以直接访问到，也就是可以生成URI，因为其文件夹对应的就是指定的目录；Enviroment.getExternalStoragePublicDirectory(Environment.DCIM)无法访问到，因为其目录已经在指定范围外了。Enviroment.getExternalStorageDirectory()无法直接访问到;

new File(Enviroment.getExternalStorageDirectory(), "Android/data/com.david.study/files/DCIM");可以访问到该目录。

如果path仅仅为“DCIM”,则Environment.getExternalPublicStorageDirectory(Environment.DCIM)可以访问，但Context.getExternalFilesDir(Enviroment.DIRECTORY_DCIM)访问不到，而new File(Enviroment.getExternalStorageDirectory(), "DCIM");也可以访问到。

当path=“”时，这三个任何一个都可以访问到。

听起来很乱，举个具体点的栗子

比如说你配置的filepath为

<?xml version="1.0" encoding="utf-8"?>
    <paths xmlns:android="http://schemas.android.com/apk/res/android">
        <external-path name="my_images" path="Android/data/com.example.app/files/Pictures" />
    </paths>
</xml>

或者

<?xml version="1.0" encoding="utf-8"?>
    <paths xmlns:android="http://schemas.android.com/apk/res/android">
        <external-files-path name="my_images" path="" />
    </paths> 
</xml>

或者

<?xml version="1.0" encoding="utf-8"?>
    <paths xmlns:android="http://schemas.android.com/apk/res/android">
        <external-files-path name="my_images" path="Pictures" />
    </paths>  
</xml>

之后则可以通过getExternalFilesDir(Environment.DIRECTORY_PICTURES);获得到指定的文件夹。注意根节点名称和path的区别。

为何要这么写呢，因为getExternalFilesDir(Environment.DIRECTORY_PICTURES)获取到的目录为Android/data/com.example.app/files/Pictures这个目录因此你在上面的filepath中一点要确保配置的路径能访问到这一层。

分析一下，第一个filepath就不说了，直接指定目录了，完全一致。第二三两个，根节点为external-files-path，对应目录为Android/data/com.example.app/files,只要你指定到files，就可以访问到该目录下所有文件，也包括子文件夹内的东西，当然像第三个还指定了Pictures那就更进一步限制了访问的文件地址。

如果想要访问其他的目录，其实也好处理，可以参考我列出来的几个对应的目录和节点名称，访问对应文件夹。或者要是不知道是哪个目录，你可以先看你用的获取文件夹的方法能访问到哪个目录，之后再来指定其具体的filepath。其实总结起来一句话就是，你用的方法获取的文件夹要和你指定的filepath完全对应，这样才能访问到想要的位置。

<external-files-path name="name" path="path" />

对应Context.getExternalFilesDir(String)或者Context.getExternalFilesDir(null)。

<external-cache-path name="name" path="path" />

对应Context.getExternalCacheDir();

遇到最主要的问题：如果不是对应的目录，会抛出IllegalArgumentException。

解决这个问题的要点是，文件要在该系统目录（files-path等对应的）与path属性对应的目录中。

收录于

Android training+guide 随笔

标签

#android #FileProvider

Android开发实战：content:// URI转文件路径的兼容性处理与避坑指南在Android开发中，文件访问是常见的需求，涉及文件上传、预览、分享等场景。Android系统基于沙盒安全模型，通过content:// URI机制实现应用间安全的文件共享，而非直接暴露文件系统路径。其核心原理是通过ContentResolver解析URI，获取文件描述符或输入流，从而在严格权限控制下访问文件。这一机制在保障安全的同时，也带来了技术挑战，尤其是在处理不同厂商文件管理器返回的多样化URI格式时。本文聚焦于content:// URI到真实文件路径的转换，深入剖析了Android文件访问框架，阅读详情