×

Gradle系列(三):项目实践

96
08_carmelo
2017.06.01 22:06* 字数 958

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'
        ...
Android经验分享
Web note ad 1