组件化gradle语法(一)

代码地址
记录一下Android组件化的学习过程，因为自己开发过的项目基本都是一两个人开发，对组件化这一块也没去过多了解，但是就大中型项目而言熟练掌握组件化开发是必不可少的技能，学习组件化之前先了解一下组件化需要用到的Gradle基本语法

1. Gradle打印hello world

在项目的build.gradle中使用println,如下两种方式效果一样

apply plugin: 'com.android.application'

println("hello wrold")
println "hell Gradle"

点击build和左侧的第二个按钮查看执行结果

image.png

2.创建自己的Gradle文件

一般创建一个Android项目AS会给我们创建好project和app的gradle，我们需要自己创建gradle存放app和个module的公共参数，在项目根目录右键-New-File创建一个config.gradle文件，创建好项目目录如下：

image.png

在config.gradle定义一个变量并在app.gradle引用
config.gradle

ext {
    username = "simon"
}

app.gradle引用config.gradle定义的username有如下两种方式

apply plugin: 'com.android.application'

println "$rootProject.ext.username"
println "${username}"

打印结果如下

image.png

Gradle同样也支持其他数据类型，比如int、boolean，map等，比如我们一般会在项目中把app和各module的defaultConfig参数和第三方implementation提取出来，使用map键值对统一定义在config.gradle中

ext {
    username = "simon"

    //建立Map存储，对象名。key都可以自定义，groovy糖果语法，非常灵活
    androidId = [
            compileSdkVersion:28,
            applicationId   : "com.netease.modelar.gradle",
            minSdkVersion   : 21,
            targetSdkVersion: 28,
            versionCode     : 1,
            versionName     : "1.0",
    ]

    appId = [
            applicationId: "com.netease.modelar.gradle",
            library      : "com.netease.modular.library"
    ]

    supportLibrary = "28.0.0"//${xxx}
    //第三方库
    dependencies = [
            "appcompat"   : "com.android.support:appcompat-v7:${supportLibrary}",
            "recyclerview": "com.android.support:recyclerview-v7:${supportLibrary}",
            "constraint"  : "com.android.support.constraint:constraint-layout:1.1.3"
    ]
}

然后再app个gradle中调用config.gradle定义的这些参数，保证了app和各module的版本和第三方库版本一致
先把config.gradle中参数赋值

//复值与引用
def androidId = rootProject.ext.androidId
def appId = rootProject.ext.appId
def support = rootProject.ext.dependencies

再在需要的地方调用

apply plugin: 'com.android.application'

//println("hello wrold")
//println "hell Gradle"
println "$rootProject.ext.username"
println "${username}"

//复值与引用
def androidId = rootProject.ext.androidId
def appId = rootProject.ext.appId
def support = rootProject.ext.dependencies
def url = rootProject.ext.url

