FileProvider的使用

本文详细解析了Android 7.0以上系统中FileProvider的使用方法,包括声明FileProvider、编写XML配置文件及如何在代码中使用FileProvider以避免FileUriExposedException。介绍了如何通过content://uri替代file://uri,以及如何通过XML文件定义虚拟路径映射到真实文件路径。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

在官方7.0的以上的系统中,尝试传递 file://URI可能会触发FileUriExposedException。

目录

  1. 第一步 声明FIleProvider
  2. 第二步 编写XML文件
  3. 第三步 使用FileProvider

第一步 声明FIleProvider

为什么要声明呢?
因为FileProvider是ContentProvider子类
注意需要设置一个meta-data,里面指向一个xml文件。

<provider
    android:name="android.support.v4.content.FileProvider"
    android:authorities="app的包名.fileProvider"
    android:grantUriPermissions="true"
    android:exported="false">
    <meta-data
        android:name="android.support.FILE_PROVIDER_PATHS"
        android:resource="@xml/file_paths" />
</provider>

第二步 编写XML文件

为什么要写这么个xml文件?
因为要使用content://uri替代file://uri,那么,content://的uri如何定义呢?总不能使用文件路径。
所以,需要一个虚拟的路径对文件路径进行映射,所以需要编写个xml文件,通过path以及xml节点确定可访问的目录,通过name属性来映射真实的文件路径。

xml文件的创建

 

//每个节点都支持两个属性:name+path
//path:需要临时授权访问的路径(.代表所有路径) 
//name:就是你给这个访问路径起个名字
<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <root-path name="root" path="" /> //代表设备的根目录new File("/");
    <files-path name="files" path="" /> //context.getFilesDir()
    <cache-path name="cache" path="" /> //context.getCacheDir()
    <external-path name="external" path="" /> //Environment.getExternalStorageDirectory()
    <external-files-path name="name" path="path" /> //context.getExternalFilesDirs()
     <external-cache-path name="name" path="path" /> //getExternalCacheDirs()
</paths>

比如

<?xml version="1.0" encoding="utf-8"?>
<paths>
 //代表的目录即为:Environment.getExternalStorageDirectory()/Android/data/包名/
    <external-path
        name="files_root"
        path="Android/data/包名/" />

 //代表的目录即为:Environment.getExternalStorageDirectory()
    <external-path
        name="external_storage_root"
        path="." />

 //代表的目录即为:Environment.getExternalStorageDirectory()/pics
    <external-path
        name="external"
        path="pics" />

</paths>

当这么声明以后,代码可以使用你所声明的当前文件夹以及其子文件夹。

第三步 使用FileProvider

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
    Uri uri = FileProvider.getUriForFile(CameraActivity.this, "app的包名.fileProvider", photoFile);
} else {
    Uri uri = Uri.fromFile(photoFile);
}

 

 

FileProvider 是一个特殊的 ContentProvider,用于在应用间共享文件。使用 FileProvider 可以避免在应用间使用 file:// URI 导致的安全问题。 要使用 FileProvider,需要进行以下步骤: 1. 在 AndroidManifest.xml 中添加 FileProvider声明: ```xml <manifest> <application> <provider android:name="androidx.core.content.FileProvider" android:authorities="your.package.name.fileprovider" android:grantUriPermissions="true" android:exported="false"> <meta-data android:name="android.support.FILE_PROVIDER_PATHS" android:resource="@xml/file_paths" /> </provider> </application> </manifest> ``` 其中,`your.package.name.fileprovider` 是你的应用的包名加上 `.fileprovider`。`@xml/file_paths` 是一个 XML 文件,用来指定 FileProvider 可以共享的文件路径。 2. 创建 file_paths.xml 文件,在其中指定 FileProvider 可以共享的文件路径。例如: ```xml <paths> <external-path name="my_images" path="Pictures/" /> </paths> ``` 上面的配置表示,FileProvider 可以共享存储卡上 Pictures 目录下的文件。可以根据需要修改 name 和 path 属性。 3. 在代码中使用 FileProvider 生成共享文件的 URI,例如: ```java File file = new File(Environment.getExternalStorageDirectory(), "Pictures/example.jpg"); Uri uri = FileProvider.getUriForFile(context, "your.package.name.fileprovider", file); ``` 上面的代码生成了一个可以共享的文件 URI,可以将其传递给其他应用。在接收共享文件的应用中,可以使用 ContentResolver 的 openInputStream 方法打开文件流,例如: ```java try (InputStream is = getContentResolver().openInputStream(uri)) { // 处理文件流 } catch (IOException e) { // 处理异常 } ``` 在使用 FileProvider 时,需要注意以下几点: - 需要为 FileProvider 授予 URI 权限。可以使用 Intent.FLAG_GRANT_READ_URI_PERMISSION 或 Intent.FLAG_GRANT_WRITE_URI_PERMISSION 标志,或者调用 ContentResolver 的 takePersistableUriPermission 方法。 - 不要在应用内部使用 FileProvider 共享文件,因为这会导致性能下降。应该直接访问文件。 - 如果要共享的文件不存在,或者没有权限访问,使用 FileProvider 可能会导致异常,需要进行异常处理。
评论 2
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值