在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
- <manifest xmlns:android="http://schemas.android.com/apk/res/android"
- package="com.example.myapp">
- <application
- ...>
- <provider
- android:name="android.support.v4.content.FileProvider"
- android:authorities="com.example.myapp.fileprovider"
- android:grantUriPermissions="true"
- android:exported="false">
- <meta-data
- android:name="android.support.FILE_PROVIDER_PATHS"
- android:resource="@xml/filepaths" />
- </provider>
- ...
- </application>
- </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。具体如下:
- <paths xmlns:android="http://schemas.android.com/apk/res/android">
- <files-path name="my_images" path="images/"/>
- </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标记给客户端一个临时的读写权限。下面就以启动拍照程序和图片剪切程序为例
- public void startCapture() {
- Intent intent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);
- File file = new File(getFilesDir(), "images/default.jpg");
- //android 7.0以前可以fromFile得到“file://”URI
- // Uri uri = Uri.fromFile(file);
- //7.0以后必须这样
- //调用FileProvider.getUriForFile,传入Context对象,authorities(上文android:authorities设置的值)和File对象生产content URI
- Uri uri = FileProvider.getUriForFile(this, "com.example.myapp.fileprovider", file);
- //设置拍照后储存路径
- intent.putExtra(MediaStore.EXTRA_OUTPUT, uri);
- //添加FLAG_GRANT_WRITE_URI_PERMISSION标记给目标程序提供临时读写权限,改临时权限会在目标程序的任务栈结束后失效
- //如果只想要目标程序只拥有读限权,可只设置FLAG_GRANT_READ_URI_PERMISSION标记
- intent.addFlags(Intent.FLAG_GRANT_WRITE_URI_PERMISSION);
- startActivityForResult(intent,0);
- }
- public void startCrop() {
- Intent intent = new Intent("com.android.camera.action.CROP");
- File output = new File(getFilesDir(), "images/default.jpg");
- //调用FileProvider.getUriForFile,传入Context对象,authorities(上文android:authorities设置的值)和File对象生产content URI
- Uri uri = FileProvider.getUriForFile(this, "com.example.myapp.fileprovider", output);
- //设置要裁剪的图片
- intent.setDataAndType(uri, "image/*");
- intent.putExtra("crop", "true");
- //设置裁剪参数
- intent.putExtra("aspectX", 1);
- intent.putExtra("aspectY", 1);
- intent.putExtra("outputX", 200);
- intent.putExtra("outputY", 200);
- //添加临时权限标记
- intent.addFlags(Intent.FLAG_GRANT_WRITE_URI_PERMISSION);
- //设置文件输出uri
- intent.putExtra(MediaStore.EXTRA_OUTPUT, uri);
- intent.putExtra("return-data", true);
- startActivityForResult(intent, 1);
- }
当然,传递intent方法不仅是启动其他Activity,还有其他,比如其他程序用startActivityForResult启动我们的Acitivy我们可以通过setResult(int resultCode, Intent data)方法把Intent回传。这样他们在onActivityResult中就可拿到intent取出content uri了,下面看下怎么使用其他程序提供的content uri
3.客户端访问共享文件
- //假设我们已经setResult(int resultCode, Intent data)方法把content uri放到intent中,那我们可以这样获取
- @Override
- protected void onActivityResult(int requestCode, int resultCode, Intent data) {
- super.onActivityResult(requestCode, resultCode, data);
- Uri returnUri = data.getData();
- try {
- //获取ParcelFileDescriptor对象,"rw"代表可读写,"r"代表只读
- ParcelFileDescriptor pfd = getContentResolver().openFileDescriptor(returnUri, "rw");
- //获取FileDescriptor对象
- if (pfd != null) {
- FileDescriptor fd = pfd.getFileDescriptor();
- //获取文件输入输出流,这样我们就可操作共享文件了
- FileOutputStream fos = new FileOutputStream(fd);
- FileInputStream fis = new FileInputStream(fd);
- }
- } catch (FileNotFoundException e) {
- e.printStackTrace();
- }
- }
至此本文完,相信调用系统照相和图片剪切出现的FileUriExposedException崩溃的问题可以解决了吧