Android笔记系列--Camera_FileProvider
源码例子：
https://github.com/StarsAaron/CameraDemo/tree/master
FileProvider
在Android7.0版本上，Android系统强制执行了StrictMode API 政策，禁止向你的应用外公开File://URI。如果一项包含文件File://URI类型的Intent离开你的应用，应用失败，并出现FileUriExposedException，比如系统相机拍照，裁剪照片。
使用FileProvider
FileProvider继承于ContentProvider，所以我们需要在manifest中注册Provider
1) 在manifest里注册provider
<application
...>
<provider
android:name="android.support.v4.content.FileProvider"
android:authorities="${applicationId}.provider"
android:exported="false"
android:grantUriPermissions="true">
<meta-data
android:name="android.support.FILE_PROVIDER_PATHS"
android:resource="@xml/file_paths"/>
provider>
application>- authorities：标识provider 一般由 [packageName/applicationId + 自定义名称] 命名
- exported：要求必须为false，具体信息不在本文讨论
- grantUriPermissions：是否授予Uri临时访问权限
- meta-data：定义FileProvider所授权的资源路径
exported必须要求为false，为true则会报安全异常。grantUriPermissions为true，表示授予URI临时访问权限。
2) 指定共享目录
res\ xml\ file_paths.xml
<paths xmlns:android="http://schemas.android.com/apk/res/android">
<files-path path="Android/data/com.example.package.name/files/Pictures/OriPicture/" name="images" />
<external-path path="Android/data/com.example.package.name/files/Pictures/OriPicture/" name="images" />
<external-files-path path="files/Pictures/OriPicture" name="images"/>
<root-path path="" name="images"/>
paths>中可以定义以下子节点
| 子节点 | 对应路径 |
|---|---|
| files-path | Context.getFilesDir() |
| cache-path | Context.getCacheDir() |
| external-path | Environment.getExternalStorageDirectory() |
| external-files-path | Context.getExternalFilesDir(null) |
| external-cache-path | Context.getExternalCacheDir() |
file://到content://的转换规则：
- 替换前缀：把file://替换成content://${android:authorities}。
- 匹配和替换
- 遍历的子节点，找到最大能匹配上文件路径前缀的那个子节点。
- 用path的值替换掉文件路径里所匹配的内容。
- 文件路径剩余的部分保持不变。
file:///data/data/com.xxx/files/images/2016/pic.png
->
content://android:authorities
+
"images/" name="my_images"/>
->
content://com.xxx.fileprovider/my_images/2016/pic.png 需要注意的是，文件的路径必须包含在xml中，也就是2.1中必须能找到一个匹配的子节点，否则会抛出异常：java.lang.IllegalArgumentException
在打开相册的需求时，有的手机厂商会在系统根目录放入一些图像来供用户体验，所有当你选择了这些就会出现onFileUriExposed的异常，所以建议加上root-path标签
3) 使用FileProvider
FileProvider.getUriForFile(this, getPackageName() + “.provider”, oriPhotoFile);
有两种设置文件访问权限
- 调用Context.grantUriPermission(package, uri, modeFlags)。这样设置的权限只有在手动调用Context.revokeUriPermission(uri, modeFlags)或系统重启后才会失效。
注意：如果manifest.xml没有定义android:grantUriPermissions=”true”或者定义为”false”,都需要在代码中动态定义
List resInfoList = getPackageManager().queryIntentActivities(intent, PackageManager.MATCH_DEFAULT_ONLY);
for (ResolveInfo resolveInfo : resInfoList) {
String packageName = resolveInfo.activityInfo.packageName;
grantUriPermission(packageName, imgUriOri, Intent.FLAG_GRANT_WRITE_URI_PERMISSION | Intent.FLAG_GRANT_READ_URI_PERMISSION);
} - 调用Intent.setFlags()来设置权限。权限失效的时机：接收Intent的Activity所在的stack销毁时。
intent.setFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION | Intent.FLAG_GRANT_WRITE_URI_PERMISSION);第一个是根据File获取FileProvider管理的Uri，第二个是对Intent授予读写私有目录的权限。
打开系统相册的Action有三种：
setType(“image/*”)情况下：
- ACTION_PICK ：直接打开图库，优点是不会出现类型混乱的情况，缺点仅能打开图库而不能从其他路径中获取资源且界面较单一。-
- ACTION_GET_CONTENT：4.4以下的版本打开的是缩略图的图库，4.4以上是可选择的页面(图库/图像选择器)。-
- ACTION_OPEN_DOCUMENT：直接打开图像选择器，不可以在4.4以下使用。(官方建议4.4+使用此Action)。
从图库选择图像返回的Uri：
<7.0 ：content://media/external/images/media/…
>7.0 ：content://com.android.providers.media.documents/document/image…从图像选择器选择图像返回的Uri：
<4.4 ：不可打开图像选择器
4.4 - 7.0 ：content://media/external/images/media/…
>7.0 ：content://com.android.providers.media.documents/document/image…content://media/external/images/media/35144
这种格式，转换成路径后可以直接用
content://com.android.providers.media.documents/document/image%3A35144
这种格式，转换成路径后不能直接用。
坑
坑1：4.4+ 系统打开相册的不同Action
坑2 ：6.0+ 动态权限适配
坑3：7.0+ FileProvider对设备内容Uri的处理
坑4：小米手机的FileProvider共享目录配置(也可以说根目录下的资源文件目录配置)
打开相机
添加权限，6.0需要动态权限申请
<uses-feature android:name="android.hardware.camera"/>
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS" />private void openCamera() {
Intent intent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);// 打开相机
File oriPhotoFile = null;
try {
oriPhotoFile = createOriImageFile();
} catch (IOException e) {
e.printStackTrace();
}
if (oriPhotoFile != null) {
if (Build.VERSION.SDK_INT < Build.VERSION_CODES.N) {
imgUriOri = Uri.fromFile(oriPhotoFile);
} else {
imgUriOri = FileProvider.getUriForFile(this, getPackageName() + ".provider", oriPhotoFile);
}
intent.setFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION | Intent.FLAG_GRANT_WRITE_URI_PERMISSION);
intent.putExtra(MediaStore.EXTRA_OUTPUT, imgUriOri);
startActivityForResult(intent, REQUEST_OPEN_CAMERA);
// 动态grant权限
// 如果在xml中已经定义android:grantUriPermissions="true"
// 则只需要intent.setFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION | Intent.FLAG_GRANT_WRITE_URI_PERMISSION);即可
// List resInfoList = getPackageManager().queryIntentActivities(intent, PackageManager.MATCH_DEFAULT_ONLY);
// for (ResolveInfo resolveInfo : resInfoList) {
// String packageName = resolveInfo.activityInfo.packageName;
// grantUriPermission(packageName, imgUriOri, Intent.FLAG_GRANT_WRITE_URI_PERMISSION | Intent.FLAG_GRANT_READ_URI_PERMISSION);
// }
Log.i(TAG, "openCamera_imgPathOri:" + imgPathOri);
Log.i(TAG, "openCamera_imgUriOri:" + imgUriOri.toString());
}
} 打开相册
private void openGallery() {
Intent intent = new Intent();
if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.KITKAT) {//4.4及以上
intent.setAction(Intent.ACTION_OPEN_DOCUMENT);
} else {//4.4 以下
intent.setAction(Intent.ACTION_GET_CONTENT);
// intent.setAction(Intent.ACTION_PICK);
}
intent.setType("image/*");
startActivityForResult(intent, REQUEST_OPEN_GALLERY);
}裁剪图片
public void cropPhoto(Uri uri) {
Intent intent = new Intent("com.android.camera.action.CROP");
File cropPhotoFile = null;
try {
cropPhotoFile = createCropImageFile();
} catch (IOException e) {
e.printStackTrace();
}
if (cropPhotoFile != null) {
// if (Build.VERSION.SDK_INT < Build.VERSION_CODES.N) {
// imgUriCrop = Uri.fromFile(cropPhotoFile);
// }else{
// imgUriCrop = FileProvider.getUriForFile(this, getPackageName() + ".provider", cropPhotoFile);
// }
//7.0 安全机制下不允许保存裁剪后的图片
//所以仅仅将File Uri传入MediaStore.EXTRA_OUTPUT来保存裁剪后的图像
imgUriCrop = Uri.fromFile(cropPhotoFile);
intent.setDataAndType(uri, "image/*");
intent.putExtra("crop", true);
intent.putExtra("aspectX", 1);
intent.putExtra("aspectY", 1);
intent.putExtra("outputX", 300);
intent.putExtra("outputY", 300);
intent.putExtra("return-data", false);
intent.putExtra(MediaStore.EXTRA_OUTPUT, imgUriCrop);
intent.setFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION | Intent.FLAG_GRANT_WRITE_URI_PERMISSION);
startActivityForResult(intent, REQUEST_CROP_PHOTO);
}
}| 附加选项 | 数据类型 | 描述 |
|---|---|---|
| crop | String 发送裁剪信号 | |
| aspectX | int | X方向上的比例 |
| aspectY | int | Y方向上的比例 |
| outputX | int | 裁剪区的宽 |
| outputY | int | 裁剪区的高 |
| scale | boolean | 是否保留比例 |
| return-data | boolean | 是否将数据保留在Bitmap中返回 |
| data | Parcelable | 相应的Bitmap数据 |
| circleCrop | String | 圆形裁剪区域？ |
| MediaStore.EXTRA_OUTPUT (“output”) | URI | 将URI指向相应的file:///… |
| outputFormat | String | 输出格式，一般设为Bitmap格式：Bitmap.CompressFormat.JPEG.toString() |
| noFaceDetection | boolean | 是否取消人脸识别功能 |
return-data:是将结果保存在data中返回，在onActivityResult中，直接调用intent.getdata()就可以获取值了，这里设为fase，就是不让它保存在data中
MediaStore.EXTRA_OUTPUT：由于我们不让它保存在Intent的data域中，但我们总要有地方来保存我们的图片啊，这个参数就是转移保存地址的，对应Value中保存的URI就是指定的保存地址。至于这两个参数能不能同时设为输出，这个我也不清楚……
实际数据：
camera content://com.danielfu.camerademo.provider/images/storage/emulated/0/Android/data/com.danielfu.camerademo/files/Pictures/OriPicture/HomePic_20180126_163642902806005.jpg
gallery
content://com.android.providers.media.documents/document/image%3A126047
/storage/emulated/0/tencent/MicroMsg/WeiXin/wx_camera_1516844243127.jpg
crop
file:///storage/emulated/0/Android/data/com.danielfu.camerademo/files/Pictures/CropPicture/HomePic_20180126_1637511666324121.jpg