android 7.0以上共享文件（解决调用系统照相和图片剪切出现的FileUriExposedException崩溃问题）

时间：2023-03-08 16:54:00

在android7.0开始试共享“file://”URI 将会导致引发 FileUriExposedException。 如果应用需要与其他应用共享私有文件，则应该使用 FileProvider， FileProvider的 getUriForFile() 方法可以产生一个文件的content URI, FLAG_GRANT_READ_URI_PERMISSION,FLAG_GRANT_WRITE_URI_PERMISSION标记可以给客户端一个指定文件的临时访问权限。下面内容将一步步介绍FileProvider的使用

 1.注册FileProvider并配置共享路径

FileProvider是实现了ContentProvider的一个子类，其实也就是一个ContentProvider，首先必须在清单文件中用 <provider> 注册FileProvider

  1. <manifest xmlns:android="http://schemas.android.com/apk/res/android"
  2. package="com.example.myapp">
  3. <application
  4. ...>
  5. <provider
  6. android:name="android.support.v4.content.FileProvider"
  7. android:authorities="com.example.myapp.fileprovider"
  8. android:grantUriPermissions="true"
  9. android:exported="false">
  10. <meta-data
  11. android:name="android.support.FILE_PROVIDER_PATHS"
  12. android:resource="@xml/filepaths" />
  13. </provider>
  14. ...
  15. </application>
  16. </manifest>

其中android:name指的是provider的全名，这里就也就是FileProvider。 android:authorities这个属性很重要，他的设置的值就是下面我们用FileProvider为文件生产的content URI的授权部分（content URI包含授权部分和路径部分，如content://user_dictionary/words，user_dictionary是授权部分，words是路径部分），在代码中getUriForFile()是就会用到它，它的命名规范一般是 应用包名.fileprovider（如上的com.example.myapp.fileprovider）。 android:grantUriPermissions代表该FileProvider是否有权生成content URI,第二个重要的是  <meta-data>标签下的内容，android:name="android.support.FILE_PROVIDER_PATHS"是固定的，指示我们要共享的文件路径，android:resource指定了一xml配置文件（如上则是filepaths.xml，注意在设置android:resourc不要加.xml后缀），在该配置文件中定了要共享文件的映射，该配置文件的路径是res/xml/filepaths.xml。具体如下：

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

根标签是paths标签，<paths>标签可以是一下子标签的一个或几个
<files-path name="name" path="path" />                <files-path>标签代表Context#getFilesDir()返回目录
<cache-path name="name" path="path" />                <files-path>标签代表Context#getCacheDir()返回目录
<external-path name="name" path="path" />             <files-path>标签代表Environment.getExternalStorageDirectory()返回目录
<external-files-path name="name" path="path" />       <files-path>标签代表Context#getExternalFilesDir(null)返回目录
<external-cache-path name="name" path="path" />       <files-path>标签代表 Context#getExternalCacheDir()返回目录
上面的代码中就是把Context#getFilesDir()/imges/路径映射到my_images虚拟路径中用于共享文件，这样我们如果想用共享
该路径下的default_image.jpg文件时，用FileProvider为该文件生成的content URI就是长这样的：content://com.example.myapp.fileprovider/my_images/default_image.jpg，com.example.myapp.fileprovider为android:authorities设的值，my_images就是路径部分了。

2.在代码中用FileProvider实现文件共享
共享的文件的content URI是通过Intent配合FLAG_GRANT_READ_URI_PERMISSION标记传出去的,FLAG_GRANT_READ_URI_PERMISSION,FLAG_GRANT_WRITE_URI_PERMISSION标记给客户端一个临时的读写权限。下面就以启动拍照程序和图片剪切程序为例

  1. public void startCapture() {
  2. Intent intent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);
  3. File file = new File(getFilesDir(), "images/default.jpg");
  4. //android 7.0以前可以fromFile得到“file://”URI
  5. // Uri uri = Uri.fromFile(file);
  6. //7.0以后必须这样
  7. //调用FileProvider.getUriForFile，传入Context对象，authorities(上文android:authorities设置的值)和File对象生产content URI
  8. Uri uri = FileProvider.getUriForFile(this, "com.example.myapp.fileprovider", file);
  9. //设置拍照后储存路径
  10. intent.putExtra(MediaStore.EXTRA_OUTPUT, uri);
  11. //添加FLAG_GRANT_WRITE_URI_PERMISSION标记给目标程序提供临时读写权限，改临时权限会在目标程序的任务栈结束后失效
  12. //如果只想要目标程序只拥有读限权，可只设置FLAG_GRANT_READ_URI_PERMISSION标记
  13. intent.addFlags(Intent.FLAG_GRANT_WRITE_URI_PERMISSION);
  14. startActivityForResult(intent,0);
  15. }
  16. public void startCrop() {
  17. Intent intent = new Intent("com.android.camera.action.CROP");
  18. File output = new File(getFilesDir(), "images/default.jpg");
  19. //调用FileProvider.getUriForFile，传入Context对象，authorities(上文android:authorities设置的值)和File对象生产content URI
  20. Uri uri = FileProvider.getUriForFile(this, "com.example.myapp.fileprovider", output);
  21. //设置要裁剪的图片
  22. intent.setDataAndType(uri, "image/*");
  23. intent.putExtra("crop", "true");
  24. //设置裁剪参数
  25. intent.putExtra("aspectX", 1);
  26. intent.putExtra("aspectY", 1);
  27. intent.putExtra("outputX", 200);
  28. intent.putExtra("outputY", 200);
  29. //添加临时权限标记
  30. intent.addFlags(Intent.FLAG_GRANT_WRITE_URI_PERMISSION);
  31. //设置文件输出uri
  32. intent.putExtra(MediaStore.EXTRA_OUTPUT, uri);
  33. intent.putExtra("return-data", true);
  34. startActivityForResult(intent, 1);
  35. }

当然，传递intent方法不仅是启动其他Activity，还有其他，比如其他程序用startActivityForResult启动我们的Acitivy我们可以通过setResult(int resultCode, Intent data)方法把Intent回传。这样他们在onActivityResult中就可拿到intent取出content uri了，下面看下怎么使用其他程序提供的content uri

3.客户端访问共享文件

  1. //假设我们已经setResult(int resultCode, Intent data)方法把content uri放到intent中，那我们可以这样获取
  2. @Override
  3. protected void onActivityResult(int requestCode, int resultCode, Intent data) {
  4. super.onActivityResult(requestCode, resultCode, data);
  5. Uri returnUri = data.getData();
  6. try {
  7. //获取ParcelFileDescriptor对象，"rw"代表可读写，"r"代表只读
  8. ParcelFileDescriptor pfd = getContentResolver().openFileDescriptor(returnUri, "rw");
  9. //获取FileDescriptor对象
  10. if (pfd != null) {
  11. FileDescriptor fd = pfd.getFileDescriptor();
  12. //获取文件输入输出流，这样我们就可操作共享文件了
  13. FileOutputStream fos = new FileOutputStream(fd);
  14. FileInputStream fis = new FileInputStream(fd);
  15. }
  16. } catch (FileNotFoundException e) {
  17. e.printStackTrace();
  18. }
  19. }

至此本文完，相信调用系统照相和图片剪切出现的FileUriExposedException崩溃的问题可以解决了吧