FileProvider是android 7.0出来的新东西,2017开始应该会出现越来越多的7.0机器,所以做好7.0的适配工作也是很有必要的,别到时候出现一堆异常崩溃。在网上搜索FileProvider发现都大同小异,关键是没有get到G点,而且废话一大堆,于是自己看了一下官方文档,发现just so so。
参考官方文档:https://developer.android.google.cn/reference/android/support/v4/content/FileProvider.html
一、FileProvider使用在什么地方
A content URI allows you to grant read and write access using temporary access permissions. When you create an Intent containing a content URI, in order to send the content URI to a client app, you can also call Intent.setFlags() to add permissions. These permissions are available to the client app for as long as the stack for a receiving Activity is active. For an Intent going to a Service, the permissions are available as long as the Service is running.
使用临时授权的方式允许读写content URI。当你创建一个Intent包含content URI,为了发送content URI给其他app,使用Intent.setFlags()添加权限。其他app的activity栈只要是活动的,就能访问权限,service也一样。
二、使用FileProvider步骤
1、定义一个FileProvider
<manifest>
...
<application>
...
<provider
android:name="android.support.v4.content.FileProvider"
android:authorities="com.mydomain.fileprovider"
android:exported="false"
android:grantUriPermissions="true">
...
</provider>
...
</application>
</manifest>
name可以使用系统定义的 android.support.v4.content.FileProvider,也可重写FileProvider methods。authorities使用命名空间domain +"fileprovider"的方式,domain可以自定义。
2、指定可用的文件
在res/xml/file_paths.xml目录下创建新文件,内容如下:
<paths xmlns:android="http://schemas.android.com/apk/res/android">
<files-path name="my_images" path="images/"/>
...
</paths>
FileProvider的路径必须是先前指定的。
<files-path name="name" path="path" />
对应Context.getFilesDir().
<cache-path name="name" path="path" />
对应getCacheDir()
<external-path name="name" path="path" />
对应Environment.getExternalStorageDirectory()
<external-files-path name="name" path="path" />
对应Context#getExternalFilesDir(String) Context.getExternalFilesDir(null)
<external-cache-path name="name" path="path" />
对应Context.getExternalCacheDir()。
可以定义多个:
<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>
修改第一步中的provider,添加 <meta-data>,android:resource对应我们新建的文件
<provider
android:name="android.support.v4.content.FileProvider"
android:authorities="com.mydomain.fileprovider"
android:exported="false"
android:grantUriPermissions="true">
<meta-data
android:name="android.support.FILE_PROVIDER_PATHS"
android:resource="@xml/file_paths" />
</provider>
3、生成一个文件的Content URI
File imagePath = new File(Context.getFilesDir(), "images");
File newFile = new File(imagePath, "default_image.jpg");
Uri contentUri = getUriForFile(getContext(), "com.mydomain.fileprovider", newFile);
getUriForFile()方法返回 content URI,值为content://com.mydomain.fileprovider/my_images/default_image.jpg,注意参数"com.mydomain.fileprovider"和第一步定义的参数一致。
4、为URI临时授权
Intent i = new Intent(android.provider.MediaStore.ACTION_IMAGE_CAPTURE);
i.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION | Intent.FLAG_GRANT_WRITE_URI_PERMISSION);
i.putExtra("xxx", imageFileUri);
把content URI 放到Intent中的setData().
Intent.setFlags()值为 FLAG_GRANT_READ_URI_PERMISSION 或者 FLAG_GRANT_WRITE_URI_PERMISSION或者全部.
5、服务一个Content URI到另一个App
startActivity或者startActivityForResult
三、注意事项
The subdirectory you're sharing. While the name attribute is a URI path segment, the path value is an actual subdirectory name. Notice that the value refers to a subdirectory, not an individual file or files. You can't share a single file by its file name, nor can you specify a subset of files using wildcards.
不能直接分享单个文件或者多个文件路径,必须是子目录(文件夹?)