Android-Image-Cropper库裁剪按钮及操作工具栏不显示问题求助

针对你使用Android-Image-Cropper库时出现的裁剪工具栏（确认/取消/旋转按钮）不显示问题，按以下步骤排查：

1. 修复代码语法错误 #

你的registerForActivityResult代码存在括号未闭合的问题，可能导致运行时异常，先修正：

private val cropImage = registerForActivityResult(CropImageContract()) { result ->
    if (result.isSuccessful) {
        val uriContent = result.uriContent
        val path = REF_STORAGE_ROOT.child(FOLDER_PROFILE_IMAGE)
            .child(CURRENT_UID)
        uriContent?.let { 
            path.putFile(it).addOnCompleteListener { task ->
                if (task.isSuccessful) {
                    showToast(getString(R.string.toast_data_update))
                }
            }
        }
    }
}

2. 确认依赖引入完整 #

新版CanHub/Android-Image-Cropper拆分了核心库与UI库，仅引入核心库会导致默认裁剪界面缺失工具栏。在Module级别的build.gradle中确保同时引入两个依赖：

// 核心功能库
implementation "com.canhub:android-image-cropper:4.6.0"
// 默认裁剪UI界面库
implementation "com.canhub:android-image-cropper-ui:4.6.0"

注：版本号可替换为当前最新稳定版。

3. 显式配置裁剪选项，强制显示工具栏 #

在startCrop()的options配置中，添加显式开启工具栏的参数：

private fun startCrop() {
    cropImage.launch(
        options() {
            setGuidelines(CropImageView.Guidelines.ON)
            setAspectRatio(1, 1)
            setRequestedSize(600, 600)
            setCropShape(CropImageView.CropShape.OVAL)
            // 强制显示裁剪菜单（工具栏）
            setShowCropMenu(true)
            // 开启旋转/翻转功能按钮
            setAllowRotation(true)
            setAllowFlipping(true)
        }
    )
}

4. 适配主题兼容性 #

若你的App使用了NoActionBar或自定义无标题栏主题，会导致裁剪Activity的工具栏无法显示。在AndroidManifest.xml中为裁剪Activity单独指定兼容主题：

<application ...>
    <!-- 其他Activity配置 -->
    <activity
        android:name="com.canhub.cropper.CropImageActivity"
        android:theme="@style/Theme.AppCompat.Light.DarkActionBar" />
</application>

5. 验证权限配置 #

确保已申请图片读取权限：

• Android 13+：申请READ_MEDIA_IMAGES权限
• Android 12及以下：申请READ_EXTERNAL_STORAGE权限
  通过动态权限申请完成权限验证，这是裁剪界面正常加载图片的前提。

内容的提问来源于stack exchange，提问作者triple_six