通过JitPack导入Android新版本库提示‘包不存在’问题排查

问题背景 #

我是开源Android库AudioFocusController的作者，近期发布了兼容Android SDK 34的3.0.0版本：

• JitPack构建正常
• 配套Demo运行无问题
• 仅修改：移除一个接口的公开实现，改为私有变量

但其他Android项目导入该版本时，出现Cannot resolve symbol...错误，重建时Gradle提示「包不存在」，切换回v2.1版本则恢复正常。已尝试Invalidate Caches/Restart无效，怀疑是迁移到Gradle 8.3时的module build.gradle配置有误。

新旧build.gradle配置对比 #

新配置（v3.0.0） #

apply plugin: 'com.android.library'
apply plugin: 'maven-publish'

android {
    compileSdk 34

    defaultConfig {
        minSdkVersion 21
        targetSdkVersion 34

        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
        consumerProguardFiles "consumer-rules.pro"
    }

    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }

    publishing {
        singleVariant('release') {
            withSourcesJar()
            withJavadocJar()
        }
    }

    namespace 'in.basulabs.audiofocuscontroller'
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_17
        targetCompatibility JavaVersion.VERSION_17
    }

}

dependencies {
    implementation fileTree(dir: "libs", include: ["*.jar"])
    implementation 'androidx.appcompat:appcompat:1.6.1'
    testImplementation 'junit:junit:4.13.2'
    androidTestImplementation 'androidx.test.ext:junit:1.1.5'
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.5.1'

}

project.afterEvaluate {
    publishing {
        publications {
            release(MavenPublication) {
                components.getByName('release')
                groupId = 'in.basulabs.audiofocuscontroller'
                artifactId = 'library'
                version = '3.0.0'
            }
        }
    }
}

旧配置（v2.1） #

apply plugin: 'com.android.library'
apply plugin: 'maven-publish'

android {
    compileSdkVersion 31
    buildToolsVersion "31.0.0"

    defaultConfig {
        minSdkVersion 21
        targetSdkVersion 31
        versionCode 3
        versionName "2.1"

        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
        consumerProguardFiles "consumer-rules.pro"
    }

    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }

}

dependencies {
    implementation fileTree(dir: "libs", include: ["*.jar"])
    implementation 'androidx.appcompat:appcompat:1.4.1'
    testImplementation 'junit:junit:4.13.1'
    androidTestImplementation 'androidx.test.ext:junit:1.1.3'
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.4.0'

}

project.afterEvaluate {
    publishing {
        publications {
            release(MavenPublication) {
                from components.release
                groupId = 'in.basulabs.audiofocuscontroller'
                artifactId = 'library'
                version = '2.1'
            }
        }
    }
}

可能的原因与解决方案 #

1. 发布配置写法错误 #

新配置中发布部分使用components.getByName('release')，而旧版本是from components.release。Gradle 8.x中，正确关联构件的写法需要保留from关键字，否则可能导致发布的aar未包含正确的类文件。

修正方式：

project.afterEvaluate {
    publishing {
        publications {
            release(MavenPublication) {
                from components.release // 改回此写法
                groupId = 'in.basulabs.audiofocuscontroller'
                artifactId = 'library'
                version = '3.0.0'
            }
        }
    }
}

2. namespace与代码实际包名不匹配 #

新配置新增了namespace 'in.basulabs.audiofocuscontroller'，如果代码中类的实际包名和这个namespace不一致，会导致发布的aar中包名与用户引用的包名不符，出现「包不存在」错误。

验证与修正：

• 检查库中所有类的包声明是否为package in.basulabs.audiofocuscontroller;
• 确保namespace值与代码包名完全一致

3. Java版本兼容性问题 #

新配置将Java版本升级到17，若导入该库的用户项目使用较低Java版本（如1.8），会因编译版本不兼容导致无法解析类。

兼容方案：
如果需要兼容旧版本Java项目，可调整编译选项：

compileOptions {
    sourceCompatibility JavaVersion.VERSION_1_8
    targetCompatibility JavaVersion.VERSION_1_8
    coreLibraryDesugaringEnabled true // 启用 desugar 支持 Java 8+ 特性
}

dependencies {
    coreLibraryDesugaring 'com.android.tools:desugar_jdk_libs:2.0.4'
}

4. singleVariant配置限制构件发布 #

新配置中的singleVariant('release')可能限制了发布的变体内容，导致必要的类文件或依赖未被正确打包进aar。

尝试调整：
移除android.publishing.singleVariant配置，或改为对所有变体生效：

publishing {
    variants {
        all {
            withSourcesJar()
            withJavadocJar()
        }
    }
}

验证步骤 #

1. 优先修正发布配置的写法，重新发布到JitPack后测试导入
2. 若问题仍存在，检查namespace与代码包名一致性
3. 再尝试调整Java版本兼容性设置
4. 最后排查singleVariant配置的影响

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