FileProvider
我对FileProvider的理解
如下:
android7.0开始,不再允许在app之间,使用file://的方式传递File,否则会抛出FileUriExposedException异常
1,可以使用FileProvider,content://解决这个问题
2,也可以把targetSdkVersion小于24(<7.0),但我相信不会有人这样做
FileProvider是ContentProvider的子类,所以需要在 AndroidManifest.xml中配置,使用ContentProvider可以向其他的app分享数据
FileProvider可将这些数据转换成File文件
1,AndroidManifest.xml中配置FileProvider(可配置多个)
name:配置的是FileProvider实现类,这里使用的系统的是v4包下( name就是指定FileProvider
对于一个 App Module 而言,如果只是自己使用,可以直接使用 v4 包下的 FileProvider ,但是如果是作为一个 Lib Module 来供其他项目使用,最好还是重新空继承一个 FileProvider ,这里填写我们的继承类即可。)
authorities:配置一个 FileProvider 的名字,它在当前系统内需要是唯一值(一般使用包名)。
exported:表示 FileProvider 是否需要公开出去
granUriPermissions:表示是否授权文件的临时访问权限
meta-data指定FileProvider提供出去的路径
name:固定写法
resource指定了一个xml文件夹下的的filepaths文件,文件里面配置了路径(这里是在res下面新建了一个xml文件夹,并且xml中新建一个filepaths.xml)
filepaths的xml文件
如下:
paths必须最少都要配置一个XXXXXX-path标签,而这个标签其实表示的是一个路径
在FileProvider的类中可以看到
标签的类型如下:
private static final String TAG_ROOT_PATH = “root-path”;
private static final String TAG_FILES_PATH = “files-path”;
private static final String TAG_CACHE_PATH = “cache-path”;
private static final String TAG_EXTERNAL = “external-path”;
private static final String TAG_EXTERNAL_FILES = “external-files-path”;
private static final String TAG_EXTERNAL_CACHE = “external-cache-path”;
在parsePathStrategy就可以看到所代表的路径
private static PathStrategy parsePathStrategy(Context context, String authority)
throws IOException, XmlPullParserException {
final SimplePathStrategy strat = new SimplePathStrategy(authority);
final ProviderInfo info = context.getPackageManager()
.resolveContentProvider(authority, PackageManager.GET_META_DATA);
final XmlResourceParser in = info.loadXmlMetaData(
context.getPackageManager(), META_DATA_FILE_PROVIDER_PATHS);
if (in == null) {
throw new IllegalArgumentException(
"Missing " + META_DATA_FILE_PROVIDER_PATHS + " meta-data");
}
int type;
while ((type = in.next()) != END_DOCUMENT) {
if (type == START_TAG) {
final String tag = in.getName();
final String name = in.getAttributeValue(null, ATTR_NAME);
String path = in.getAttributeValue(null, ATTR_PATH);
File target = null;
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];
}
}
if (target != null) {
strat.addRoot(name, buildPath(target, path));
}
}
}
return strat;
}
明显,我的path标签如下:表示的是外部存储
if (TAG_EXTERNAL.equals(tag)) {
target = Environment.getExternalStorageDirectory();
}
好这里都配置好了,那就开始使用了喔,使用getUriForFile获取需要使用的Uri,参数就是一个context,authorities(配置一个 FileProvider 的名字,它在当前系统内需要是唯一值),然后需要一个文件
public static Uri getUriForFile(Context context, String authority, File file) {
final PathStrategy strategy = getPathStrategy(context, authority);
return strategy.getUriForFile(file);
}
调用此方法,会自动得到一个 file:// 转换成 content:// 的 一个 Uri 对象,可以供我们直接使用。
配置 provider 标签的时候,有一个属性 android:grantUriPermissions=“true” ,它表示允许它授予 Uri 临时的权限。
当我们生成出一个 content:// 的 Uri 对象之后,其实也无法对其直接使用,还需要对这个 Uri 接收的 App 赋予对应的权限才可以。
这个授权的动作,提供了两种方式来授权
使用 Context.grantUriPermission() 为其他 App 授予 Uri 对象的访问权限
toPackage :表示授予权限的 App 的包名。
uri:授予权限的 content:// 的 Uri。
modeFlags:前面提到的读写权限。
这种情况下,授权的有效期限,从授权一刻开始,截止于设备重启或者手动调用 Context.revokeUriPermission() 方法,才会收回对此 Uri 的授权
配合 Intent.addFlags() 授权。
既然这是一个 Intent 的 Flag,Intent 也提供了另外一种比较方便的授权方式,那就是使用 Intent.setFlags() 或者 Intent.addFlag 的方式
intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
intent.addFlags(Intent.FLAG_GRANT_WRITE_URI_PERMISSION);
Intent.addFlags() 的方式,一旦授权将无法主动回收
拥有了授权权限的 content:// 的 Uri 之后,就可以通过 startXxx 或者 setResult() 的方式,将 Uri 传递给其他的 App
简单例子:
String path = Environment.getExternalStorageDirectory().getAbsolutePath()
+ File.separator +“ImageDir / img.png”
File imgFile = new File(path);
if (!imgFile.getParentFile().exists())
imgFile.getParentFile().mkdirs();
if (null != imgFile) {
Uri photoUri;
Intent takePhotoIntent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);
takePhotoIntent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);
if (Build.VERSION.SDK_INT <= Build.VERSION_CODES.M) {
photoUri = Uri.fromFile(imgFile);
} else {
/**
* 7.0 调用系统相机拍照不再允许使用Uri方式,应该替换为FileProvider
* 并且这样可以解决MIUI系统上拍照返回size为0的情况
*/
photoUri = FileProvider.getUriForFile(context, context.getPackageName() + ".provider", imgFile);
}
takePhotoIntent.putExtra(MediaStore.EXTRA_OUTPUT, photoUri);
context.startActivityForResult(takePhotoIntent, REQUESTCODE);
}
<paths>
<external-path path="images/imghead/" name="photos" />
</paths>
external-path中的name表示什么呢?
<provider
android:name="android.support.v4.content.FileProvider"
android:authorities="${applicationid}.fileprovider"
android:grantUriPermissions="true"
android:exported="false">
<meta-data
android:name="android.support.FILE_PROVIDER_PATHS"
android:resource="@xml/filepaths" />
</provider>
如果:
Environment.getExternalStorageDirectory() 等于 “/storage/emulated/0”
android系统 会把/storage/emulated/0/images/imghead/
映射到content://(authorities字段的值)/name/
假如:
(authorities字段的值) = “com.android.www”
name = photos
拼接起来:content://com.android.www/photos/
如果发现有错,望告知!!!!