Android App集成ImagePicker图片选择库依赖报错如何解决

安全阿岳

2026-8-28

问题原因

编译时找不到ImagePicker相关API的核心原因是仅在App模块的build.gradle中添加了依赖声明，未配置JitPack仓库地址，Gradle无法从对应远程仓库拉取库文件，自然会出现类、方法缺失的编译错误，按AS提示添加随机依赖也无法解决。

修复步骤

配置JitPack远程仓库
根据你项目使用的Gradle版本选择对应配置方式，不要配错文件位置：
1. 若使用Android Studio Arctic Fox及以上新版本（根目录存在settings.gradle文件且配置了全局仓库）：
  打开根目录下的settings.gradle，在dependencyResolutionManagement下的repositories代码块中添加JitPack地址，新版本不再支持根build.gradle的allprojects仓库配置，写在那里不会生效：
```
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        // 新增该行
        maven { url "https://jitpack.io" }
    }
}
```
2. 若使用旧版Android Studio（全局仓库配置在根build.gradle中）：
  打开项目根目录的build.gradle（注意不是app模块下的文件），在allprojects下的repositories代码块中添加JitPack配置：
```
allprojects {
    repositories {
        google()
        mavenCentral()
        // 新增该行
        maven { url "https://jitpack.io" }
    }
}
```
确认模块依赖配置正确
打开app模块下的build.gradle，在dependencies代码块中匹配项目状态添加依赖，两个依赖二选一，禁止同时引入：
已迁移AndroidX的项目（近年新建的项目默认都是该状态）使用：
```
implementation 'com.github.dhaval2404:imagepicker:2.1'
```
未迁移AndroidX、仍使用Support库的老项目使用：
```
implementation 'com.github.dhaval2404:imagepicker-support:1.7.1'
```
同步并重建项目
配置完成后点击工具栏的Sync Project with Gradle Files按钮同步项目，如果同步后仍有报错，依次执行菜单栏的Build -> Clean Project，清理完成后再执行Build -> Rebuild Project即可正常调用库API。