Android 图片选择到裁剪之步步深坑
前言
最近在自己的项目里实现了一个头像选择的功能,就是先从相册里选取一张图片再调用系统的裁剪功能来制作头像,效果就像下面这样:
本以为很小的一个功能,却远远没有我想的那样简单,可以说每一步都暗藏玄机,下面就让我带大家看看这里面究竟有哪些坑。
Android 4.4 之存储访问框架
首先,让我们从图片选择开始,使用隐式 Intent 跳转到图片选择:
private void routeToGallery() {
Intent intent = new Intent(Intent.ACTION_GET_CONTENT);
intent.addCategory(Intent.CATEGORY_OPENABLE);
intent.setType("image/*");
startActivityForResult(intent, GALLERY_REQUSET_CODE);
}
在回调中处理返回的图片,继而跳转至图片裁剪:
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
if (requestCode == GALLERY_REQUSET_CODE && resultCode == RESULT_OK) {
String path = data.getData().getPath();
Bitmap image = BitmapFactory.decodeFile(path);
File faceFile;
try {
faceFile = saveBitmap(image);
} catch (IOException e) {
e.printStackTrace();
return;
}
Uri fileUri = Uri.fromFile(faceFile);
routeToCrop(fileUri); //跳转到图片裁剪
}}private void routeToCrop(Uri uri) {
Intent intent = new Intent("com.android.camera.action.CROP");
intent.setDataAndType(uri, "image/*");
intent.putExtra("crop", true);
intent.putExtra("aspectX", 1);
intent.putExtra("aspectY", 1);
intent.putExtra("outputX", 150);
intent.putExtra("outputY", 150);
intent.putExtra("return-data", true);
startActivityForResult(intent, CROP_REQUEST_CODE);}private File saveBitmap(Bitmap bitmap) throws IOException {
File file = new File(getExternalCacheDir(), "face-cache");
if (!file.exists()) file.createNewFile();
try (OutputStream out = new FileOutputStream(file)) {
bitmap.compress(Bitmap.CompressFormat.JPEG, 100, out);
}
return file;
}
这一段代码看似正常,但问题就出在String path = data.getData().getPath();这一句。这一段代码在 Android 4.4 以下是可以正常运行的,不过从 Android 4.4 开始这里获取到的将为一个无效的路径,这是为什么呢?
Android 从 4.4 开始引入了一个概念:存储访问框架(https://developer.android.google.cn/guide/topics/providers/document-provider.html),简单来说就是 Android 提供了一个专门供用户访问资源的软件,将设备上所有可以访问资源的软件接口都整合到了一起,避免了用户只能选择一个特定软件的尴尬,在 Android 4.4 以下,我们发送刚才选取图片的隐式 Intent,效果是这样的,需要用户去选择使用哪个应用:
而从 Android 4.4 开始,就变成了这样:
直接打开一个资源选取的软件(这个软件平时是隐藏的,不会显示在软件列表中),其中包含了访问设备上所有可访问资源软件的接口,这个改变极大的提高的用户操作的便捷性。
不过这也带来了一个问题,从 Android 4.4 开始,在onActivityResult()方法的Intent中所包含的uri不再是file://类型,而是变成了content://类型,这也是为什么在 Android 4.4 以后调用data.getData.getPath()获取到的结果是无效的。因此,我们必须对 Android 4.4 以上的版本进行特殊的处理:
private void routeToGallery() {
Intent intent = new Intent(Intent.ACTION_GET_CONTENT);
intent.addCategory(Intent.CATEGORY_OPENABLE);
intent.setType("image/*");
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
startActivityForResult(intent, GALLERY_REQUSET_CODE_KITKAT);
} else {
startActivityForResult(intent, GALLERY_REQUSET_CODE);
}
}
在回调中对不同版本分别进行处理:
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
switch (requestCode) {
case GALLERY_REQUSET_CODE:
handleGalleryResult(resultCode, data);
break;
case GALLERY_REQUSET_CODE_KITKAT:
handleGalleryKitKatResult(resultCode, data);
break;
}}private void handleGalleryResult(int resultCode, Intent data) {
// 跟之前一样}// Result uri is "content://" after Android 4.4private void handleGalleryKitKatResult(int resultCode, Intent data) {
File faceFile;
try {
ParcelFileDescriptor parcelFileDescriptor =
getContentResolver().openFileDescriptor(contentUri, "r");
FileDescriptor fileDescriptor = parcelFileDescriptor.getFileDescriptor();
Bitmap image = BitmapFactory.decodeFileDescriptor(fileDescriptor);
faceFile = saveBitmap(image);
} catch (IOException e) {
e.printStackTrace();
return;
}
Uri fileUri = Uri.fromFile(faceFile);
routeToCrop(fileUri);
}
Android 7.0 之 FileProvider
完成了图片的选择功能,转眼又碰到了一个问题:
Android 为了提高私有文件的安全性,从 7.0 开始对外传递file://类型的uri会触发FileUriExposedException。因此,在分享私有文件时必须使用FileProvider。
对 Android 的这一改变还不太了解的同学可以看一下这两篇文章: Android 7.0 行为变更(https://developer.android.google.cn/about/versions/nougat/android-7.0-changes.html?hl=zh-cn) Setting Up File Sharing(https://developer.android.google.cn/training/secure-file-sharing/setup-sharing.html)
第一步
在manifest文件中加入FileProvider:
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="gavinli.translator">
<application
...>
<provider
android:name="android.support.v4.content.FileProvider"
android:authorities="gavinli.translator"
android:grantUriPermissions="true"
android:exported="false">
<meta-data
android:name="android.support.FILE_PROVIDER_PATHS"
android:resource="@xml/filepaths" />
</provider>
... </application>
</manifest>
第二步
在xml文件夹中创建filepaths.xml文件,并声明所要分享的文件目录:
<resources>
<paths>
<external-cache-path name="mycache" path="./" />
</paths>
</resources>
这里的path就代表你想要分享的文件目录,而name就是具体显示在uri中的信息,最终生成的uri就像下面这样:
这种经过处理的uri可以很好的隐藏掉实际的文件路径。
第三步
在代码中对 Android 7.0 以上的版本进行特殊处理:
private void handleGalleryKitKatResult(int resultCode, Intent data) {
...
Uri fileUri;
if(Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
// Android 7.0 "file://" uri权限适配
fileUri = FileProvider.getUriForFile(this,
"gavinli.translator", faceFile);
} else {
fileUri = Uri.fromFile(faceFile);
}
routeToCrop(fileUri);
}
这里传入的"gavinli.translator",需要与之前在manifest文件中声明的android:authorities一致。
第四步
在裁剪图片的Intent中加入对该图片的访问权限:
private void routeToCrop(Uri uri) {
Intent intent = new Intent("com.android.camera.action.CROP");
intent.setDataAndType(uri, "image/*");
// 加入访问权限
intent.addFlags(Intent.FLAG_GRANT_WRITE_URI_PERMISSION | Intent.FLAG_GRANT_READ_URI_PERMISSION);
...
}
最后一步
在回调中获取裁剪后的图片:
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
switch (requestCode) {
...
case CROP_REQUEST_CODE:
Bundle bundle = data.getExtras();
Bitmap face = bundle.getParcelable("data");
break;
}
}
Intent 的限制
你以为到这里就结束了吗?其实还远远没有。我们这里裁剪的图片是用作头像的,所以大小一般都比较小。可以当图片的大小变大后就会发现,每次裁剪后在Intent中获取到的图片其实都是缩略图。
这是因为 Android 对Intent中所包含数据的大小是有限制的,一般不能超过 1M,否则应用就会崩溃,这就是Intent中的图片数据只能是缩略图的原因。而解决的办法也很简单,我们需要给图片裁剪应用指定一个输出文件,用来存放裁剪后的图片:
private void routeToCrop(Uri uri) {
...
intent.putExtra("return-data", false);
intent.putExtra(MediaStore.EXTRA_OUTPUT, Uri.fromFile(
new File(getExternalCacheDir(), "face-cropped")));
startActivityForResult(intent, CROP_REQUEST_CODE);
}
现在,在回调中的图片就不能再直接从Intent中获取了,而是需要先拿到Intent中的uri,再使用uri进行获取,具体的过程和之前处理uri的方式一样,这里就不再赘述了。当然,直接从之前指定的文件中读取数据也是可以的。
Android 6.0 之运行时权限
不知道大家发现了没有,之前保存图片的目录都是使用的Context.getExternalCacheDir(),这个方法获取到的目录为/sdcard/Android/data/gavinli.translator/cache,是应用专属的外部存储空间,不需要声明权限。而要想使用公共的存储空间,就势必要面对一个问题:Android 6.0 的运行时权限。
首先,在manifest文件中声明读取外置存储的权限:
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="gavinli.translator">
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
...
</manifest>
之后,在代码中加入运行时的权限申请:
private void request() {
String[] permissions = {Manifest.permission.WRITE_EXTERNAL_STORAGE};
if(ContextCompat.checkSelfPermission(this, permisson)
!= PackageManager.PERMISSION_GRANTED) {
requestPermissions(permissions, REQUEST_CODE);
} else {
// 存储图片
}}public void onRequestPermissionsResult(int requestCode, String[] permissions,
int[] grantResults) {
if(requestCode == REQUEST_CODE) {
if(grantResults[i] == PackageManager.PERMISSION_GRANTED) {
// 存储图片
}
}
}
后记
到这里,这一次的踩坑之旅就全部结束了,我们也看到了 Android 这几个版本以来一步步对权限的限制,虽然这对我们的开发产生一定的影响,但只要能提高用户的使用体验,这点困难又算的了什么呢?
- file_put_contents— 将一个字符串写入文件
- 跨域请求的常用方式及解释
- 洛谷P1067 多项式输出(模拟)
- php常见的判断函数
- BZOJ 1179: [Apio2009]Atm(tarjan+SPFA)
- angularjs promise详解
- svn 文件状态标记含义
- php mail函数发送html邮件不解析,linux+postfix
- POJ 1523 SPF(tarjan求割点)
- css渲染(三)颜色与背景
- file_get_contents()函数超时处理方法
- tarjan系列算法代码小结
- JQuery处理json与ajax返回JSON实例
- angularjs 表单验证
- java教程
- Java快速入门
- Java 开发环境配置
- Java基本语法
- Java 对象和类
- Java 基本数据类型
- Java 变量类型
- Java 修饰符
- Java 运算符
- Java 循环结构
- Java 分支结构
- Java Number类
- Java Character类
- Java String类
- Java StringBuffer和StringBuilder类
- Java 数组
- Java 日期时间
- Java 正则表达式
- Java 方法
- Java 流(Stream)、文件(File)和IO
- Java 异常处理
- Java 继承
- Java 重写(Override)与重载(Overload)
- Java 多态
- Java 抽象类
- Java 封装
- Java 接口
- Java 包(package)
- Java 数据结构
- Java 集合框架
- Java 泛型
- Java 序列化
- Java 网络编程
- Java 发送邮件
- Java 多线程编程
- Java Applet基础
- Java 文档注释
- 设计模式(9)[JS版]-JavaScript设计模式之如何实现桥接模式???
- 前端基础:Boostrap
- 设计模式(10)[JS版]-JavaScript如何实现组合模式???
- JavaWeb - Servlet:基本概念,HTTP 协议,Tomcat 服务器
- 漫画:设计模式之 “工厂模式”
- 设计模式(11)[JS版]-JavaScript中的注解之装饰器模式
- JavaWeb - Servlet:重定向和转发,状态管理
- 设计模式(12)[JS版]--JavaScript必会设计模式之外观模式(Façade Pattern)
- JavaWeb - JSP:概述和语法,内置对象,JavaBean 组件,MVC 设计模式
- kill -9 导致 Kakfa 重启失败的惨痛经历!
- 图解 DataX 核心设计原理
- 不会吧不会吧,你不会还不知道这些提高JS代码质量的骚操作吧?
- Flask架站基础篇(一)--环境配置
- Flask架站基础篇(三)--Flask生成文件内容和文件夹详解
- Flask架站基础篇(四)--URL