Android插件集成FirebaseStorage出现java.lang.NoClassDefFoundError求助

问题核心 #

将独立Android应用中正常运行的Firebase Storage功能迁移到Android Library插件时出现类找不到错误，本质是Library模块的依赖传递、插件应用逻辑或混淆配置导致Firebase相关类未被正确打包进宿主应用。

具体解决步骤 #

1. 调整Google Services插件的配置位置 #

Library模块无需单独配置buildscript块，应将Google Services插件的classpath配置移至项目根目录的build.gradle，同时规范插件应用方式：

根目录build.gradle配置：

buildscript {
    dependencies {
        classpath 'com.google.gms:google-services:4.3.15'
    }
    repositories {
        google()
        mavenCentral()
    }
}

plugins {
    id 'com.android.application' version '7.4.2' apply false
    id 'com.android.library' version '7.4.2' apply false
}

Library模块build.gradle简化后：

plugins {
    id 'com.android.library'
    id 'com.google.gms.google-services' // 直接通过plugins块应用，无需单独apply
}

android {
    namespace 'com.shefyg.uapaa1module'
    compileSdk 32

    defaultConfig {
        minSdk 21
        targetSdk 32
        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
        consumerProguardFiles "consumer-rules.pro"
    }

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

dependencies {
    implementation platform('com.google.firebase:firebase-bom:32.0.0')
    implementation 'com.google.firebase:firebase-database:20.2.1'
    implementation 'com.google.android.material:material:1.9.0'
    implementation 'com.google.firebase:firebase-storage:20.2.0'
    testImplementation 'junit:junit:4.13.2'
    androidTestImplementation 'androidx.test.ext:junit:1.1.5'
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.5.1'
}

宿主App模块build.gradle必须添加：

plugins {
    id 'com.android.application'
    id 'com.google.gms.google-services'
}

2. 保障依赖传递有效性 #

Library中使用implementation依赖Firebase组件时，默认会传递给宿主应用，无需额外配置。当前使用Firebase BOM统一版本的方式是正确的，可避免版本冲突问题。

3. 修正混淆配置 #

若宿主应用开启混淆，需在Library模块的consumer-rules.pro中添加规则防止Firebase类被误删：

# 保留Firebase及GMS相关类不被混淆
-keep class com.google.firebase.** { *; }
-keep class com.google.android.gms.** { *; }

如果宿主App自身有混淆配置，也需同步添加上述规则。

4. 清理缓存并重建项目 #

执行以下操作彻底清除缓存并重新构建：

• Android Studio菜单栏：Build > Clean Project
• 随后执行：Build > Rebuild Project
• 最后清除IDE缓存：File > Invalidate Caches... > Invalidate and Restart

5. 校验Firebase配置文件 #

确保宿主App模块的app/src/main/res/values/google-services.json存在且配置正确，Library模块不需要放置该文件。

内容的提问来源于stack exchange，提问作者Shefy Gur-ary