Gradle系列（三）：项目实践

Gradle系列（一）：Groovy基础
Gradle系列（二）：AndroidStudio的Gradle简介
Gradle系列（三）：项目实践

前言

就我现在工作项目来看，Gradle有这么几个方面的应用：版本号统一管理，debug/release编译模式区分，差异化编译，aar自动化管理等，看完我下面讲解，完全可以直接运用于你们的项目中，提高生产效率。

版本号统一管理

项目中肯定会以源码形式引入不少开源库，我们应该确保每个moduler的版本号：minSdkVersion ，compileSdkversion等都一样，因此有必要统一管理：
在根目录的build.gradle添加

ext {  

    // SDK And Tools  
    minSdkVersion = 14  
    targetSdkVersion = 23  
    compileSdkVersion = 23  
    buildToolsVersion = '24.0.2'  

    //Dependencies  
    supportLibraryVersion = '23.2.1'  

}  

在项目build.gradle中引用：

apply plugin: 'com.android.application'  

android {                       
    compileSdkVersion rootProject.ext.compileSdkVersion  
    buildToolsVersion rootProject.ext.buildToolsVersion  

    defaultConfig {  
        applicationId 'com.mainiway.demo'  
        minSdkVersion rootProject.ext.minSdkVersion  
        targetSdkVersion rootProject.ext.targetSdkVersion  
        versionCode 1  
        versionName "1.0.0"  
    }  
}

编译模式区分

有这样的场景：项目中的Log需要按照编译模式做区分，debug模式打印所有Log，发布版本只打印Error级别，怎么在代码中区分编译模式？
办法：项目中有个BuildConfig文件，位置在：（备注：如果编译过release，那么同样release文件夹也存在这个文件，内容一样）

image.png

BuildConfig：

public final class BuildConfig {
  public static final boolean DEBUG = Boolean.parseBoolean("true");
  public static final String APPLICATION_ID = "com.lubansoft.bimview4phone";
  public static final String BUILD_TYPE = "debug";
  public static final String FLAVOR = "";
  public static final int VERSION_CODE = 9;
  public static final String VERSION_NAME = "4.0.0";
  // Fields from default config.
  public static final boolean PUBLISH_MODE = false;
}

最后一个字段是我自定义的，前面都是这个配置文件自带的，包括是否为DEBUG，appID，versionCode等。自定义的PUBLISH_MODE就是来区分当前是否是发布模式的：
方法：在项目的build.gradle中加入：

    defaultConfig {
        ...
        buildConfigField "boolean", "PUBLISH_MODE", "true" //发布模式（生产环境下设为true，其他设为false）
        ...
    }```
这样就可以在编译期间，把值写入到BuildConfig，在发版当天把这个值设为true即可，然后再项目根据这个值来改变Log的打印规则：
```java
        // 设置Log调试开关
        LogUtil.setDebugState(!BuildConfig.PUBLISH_MODE);

注意：BuildConfig中有个DEBUG字段，该字段在debug模式就是true，在release模式就是false，不需要手动设置，但是release模式不一定是发布模式（也可能是打一个签名包测试）。

差异化编译

需求场景：项目中引用了一些Jar包，只在调试模式下用到了，在发布模式根本用不到，但是编译到项目中又会增大APP体积，能否只在发布模式下才去编译呢？
方法：把这些jar包不要放在libs文件夹，跟libs平级建一个目录比如：debugLibs，然后在项目的build.gradle根据当面的PUBLISH_MODE做差异化编译：

dependencies {
    compile fileTree(include: ['*.jar'], dir: 'libs')
   if (!publishMode) {
        compile fileTree(include: ['*.jar'], dir: 'debuglibs')
   }
    ...
}

统一管理aar

这一个不是所有项目都会用到，但是我强烈建议去实践的。实际项目中都会把一些基础控件，基础功能抽离出来，做为单独项目基础库用单独svn分支管理，在开发项目中写一个脚本打包成aar文件拉到本地使用，既可以复用到不同项目又可以缩短编译时间，一举两得。比如基础库按照UI，通用逻辑，业务通用模块生成了三个aar：

image.png

在项目中使用：

repositories{
    flatDir{
        dirs '../libs'
    }
}

dependencies {
    ...
    compile(name: 'base_1.2.0', ext: 'aar')
    compile(name: 'commombase_1.0.0', ext: 'aar')
    compile(name: 'uibase_1.2.0', ext: 'aar')
}```
假设现在基础库增加了新的模块，就会生成新的aar，或者产品迭代了这几个aar版本号也要迭代，难道每次都在build.gradle中手动去改吗，完全可以自动化这个过程。
方法：可以看出我把这几个aar放到根目录的libs文件夹(文件夹随意)，那就获取这个文件夹下的所有文件名，动态引用。
```java
def path = rootProject.getRootDir().getAbsolutePath() + "/libs"
    def configFile = new File(path)
//获取文件夹下所有文件
    def files = configFile.listFiles(new FilenameFilter() {
        @Override
        boolean accept(File dir, String name) {
//文件名过滤，防止出错
            if (name.contains("base")) {
                return true;
            } else {
                return false
            }
        }
    })
    def aar1 = files[0].getName()
    def aar2 = files[1].getName()
    def aar3 = files[2].getName()
//动态引用这些aar
    compile(name: '$aar1', ext: 'aar')
    compile(name: '$aar2', ext: 'aar')
    compile(name: '$aar3', ext: 'aar')

这样够好了吗？
这些代码都在build.gradle的dependencies里面，太乱了，要是可以独立出去就好了，把获取aar封装成工具类。OK，gradle完全支持这么干，在根目录建一个utils.gradle

image.png

utils.gradle:

//gradle工具类
//获取基础库版本号
def getAARNames() {
    ...
//具体实现不写了，返回一个String数组
    return ["$lbName", "$aar1", "$aar2","$aar3"]
}
ext {
//注意这行不能少
    getAARNames = this.&getAARNames
}

在build.gradle中使用：

image.png

dependencies {
   ...
    //获取aar文件名，是一个数组
    def aarList = getAARNames()
    compile(name: aarList[0], ext: 'aar')
    compile(name: aarList[1], ext: 'aar')
    compile(name: aarList[1], ext: 'aar')
}

大功告成！代码清爽很多。

精简开源项目目录结构

实际中肯定会以源码形式用到不少开源库，特别是UI相关的我们要该里面的代码，只能以源码形式，那么一些都是作为moduler和我们的app并列放到一个目录，开源库数量达到十几个时项目结构看起来就主次不分了，有必要精简之。
方法：直接在根目录建立文件夹比如thirdpart，把开源库都放进去，然后在settings.gradle中配置项目结构：

include ':bvcommon',
        ':app',//这是主项目，下面都是开源库
        ':thirdpart:PullToRefreshLibrary',
        ':thirdpart:datetimepicker-library',
        ':thirdpart:MultilevelTreeLibrary',
        ':thirdpart:FFmpegAndroid',
        ':thirdpart:autolinklibrary'
        ...