在Android项目中,少不了需要更换头像这样一个小需求。然而一个看似简单的更换头像操作,对于Android开发者来说,却需要一定的工作量。其中需要做的工作有:
- Android 6.0 运行时权限变更适配。
- Android 7.0 FireProvider权限变更。
- 照片的裁剪。
- 照片压缩。
- 各种Room的种种问题等等。
对于上面的工作,一个个实现当然不难。关键是更换头像这样一个需求可能会在多个地方需要用到,那就涉及到代码的封装了。(一口气吃不了一个胖子,好的设计都是从烂代码开始,我们可以先一步一步实现功能,再考虑代码封装的问题)
最开始,项目赶进度急着上线,我们采用了第三方开源库TakePhoto。如果项目中也用到了FileProvider可能会与TakePhoto发生冲突,还有就是上传应用市场后,加固App,TakePhoto无法使用。所以后面就开始移除TakePhoto了。
我们知道,在Android中处理运行时权限问题,需要在onRequestPermissionsResult
回调方法中拿到grantResults
来继续接下来的逻辑。调用相机或相册时,需要在onActivityResult
回调拿到data
数据。
TakePhoto开源库中使用的是委托代理的方式来执行,这里我们也采用委托的方式,不过还是有很大不同的。
具体来看使用示例:
class MainActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
imagePickerDelegate = ImagePickerActivityDelegate(this)
avatar_view.setOnClickListener {
imagePickerDelegate?.pickImage()
}
imagePickerDelegate?.onImagePicked = { file ->
//愉快的上传更新头像把~~
}
}
private var imagePickerDelegate: ImagePickerActivityDelegate? = null
override fun onRequestPermissionsResult(requestCode: Int, permissions: Array<out String>, grantResults: IntArray) {
super.onRequestPermissionsResult(requestCode, permissions, grantResults)
imagePickerDelegate?.onRequestPermissionsResult(requestCode, permissions, grantResults)
}
override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
super.onActivityResult(requestCode, resultCode, data)
imagePickerDelegate?.onActivityResult(requestCode, resultCode, data)
}
}
我们把整个更换头像中的琐碎细节工作全部封装委托给ImagePickerActivityDelegate
,这样在多处使用时,我们能够减少大量的重复的代码量了。
下面我们深入了解下ImagePickerActivityDelegate
这个类的实现:
ImagePickerActivityDelegate 入口
fun pickImage() {
activity.chooseActionMenu(ImageSourceType.values().asList()){ type ->
when(type){
ImageSourceType.gallery -> preJumpGallery()
ImageSourceType.camera -> preJumpCamera()
}
}
}
我们把选择的菜单也封装了在里面。以相机拍照,我们来看看preJumpCamera()
方法:
private fun preJumpCamera() {
if (context.hasTakePhotoPermission) {
jumpCamera()
} else {
/**
* Android 6.0运行时权限申请,6.0以下提示打开。
*/
if (Build.VERSION.SDK_INT > Build.VERSION_CODES.M) {
activity.requestPermissions(arrayOf(Manifest.permission.CAMERA, Manifest.permission.WRITE_EXTERNAL_STORAGE), PermissionCodes.REQUEST_CAMERA)
} else {
context.showToast("请在设置中授予应用所需要的相机权限与存储权限!")
}
}
}
hasTakePhotoPermission
是我们添加的Context的内联方法:
/**
* 是否有相机权限
*/
inline val Context.isCameraPermissionGranted:Boolean get() = isPermissionGranted(Manifest.permission.CAMERA)
/**
* 是否有写外部存储权限
*/
inline val Context.isWriteToExternalStoragePermissionGranted:Boolean get() = isPermissionGranted(Manifest.permission.WRITE_EXTERNAL_STORAGE)
/**
* 是否有拍照(并写入外部存储)权限
*/
inline val Context.hasTakePhotoPermission:Boolean get() = isCameraPermissionGranted && isWriteToExternalStoragePermissionGranted
当没有授予权限时,我们需要申请权限并在权限申请回调中继续:
fun onRequestPermissionsResult(requestCode: Int, permissions: Array<out String>, grantResults: IntArray) {
when(requestCode){
PermissionCodes.REQUEST_CAMERA -> {
if (grantResults.isNotEmpty() && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
jumpCamera()
}
}
PermissionCodes.REQUEST_STORAGE -> {
if (grantResults.isNotEmpty() && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
jumpGallery()
}
}
}
}
获得权限后,我们就可以使用相机进行拍照了。不过在拍照前,还需要判断一下是否有相机,这个可以使用Intent特性去判断:
private fun isIntentUseable(intent: Intent):Boolean{
return context.packageManager.queryIntentActivities(intent, PackageManager.MATCH_DEFAULT_ONLY).isNotEmpty()
}
private fun jumpCamera() {
val file = context.createTempFileInImagesDir()
capturedPhotoFile = file
val tempUri = context.getFileProviderUriForFile(file)
Log.i("$activity","photoUri:$tempUri")
val cameraIntent = Intent().toCameraIntent(tempUri)
if (!isIntentUseable(cameraIntent)) {
context.showToast("没有相机")
return
}
activity.startActivityForResult(cameraIntent, CoreCodes.CAPTURE_PHOTO_REQUEST_CODE)
}
toPickFromGalleryIntent()
这里是用的Kotlin的扩展方法特性,代码如下
/**
* 转换成调用相机Intent
*/
fun Intent.toCameraIntent(outPutUri: Uri): Intent {
this.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION)
//设置Action为拍照
this.action = MediaStore.ACTION_IMAGE_CAPTURE
//将拍取的照片保存到指定URI
this.putExtra(MediaStore.EXTRA_OUTPUT, outPutUri)
return this
}
最近更新一个版本后,突然抛出适配Android7.0权限问题,大家可能需要适配一下咯。