android {
    compileSdkVersion androidId.compileSdkVersion
    defaultConfig {
        applicationId appId.applicationId
        minSdkVersion androidId.minSdkVersion
        targetSdkVersion androidId.targetSdkVersion
        versionCode androidId.versionCode
        versionName androidId.versionName
        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
    buildTypes {
        debug {
            buildConfigField("String", "debug", "\"${url.debug}\"")
        }

        release {
            minifyEnabled false
            buildConfigField("String", "debug", "\"${url.release}\"")
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    //简写
    //implementation 'com.android.support:appcompat-v7:28.0.0'
    //使用自己配置config.gradle写法
    implementation support.appcompat
    implementation support.recyclerview
    implementation support.constraint

}

3.dependencies->implementation的几种写法

在项目开发中我们会通过implementation使用到一些第三方库，一般会通过简写的方式进行引用，比如

//简写
implementation 'com.android.support:appcompat-v7:28.0.0'

完整写法:implementation group: 'xx', name: 'xx', version: 'xx'

implementation group: 'com.android.support', name: 'appcompat-v7', version: '28.0.0'

使用自己配置的config.gradle写法

    implementation support.appcompat
    implementation support.recyclerview
    implementation support.constraint

最简写法，通过.each循环的方法添加引用,就可以全部implementation我们在config.gradle中定义的dependencies的map键值对

support.each { k, v -> implementation v }

4.使用Gradle配置正式/测试环境BaseUrl

在开发中我们一般都会通过一个工具类配置正式/测试环境的BaseUrl，然后每次打包的时候手动切换这个BaseUrl，通过Gradle可以动态配置BaseUrl避免疏忽造成忘记切换BaseUrl的尴尬。在config.gradle中添加isRelease和url=[]两个属性

ext {
    username = "simon"

    //建立Map存储，对象名。key都可以自定义，groovy糖果语法，非常灵活
    androidId = [
            compileSdkVersion:28,
            applicationId   : "com.netease.modelar.gradle",
            minSdkVersion   : 21,
            targetSdkVersion: 28,
            versionCode     : 1,
            versionName     : "1.0",
    ]

    appId = [
            applicationId: "com.netease.modelar.gradle",
            library      : "com.netease.modular.library"
    ]

    isRelease = true
    //生成/测试环境Url
    url = [
            "debug"  : "https://11.22.33.44/debug",
            "release": "https://11.22.33.44/release"
    ]

    supportLibrary = "28.0.0"//${xxx}
    //第三方库
    dependencies = [
            "appcompat"   : "com.android.support:appcompat-v7:${supportLibrary}",
            "recyclerview": "com.android.support:recyclerview-v7:${supportLibrary}",
            "constraint"  : "com.android.support.constraint:constraint-layout:1.1.3"
    ]
}

在app.gradle中buildTypes中配置

 buildTypes {
        debug {
            buildConfigField("String", "debug", "\"${url.debug}\"")
        }

        release {
            minifyEnabled false
            buildConfigField("String", "debug", "\"${url.release}\"")
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }

重新Syno Now然后打开，打开如下目录的BuildConfig.class这个类你会发现已近在改类中自动生成了一个url地址

image.png

debug包下为：

 public static final String debug = "https://11.22.33.44/debug";

release包下为：

 public static final String release = "https://11.22.33.44/release";

5.签名配置

其中debug的签名配置，windows系统默认的Android debug签名证书存储路径为：C://Users/Administrator/.android/debug.keystore，Mac系统的默认签名路径为：~/.android/debug.keystore，一般为了避免同事之间电脑操作系统不同，可以直接配置release签名信息，或者不配置debug，打包的时候会自动使用默认的debug签名证书进行配置
注意：signingConfigs需要配置在buildTypes节点之前

    signingConfigs {
        debug {
            //windows系统默认debug签名证书存储路径
            //storeFile file("C://Users/Administrator/.android/debug.keystore")
            //Mac系统默认debug签名证书存储路径
            //storeFile file("~/.android/debug.keystore")
            //storePassword "android"
            //keyAlias "androiddebugkey"
            //keyPassword "android"
            storeFile file("../netease.jks")
            storeType "netease"
            storePassword "net163"
            keyAlias "netease"
            keyPassword "net163"
        }
        release {
            //签名证书文件
            storeFile file("../netease.jks")
            //签名证书的类型
            storeType "netease"
            //签名证书文件的密码
            storePassword "net163"
            //签名证书中密码别名
            keyAlias "netease"
            //签名证书中该秘钥的密码
            keyPassword "net163"
            //是否开启v2打包
            v2SigningEnabled true
        }
    }

6.项目中一些其他的Gradle配置

看注释，都写的很比较清楚，关于热修复和分包的

apply plugin: 'com.android.application'

//println("hello wrold")
//println "hell Gradle"
println "$rootProject.ext.username"
println "${username}"

//复值与引用
def androidId = rootProject.ext.androidId
def appId = rootProject.ext.appId
def support = rootProject.ext.dependencies
def url = rootProject.ext.url

android {
    compileSdkVersion androidId.compileSdkVersion
    defaultConfig {
        applicationId appId.applicationId
        minSdkVersion androidId.minSdkVersion
        targetSdkVersion androidId.targetSdkVersion
        versionCode androidId.versionCode
        versionName androidId.versionName
        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"

        //开启分包
        multiDexEnabled true
        //设置分包配置
        //multiDexKeepFile file('multidex-config.txt')

        //将svg图片生成 指定维度的png图片
        //vectorDrawables.generatedDensities('xhdpi','xxhdpi')
        //使用support-v7兼容（5.0版本以上）
        vectorDrawables.useSupportLibrary = true
        //只保留指定和默认资源
        resConfig('zh-rCH')

        //配置so库CPU架构（真机：arm,模拟器：x86）
        // x86 x86_64 mips mips64
        ndk {
            //真机
            //abiFilters('armeabi', 'armeabi-v7')
            //为了模拟器启动
            abiFilters('x86', 'x86_64')
        }

        //源集 - 设置源集的属性，更改源集的Java目录或者自由目录等
        sourceSets {
            main {
                if (!isRelease) {
                    // 如果是组件化模式，需要单独运行时
                    manifest.srcFile 'src/main/AndroidManifest.xml'
                    java.srcDirs = ['src/main/java']
                    res.srcDirs = ['src/main/res']
                    resources.srcDirs = ['src/main/resources']
                    aidl.srcDirs = ['src/main/aidl']
                    assets.srcDirs = ['src/main/assets']
                } else {
                    //集成化模式，整个项目打包
                    manifest.srcFile 'src/main/AndroidManifest.xml'
                }
            }
        }
    }

    //签名配置（隐形坑：必须写在buildTypes之前）
    signingConfigs {
        debug {
            //windows系统默认debug签名证书存储路径
            //storeFile file("C://Users/Administrator/.android/debug.keystore")
            //Mac系统默认debug签名证书存储路径
            //storeFile file("~/.android/debug.keystore")
            //storePassword "android"
            //keyAlias "androiddebugkey"
            //keyPassword "android"
            storeFile file("../netease.jks")
            storeType "netease"
            storePassword "net163"
            keyAlias "netease"
            keyPassword "net163"
        }
        release {
            //签名证书文件
            storeFile file("../netease.jks")
            //签名证书的类型
            storeType "netease"
            //签名证书文件的密码
            storePassword "net163"
            //签名证书中密码别名
            keyAlias "netease"
            //签名证书中该秘钥的密码
            keyPassword "net163"
            //是否开启v2打包
            v2SigningEnabled true
        }
    }

    buildTypes {
        debug {
            buildConfigField("String",  "debug", "\"${url.debug}\"")
        }

        release {
            minifyEnabled false
            buildConfigField("String", "debug", "\"${url.release}\"")
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }

    //adbOptions:可以对adb操作选项添加配置
    adbOptions {
        //配置操作超时时间，单位毫秒
        timeOutInMs = 5 * 1000_0
        //adb install 命令的选项配置
        installOptions '-r', '-s'
    }

    //对 dx 操作配置，接受一个DexOptions类型的闭包，配置由DexOptions提供
    dexOptions {
        //配置执行dx命令是为其分配的最大推内存
        javaMaxHeapSize "4g"
        //配置是否执行dex Library工程，开启后会提高增量构建速度，不会影响clean构建速度，默认true
        preDexLibraries = false
        //配置是否开启jumbo模式，代码方法超过65535需要强制开启才能构建成功
        jumboMode true
        //配置Gradle运行dx命令时使用的线程数量
        threadCount 8
        additionalParameters = [
                '--multi-dex',//多dex分包
                '--set-max-idx-number=50000',//每个包内方法数上限
                // '--main-dex-list=' + '/multidex-config.txt',// 打包到主classes.dex的文件列表
                '--minimal-main-dex'
        ]
    }

    //执行 gradle lint 命令即可运行 lint 检查，默认生成的报告在 outputs/lint-results.html中
    lintOptions {
        //遇到lint检查错误会终止构建，一般设置为false
        abortOnError false
        //将警告当做错误来处理（老版本：warningAsErrors）
        warningsAsErrors false
        //检查新的API
        check 'NewApi'
    }
}

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    //标准写法
    //implementation group: 'com.android.support', name: 'appcompat-v7', version: '28.0.0'
    //简写
    //implementation 'com.android.support:appcompat-v7:28.0.0'
    //使用自己配置config.gradle写法
    //implementation support.appcompat
    //implementation support.recyclerview
    //implementation support.constraint
    //最简洁的方式.each循环依赖
    support.each { k, v -> implementation v }
}