Android相机适配代码封装

在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权限问题，大家可能需要适配一下咯。