在非应用级Java库中添加Google ML Kit依赖无法导入类如何解决

问题核心原因 #

Google ML Kit 是 Android 平台专属的 SDK，仅支持在 Android 模块中引入。你当前的独立库使用java-library插件配置为纯Java库，无法识别Android专属依赖，所以即使Gradle同步成功也找不到对应的类。

解决步骤 #

1. 将独立库模块修改为Android Library模块
   修改独立库的build.gradle配置：

• 替换顶部插件声明：把apply plugin: 'java-library'替换为apply plugin: 'com.android.library'
• 新增Android配置块，填写和主App匹配的编译配置即可，示例如下：

android {
    compileSdk 33 // 和你的主App compileSdk版本保持一致即可
    defaultConfig {
        minSdk 21 // ML Kit最低支持Android 5.0 (API 21)
    }
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
}

你可以删除原配置中单独声明的sourceCompatibility和targetCompatibility配置。

2. 确认项目级build.gradle已配置Google Maven仓库
   检查项目根目录的build.gradle，确保buildscript和allprojects的repositories块都添加了google()仓库：

buildscript {
    repositories {
        google()
        mavenCentral()
        // 其他你已配置的仓库
    }
}
allprojects {
    repositories {
        google()
        mavenCentral()
        // 其他你已配置的仓库
    }
}

3. 调整依赖声明（可选）
   如果主App也需要直接调用ML Kit相关的类，你可以把独立库中ML Kit的依赖声明从implementation改为api，否则保留implementation即可。

4. 清理缓存重新同步
   修改完成后点击Gradle同步，同步完成后如果仍有报错可以清理IDE缓存重启：File -> Invalidate Caches... -> 勾选清除文件系统缓存和本地历史 -> 点击重启即可。

补充说明 #

修改后的库仅支持接入Android项目，无法作为纯Java库给非Android环境使用。

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