Android Studio Arctic Fox下CanHub图片裁剪库Gradle同步失败配置问题

问题原因说明 #

构建报错核心原因是缺少Jitpack仓库配置，该裁剪库托管在Jitpack平台，默认的公共仓库没有收录对应资源。Android Studio Arctic Fox（对应Gradle 7.0+）版本调整了全局仓库的配置入口，废弃了根目录build.gradle中的allprojects { repositories }配置块。

第一步：配置Jitpack仓库 #

打开项目根目录下的settings.gradle文件，在dependencyResolutionManagement的repositories块中添加Jitpack地址，示例代码如下：

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        // 新增这一行配置Jitpack仓库
        maven { url 'https://jitpack.io' }
    }
}

如果你的项目使用Kotlin DSL（settings.gradle.kts），对应配置写法如下：

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        maven { url = uri("https://jitpack.io") }
    }
}

第二步：添加项目依赖 #

打开模块级build.gradle（通常是app目录下的build.gradle），在dependencies块中添加裁剪库依赖：

dependencies {
    // 其他项目依赖...
    implementation 'com.github.CanHub:Android-Image-Cropper:3.3.4'
}

配置完成后重新执行Gradle同步即可解决找不到依赖的报错。

基础使用示例 #

1. 注册裁剪结果回调 #

在Activity/Fragment中注册回调接收裁剪后的图片：

private val cropImageLauncher = registerForActivityResult(CropImageContract()) { result ->
    if (result.isSuccessful) {
        // 获取裁剪后的图片Uri
        val croppedImageUri = result.uriContent
        // 后续业务逻辑，比如展示、上传等
    } else {
        // 处理裁剪失败/用户取消的情况
        val error = result.error
    }
}

2. 启动图片裁剪 #

// 支持从相册选图/相机拍照后裁剪
CropImageContract()
    .withContext(this)
    .setSource(includeGallery = true, includeCamera = true)
    .setCropShape(CropImage.CropShape.RECTANGLE) // 裁剪形状可选矩形/圆形
    .setGuidelines(CropImage.Guidelines.ON) // 裁剪辅助线显示规则
    .let { cropImageLauncher.launch(null) }

常见问题排查 #

• 同步仍报错找不到依赖：确认Jitpack仓库地址拼写正确，网络可以正常访问Jitpack，可尝试清理Gradle缓存（File > Invalidate Caches > Invalidate and Restart）后重新同步。
• Android 13+适配问题：访问相册需要申请READ_MEDIA_IMAGES权限，调用相机需要申请CAMERA权限，提前做好权限申请逻辑。

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