Android项目依赖库版本统一要求及依赖配置技术问询

Got it, let's get your Android project's dependencies aligned to the same versions properly. This approach will make maintenance way easier and avoid those annoying version mismatch errors. Here's how to do it step by step:

1. 用 Gradle 全局变量统一管理版本号 #

First, move all your dependency versions to the root project's build.gradle file using an ext block. This lets you update versions in one place instead of hunting through every dependency line.

根项目 build.gradle 修改示例： #

buildscript {
    ext {
        // 第三方库版本
        zxingVersion = '1.9'
        // Support 库版本（必须统一）
        supportLibVersion = '26.1.0'
        constraintLayoutVersion = '1.0.2'
        // 测试库版本
        junitVersion = '4.12'
        testRunnerVersion = '1.0.1'
        espressoVersion = '3.0.1'
    }
    repositories {
        google()
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:3.0.1' // 记得用和 Support 库匹配的 AGP 版本
    }
}

allprojects {
    repositories {
        google()
        jcenter()
    }
}

2. 在模块 build.gradle 中引用全局版本 #

Now update your app module's build.gradle to use these variables, and replace the deprecated compile with implementation (AGP 3.0+ uses this for better build performance):

模块 build.gradle 修改示例： #

apply plugin: 'com.android.application'

android {
    compileSdkVersion 26
    buildToolsVersion "26.0.2" // 建议和 compileSdkVersion 版本匹配

    defaultConfig {
        applicationId "your.package.name"
        minSdkVersion 15
        targetSdkVersion 26
        versionCode 1
        versionName "1.0"
        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
    }

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

    // 强制统一所有 Support 库版本，避免间接依赖带来的版本不一致
    configurations.all {
        resolutionStrategy {
            force "com.android.support:appcompat-v7:${supportLibVersion}"
            force "com.android.support:design:${supportLibVersion}"
            // 如果有其他 Support 库依赖，也在这里添加强制规则
        }
    }
}

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation "me.dm7.barcodescanner:zxing:${zxingVersion}"
    implementation "com.android.support:appcompat-v7:${supportLibVersion}"
    implementation "com.android.support:design:${supportLibVersion}"
    implementation "com.android.support.constraint:constraint-layout:${constraintLayoutVersion}"

    testImplementation "junit:junit:${junitVersion}"
    androidTestImplementation "com.android.support.test:runner:${testRunnerVersion}"
    androidTestImplementation "com.android.support.test.espresso:espresso-core:${espressoVersion}"
}

3. 额外注意事项 #

• 废弃的 compile 关键字: 从 AGP 3.0 开始，compile 已经被标记为废弃，推荐使用 implementation（用于仅在模块内部使用的依赖）或 api（用于需要暴露给其他模块的依赖）。
• AGP 版本匹配: 确保你的 Android Gradle Plugin (AGP) 版本和 Support 库版本兼容。比如 Support 26.x 对应 AGP 3.0.x 版本。
• 间接依赖处理: 如果你引入的第三方库（比如 zxing）间接依赖了 Support 库，resolutionStrategy.force 会强制它使用你指定的版本，避免版本冲突。
• 同步验证: 修改完后点击 Android Studio 的 "Sync Project with Gradle Files" 按钮，检查是否有版本冲突提示，如果有，调整强制规则即可。

这样下来，你的所有依赖版本就完全统一了，后续更新版本只需要修改根 build.gradle 里的变量就行，非常省心。

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