Android FileProvider适配

FileProvider适配

概述

为了提高私有目录的安全性，防止应用信息的泄漏，从 Android 7.0 开始，应用私有目录的访问权限被做限制。具体表现为，开发人员不能够再简单地通过 file:// URI 访问其他应用的私有目录文件或者让其他应用访问自己的私有目录文件。
同时，也是从 7.0 开始，Android SDK 中的 StrictMode 策略禁止开发人员在应用外部公开 file:// URI。具体表现为，当我们在应用中使用包含 file:// URI 的 Intent 离开自己的应用时，程序会发生故障。
开发中，如果我们在使用 file:// URI 时忽视了这两条规定，将导致用户在 7.0 及更高版本系统的设备中使用到相关功能时，出现 FileUriExposedException 异常，导致应用出现崩溃闪退问题。而这两个过程的替代解决方案便是使用 FileProvider。

基本使用

声明provider

FileProvider是ContentProvider的子类，四大组件都要在AndroidManifest文件里注册

<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>

说明

• 必须设置exported="false"和grantUriPermissions="true"

编写xml文件

在res目录下新建xml目录，并在里面编写file_paths.xml

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

    <cache-path
        name="my_pic"
        path="pic" />
    <files-path
        name="pic"
        path="pic" />
</paths>

if (TAG_ROOT_PATH.equals(tag)) {
    
    
    target = DEVICE_ROOT;
} else if (TAG_FILES_PATH.equals(tag)) {
    
    
    target = context.getFilesDir();
} else if (TAG_CACHE_PATH.equals(tag)) {
    
    
    target = context.getCacheDir();
} else if (TAG_EXTERNAL.equals(tag)) {
    
    
    target = Environment.getExternalStorageDirectory();
} else if (TAG_EXTERNAL_FILES.equals(tag)) {
    
    
    File[] externalFilesDirs = ContextCompat.getExternalFilesDirs(context, null);
    if (externalFilesDirs.length > 0) {
    
    
        target = externalFilesDirs[0];
    }
} else if (TAG_EXTERNAL_CACHE.equals(tag)) {
    
    
    File[] externalCacheDirs = ContextCompat.getExternalCacheDirs(context);
    if (externalCacheDirs.length > 0) {
    
    
        target = externalCacheDirs[0];
    }
} else if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP
           && TAG_EXTERNAL_MEDIA.equals(tag)) {
    
    
    File[] externalMediaDirs = context.getExternalMediaDirs();
    if (externalMediaDirs.length > 0) {
    
    
        target = externalMediaDirs[0];
    }
}

说明

• paths节点：
  • root-path表示根目录/
  • files-path等价于context.getFilesDir() ，路径为：/data/user/0/<package_name>/files
  • cache-path等价于context.getCacheDir()，路径为：/data/user/0/<package_name>/cache
  • external-path等价于Environment.getExternalStorageDirectory()，路径为：/storage/emulated/0
  • external-files-path等价于ContextCompat.getExternalFilesDirs(context, null)
  • external-cache-path等价于ContextCompat.getExternalCacheDirs(context)
• 每个节点支持2个属性
  • name：表示路径的别名，可以通过name获取相应的路径
  • path：表示该目录下的子目录，如上面的：pic表示/data/user/0/<package_name>/cache/pic

使用FileProvider

btn.setOnClickListener {
    
    
    val intent = Intent(MediaStore.ACTION_IMAGE_CAPTURE)
    val dir = File(cacheDir, "pic")
    val file = File(dir, "my${
      
      System.currentTimeMillis()}.png")
    if (!dir.exists() && dir.isDirectory) {
    
    
        dir.mkdirs()
    }
    if (!file.exists() && dir.isFile) {
    
    
        file.createNewFile()
    }

    imgPath = file.absolutePath

    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
    
    
        uri = FileProvider.getUriForFile(this, "$packageName.fileprovider", file)
        //content://com.example.myapplication.fileprovider/my_pic/my1627454021099.png
    } else {
    
    
        uri = Uri.fromFile(file)
    }

    intent.putExtra(MediaStore.EXTRA_OUTPUT, uri)
    startActivityForResult(intent, 1)
}


override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    
    
    super.onActivityResult(requestCode, resultCode, data)
    if (requestCode == 1) {
    
    
        imageView.setImageBitmap(BitmapFactory.decodeFile(imgPath))
    }
}