在制作自己的一款 APP 的时候，头像上传部分需要实现用户选择一张图片（可以是拍照，也可以是图库选择），然后进行裁剪上传的步骤。
根据网络上的方法写完，发现自己的机子运行很正常，但是 MIUI 不是调用不起系统裁剪，就是裁剪后保存不了文件。
无奈之下，用上了第三方裁剪框架 uCrop ，解决了。
本文可能有不少疏忽的地方，非常欢迎指出~。
所需要的框架
因为LitePal和MobSDK都需要对Application进行修改，所以最好实现自己的Application：
- EasyPermissions（负责处理运行时权限的处理）
添加依赖：
dependencies {
implementation 'pub.devrel:easypermissions:2.0.0'
}
- uCrop（一个图片裁剪框架）
添加仓库：
allprojects {
repositories {
jcenter()
maven { url "https://jitpack.io" }
}
}
添加依赖：
dependencies {
implementation 'com.github.yalantis:ucrop:2.2.2'
}
并且在 AndroidManifest.xml 中加上：
<activity
android:name="com.yalantis.ucrop.UCropActivity"
android:screenOrientation="portrait"
android:theme="@style/Theme.AppCompat.Light.NoActionBar"/>
关键代码
运行时权限+对话框选择是拍照还是选择照片
Android6.0后，调用相机以及写入存储文件需要运行时申请权限，这里采用了 Google 官方的 EasyPermissions 框架来简化权限申请步骤。
private var avatarFileName = "avatar.jpg"
private var avatarOriginFileName = "avatarOrigin.jpg"
companion object {
private const val RC_CAMERA = 200
private const val CHOOSE_PICTURE = 0
private const val TAKE_PICTURE = 1
}
override fun onRequestPermissionsResult(requestCode: Int, permissions: Array<String>, grantResults: IntArray) {
super.onRequestPermissionsResult(requestCode, permissions, grantResults)
EasyPermissions.onRequestPermissionsResult(requestCode, permissions, grantResults, this)
}
/**
* 显示修改图片的对话框
*/
@AfterPermissionGranted(RC_CAMERA)
fun showChoosePicDialog() {
val builder = android.app.AlertDialog.Builder(this)
builder.setTitle("修改头像")
val items = arrayOf("选择本地照片", "拍照")
builder.setNegativeButton("取消", null)
builder.setItems(items) { _, which ->
when (which) {
0 // 选择本地照片
-> {
val perms = arrayOf(Manifest.permission.WRITE_EXTERNAL_STORAGE)
if (EasyPermissions.hasPermissions(this, *perms)) {
val intent = Intent(Intent.ACTION_PICK)//返回被选中项的URI
intent.setDataAndType(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, "image/*")//得到所有图片的URI
startActivityForResult(intent, CHOOSE_PICTURE)
} else {
EasyPermissions.requestPermissions(this, "需要文件写入权限", RC_CAMERA, *perms)
}
}
1 // 拍照
-> {
val perms = arrayOf(Manifest.permission.WRITE_EXTERNAL_STORAGE, Manifest.permission.CAMERA)
if (EasyPermissions.hasPermissions(this, *perms)) {
val openCameraIntent = Intent(MediaStore.ACTION_IMAGE_CAPTURE)
val file = getAvatarFile(avatarOriginFileName)
if(file.exists())
file.delete()
val fileUri = getUriByOsVersion(file)
openCameraIntent.putExtra(MediaStore.EXTRA_OUTPUT, fileUri)
openCameraIntent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION)
openCameraIntent.addFlags(Intent.FLAG_GRANT_WRITE_URI_PERMISSION)
startActivityForResult(openCameraIntent, TAKE_PICTURE)
}
else{
EasyPermissions.requestPermissions(this, "拍照需要系统摄像头权限授权和文件写入权限", RC_CAMERA, *perms)
}
}
}
}
builder.show()
}
对选择、裁剪成功等返回结果的处理
Android7.0 对 APP 内的文件共享做了限制，外部不能直接访问你的内部文件。
这里需要用到FIleProvier，具体的FileProvider的配置在下一小节。
public override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
super.onActivityResult(requestCode, resultCode, data)
if (resultCode == Activity.RESULT_OK) {
when (requestCode) {
// 对拍照返回的图片进行裁剪处理
TAKE_PICTURE -> {
val imgUriSel = getUriByOsVersion(getAvatarFile(avatarOriginFileName))
cutImageByuCrop(imgUriSel)
}
// 对在图库选择的图片进行裁剪处理
CHOOSE_PICTURE -> cutImageByuCrop(data?.data)
// 上传裁剪成功的文件
UCrop.REQUEST_CROP -> {
data?.let { uploadFile(it) }
}
// 输出裁剪
UCrop.RESULT_ERROR -> {
val cropError = data?.let { UCrop.getError(it) }
ToastUtils.showShortToast(cropError.toString())
}
}
}
}
使用uCrop框架对指定的文件进行裁剪
uCrop 是一款很优秀的第三方裁剪框架，Bilibili的客户端也在使用。
一开始调用系统的裁剪的时候，出现过各种坑（比如MIUI用return-data的方式调用会报错，不用return-data有时候又拿不到返回值），于是才换用了这个。
private fun cutImageByuCrop(uri: Uri?) {
val outputImage = getAvatarFile(avatarFileName)
val outputUri = Uri.fromFile(outputImage)
uri?.let {
UCrop.of(it, outputUri)
.withAspectRatio(1f, 1f)
.withMaxResultSize(256, 256)
.start(this)
}
}
一个获得指定名字的[File]对象的私有方法
private fun getAvatarFile(filename:String): File{
// 使用 APP 内部储存空间
val appDir = File(getExternalFilesDir(Environment.DIRECTORY_PICTURES).absolutePath, "Avatar")
// 这句是使用外部存储空间的
//val appDir = File(Environment.getExternalStorageDirectory().absolutePath, "LifeUp")
if (!appDir.exists())
appDir.mkdir()
return File(appDir, filename)
}
根据系统api版本决定是用绝对路径还是用FileProvider获得Uri的私有方法
private fun getUriByOsVersion(file:File):Uri{
val currentApiVersion = android.os.Build.VERSION.SDK_INT
return if(currentApiVersion < 24) {
Uri.fromFile(file)
} else{
FileProvider.getUriForFile(this, packageName + ".provider", file)
}
}
上传裁剪后的头像
@Throws(IOException::class)
fun uploadFile(data: Intent) {
val file = getAvatarFile(avatarFileName)
val file = getAvatarFile(avatarFileName)
LoadingDialogUtils.show(this)
userNetwork.updateAvatar(file)
}
如果要调用系统内置的裁剪，部分代码：
@Deprecated("use ucrop instead")
fun cutImage(uri: Uri?) {
if (uri == null) {
Log.i("tip", "The uri is not exist.")
}
tempUri = uri!!
val intent = Intent("com.android.camera.action.CROP")
//com.android.camera.action.CROP这个action是用来裁剪图片用的
intent.setDataAndType(uri, "image/*")
intent.putExtra("crop", "true")
// aspectX aspectY 是宽高的比例
intent.putExtra("aspectX", 1)
intent.putExtra("aspectY", 1)
// outputX outputY 是裁剪图片宽高
intent.putExtra("outputX", 256)
intent.putExtra("outputY", 256)
//intent.putExtra("return-data", true)
//val appDir = File(Environment.getExternalStorageDirectory().absolutePath, "LifeUp")
tempUri = Uri.parse("file://" + "/" + Environment.getExternalStorageDirectory().absolutePath + "/" + "LifeUp" + "/" + avatarFileName)
intent.putExtra(MediaStore.EXTRA_OUTPUT, uri)
intent.putExtra("outputFormat", Bitmap.CompressFormat.JPEG.toString())
intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION)
intent.addFlags(Intent.FLAG_GRANT_WRITE_URI_PERMISSION)
intent.putExtra("noFaceDetection", true)
startActivityForResult(intent, CROP_SMALL_PICTURE)
}
最好通过将 return-data 设为 false，然后通过传递 uri ， 返回时通过 uri 获取 File 的方式来使用。
MIUI 好像在 return-data 设为 true，在 intent 返回 bitmap 的情况下会报错。
另外，即便在 return-data 设为 false 的时候，MIUI 仍然可能会出现保存失败的情况。可能原始文件和裁剪后文件的 uri 不能相同（纯猜测）。
FileProvider 配置
在 AndroidManifest.xml 中加上：
<!--FileProvider共享文件-->
<provider
android:name="android.support.v4.content.FileProvider"
android:authorities="net.sarasarasa.lifeup.provider"
android:exported="false"
android:grantUriPermissions="true">
<meta-data
android:name="android.support.FILE_PROVIDER_PATHS"
android:resource="@xml/file_paths"/>
</provider>
在 res/xml/file_paths.xml 中加上：
<?xml version="1.0" encoding="utf-8"?>
<paths>
<files-path path="Android/data/net.sarasarasa.lifeup/files/Pictures/" name="Avatar" />
<external-path path="Android/data/net.sarasarasa.lifeup/files/Pictures/" name="Avatar" />
<external-files-path path="files/Pictures/Avatar" name="images"/>
<root-path name="name" path="" />
</paths>
