Android 重構 ｜ 統一管理 Gradle 依賴版本

@[toc]

一輩子清貧怎敢入繁華，倆袖清風怎敢誤佳人。

前言

重構書中，有這麼一句話：

• 產品不死，重構不止。

好代碼，老是要經歷多個階段，從匆忙趕工上線，到慢慢細緻打磨，折騰的過程，美好的結果。

經歷過的項目，大部分都是一個 app 包下一應俱全，而今藉此機會，從單一模塊要逐漸演變，第一步，模塊化搞起～

通過瞎折騰後，目前結構以下：

• Pro

  • app：主 module
  • helper：幫助類（針對系統級別）以及工具類
  • weight：自定義 View 相關
  • ...

通過一番折騰以後，的確比以前順眼了許多，隨之而來帶來的問題是，每一個 module 下都有對應的 build 文件，每一個 build 文件都有一些基本的依賴庫，想一想往後還要分離各類 module，相關的管理怎麼作？

拆分 build，統一管理

Step 1：項目根目錄下建立 config.gradle

在此處，首先要明確共有依賴都有哪兒些：

• Android 基本信息，例如編譯 SDK 版本、版本信息等；
• 基礎依賴版本，例如 support 等；
• 經常使用的一些依賴

So，此處抽取信息以下：

ext {

    /**
     * Android 基本配置項
     */
    android = [
            // 編譯 SDK 版本
            compileSdkVersion: 29,
            // Gradle 編譯項目工具版本
            buildToolsVersion: "29.0.3",
            // 最低兼容 Android 版本
            minSdkVersion    : 23,
            // 最高兼容 Android 版本
            targetSdkVersion : 29,
            // 當前版本編號
            versionCode      : 1,
            // 當前版本信息
            versionName      : "1.0"
    ]

    /**
     * 基礎依賴版本 - 相似 support 庫等
     */
    def dependVersion = [
            appcompat       : "1.1.0",
            constraintlayout: "1.1.3"
    ]

    /**
     * 經常使用依賴
     */
    dependencies = [
            // basic
            "kotlinStdlibJdk7": "org.jetbrains.kotlin:kotlin-stdlib-jdk7:${kotlin_version}",
            "appcompat"       : "androidx.appcompat:appcompat:${dependVersion.appcompat}",
            "coreKtx"         : 'androidx.core:core-ktx:1.2.0',
            "constraintlayout": "androidx.constraintlayout:constraintlayout:${dependVersion.constraintlayout}",
            // test
            "junit"           : 'junit:junit:4.12',
            "testJunit"       : 'androidx.test.ext:junit:1.1.1',
            "testEspressoCore": 'androidx.test.espresso:espresso-core:3.2.0'
    ]
}

Step 2：爲項目根目錄下 build 添加依賴

// Top-level build file where you can add configuration options common to all sub-projects/modules.
apply from: "config.gradle"

buildscript {
     // ...
}
// ...

Step 3：調整 module 中 build.gradle 原有使用方式

// ...

android {

    def androidRoot = rootProject.ext.android

    compileSdkVersion androidRoot.compileSdkVersion
    buildToolsVersion androidRoot.buildToolsVersion

    defaultConfig {
        applicationId "your package name"
        minSdkVersion androidRoot.minSdkVersion
        targetSdkVersion androidRoot.targetSdkVersion
        versionCode androidRoot.versionCode
        versionName androidRoot.versionName

        // ...
    }
    // ...
}

/**
 * implementation：不會向下傳遞，僅在當前 module 生效； api：向下傳遞，所依賴的 module 都可使用
 */
dependencies {
    def androidDependencies = rootProject.ext.dependencies

    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation androidDependencies.kotlinStdlibJdk7
    implementation androidDependencies.appcompat
    implementation androidDependencies.coreKtx
    implementation androidDependencies.constraintlayout
    testImplementation androidDependencies.junit
    androidTestImplementation androidDependencies.testJunit
    androidTestImplementation androidDependencies.testEspressoCore

    // 模塊化部分導入部分

    // helper
    implementation project(path: ':helper')
    // weight
    implementation project(path: ':weight')

    // 經常使用三方依賴導入部分
    // ...
}

The end

ummm，爽了不少。

點滴積累，跟着雞老大～

萬一某天優秀了呢～

哈哈哈

參考資料

• 添加構建依賴項
• Android從零擼美團(一) - 統一管理 Gradle 依賴 提取到單獨文件中