build.gradle文件使用

导读
<a name=”label”>1、初识build.gradle</a>
<a name=”label”>2、使用build.gradle文件</a>
<a name=”label”>3、settings.gradle文件</a>
(ps:由于Markdown在简书里对锚点的支持效果不是很好,就没设置跳转)

一、初识build.gradle

在一个标准的AS工程中,最少都会有两个build.gradle文件,其一在项目的根目录,而另一个在module的根目录里面。如下图:

《build.gradle文件使用》 build.gradle文件

我们先来理了解下两个build.gradle文件的区别?

AS的工程结构其实可以理解为就是由module组成,但是只运行有一个主module作为我们实际运行的项目,其他module都是以依赖module形式存在,如上图中所示:就仅有module——app,并且是我们当前Demo的主module。AS中,每一个module都必须会有一个属于自己的build.gradle文件<br />
主module:有个手机图片标识<br />
依赖module:有个类似列表柱状图片标识<br >

《build.gradle文件使用》 主module和依赖module

了解了module后,回到我们问题,其实就很好理解两个build.gradle文件的区别了<br />

工程根目录的build.gradle文件

项目构建时,会先找到该文件执行构建,里面的配置对整个工程全局有效,我们可以在这里做些全局性的配置,在创建一个新AS工程时,会默认创建该文件,并且添加相关默认配置,如:gralde插件,jcenter仓库,maven仓库。当然也可以在这里自定义一些全局的设置,后面我们会提到<br >

module的build.gradle文件

构建具体到每一个module时,会执行该文件,里面的配置仅对当前module生效。在创建一个新module时,也会默认创建该文件,并且添加相关默认配置,如我们Demo中主module app的build.gradle文件:

apply plugin: 'com.android.application'//声明主module,com.android.application

android {//android工程配置
compileSdkVersion 25  //编译sdk版本号
buildToolsVersion "25.0.2"//编译工具版本
defaultConfig {//工程默认配置
    applicationId "com.example.myapplication"//程序运行时真正的包名,可以与java中包名不同
    minSdkVersion 15//最小sdk版本号
    targetSdkVersion 25//目标sdk版本号
    versionCode 1//应用程序的版本号,以这里修改为准,manifest文件中配置无效
    versionName "1.0"//应用程序的版本名,以这里修改为准,manifest文件中配置无效

}
buildTypes {//运行方式配置,可以配置debug,release或者其他自定义
    release {//release运行方式执行的配置
        minifyEnabled false //混淆开关
        proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'//混淆文件
    }
}
}

dependencies {//依赖配置
compile fileTree(dir: 'libs', include: ['*.jar'])
androidTestCompile('com.android.support.test.espresso:espresso-core:2.2.2', {
    exclude group: 'com.android.support', module: 'support-annotations'
})
compile 'com.android.support:appcompat-v7:25.2.0'
compile 'com.android.support.constraint:constraint-layout:1.0.2'
testCompile 'junit:junit:4.12'
}

二、使用build.gradle文件

清楚了两种build.gradle文件的区别后,那么我们就可以进行些我们自定义的配置了;假想下这么一种场景,自己的工程如果有好几个module,而每一个module都会有自己的build.gradle文件,因为是android工程,所以都会存在compileSdkVersionbuildToolsVersion等一些默认配置,有时候自己项目中明明是配置ok了,而且一直编译没有问题,或许突然某一天,其他同时把他自己环境的一些配置提交上来了,那么可能就会出现原来好好的可以跑,突然就报错勒,当然这解决起来也非常简单,会说了,我把他改回来不就好了。但是我们能不能通过一些简单配置,这种问题尽可能的减少出现呢?<br />

1.使用根目录build.gradle文件,配置共有的属性

build.gradle文件代码,ext里面就是我们自定义的一些配置

buildscript {
repositories {
    jcenter()
}
dependencies {
    classpath 'com.android.tools.build:gradle:2.3.0'

    // NOTE: Do not place your application dependencies here; they belong
    // in the individual module build.gradle files
}
}

ext {
compileSdkVersion=25
buildToolsVersion="25.0.2"
minSdkVersion=14
targetSdkVersion=25
versionCode=1
versionName="1.0"
}

allprojects {
repositories {
    jcenter()
}
}

task clean(type: Delete) {
delete rootProject.buildDir
}

使用代码:

compileSdkVersion rootProject.ext.compileSdkVersion
buildToolsVersion rootProject.ext.buildToolsVersion 

defaultConfig {
    applicationId "com.example.myapplication"
    minSdkVersion rootProject.ext.minSdkVersion
    targetSdkVersion rootProject.ext.targetSdkVersion
    versionCode rootProject.ext.versionCode
    versionName rootProject.ext.versionName
    testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
}

2.自动使用签名配置

在主module的build.gradle文件的android区域里面添加如下代码,下面配置中,debug和release都配置了同一签名

    signingConfigs {

    debugConfig {
        keyAlias 'debug'
        keyPassword '123456'
        storeFile file('/debug.keystore')
        storePassword '123456'
    }
    releaseConfig {
        keyAlias 'debug'
        keyPassword '123456'
        storeFile file('/debug.keystore')
        storePassword '123456'
    }
}

3.快速区分调试环境和生产环境

上面仅仅配置好了签名信息,运行起来实际上仍然是没效果的,这是因为我们还需要在运行类型配置上进行添加相关配置才能生效,同样的也是在主module的build.gradle文件中进行添加代码,添加区域在buildTypes里面

buildTypes {
    //调试环境
    debug {
        buildConfigField "boolean", "isDebug", "true"//debug标识,方便项目里面一些只在debug模式下生效代码做区分标识
        buildConfigField "String", "HOST", '"https://www.baidu.com/"'//项目里面,测试服务器地址
        resValue "string", "app_name", "**测试版"//配置了该属性,需要在values中strings.xml里面把app_name删掉,否则编译会报错,测试版本的APK名字,以区分正式测试不同版本

        //混淆
        minifyEnabled false

        //前一部分代表系统默认的android程序的混淆文件,该文件已经包含了基本的混淆声明,后一个文件是自己的定义混淆文件
        proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'

        signingConfig signingConfigs.debugConfig//使用上面签名配置中的debugConfig配置

        applicationIdSuffix'.debug'//区分debug版本的包名,会自动在正式包名后面带上.debug,方便测试服务器版本和正式服务器版本APK同时安装
    }
    //发布环境
    release {
        buildConfigField "boolean", "isDebug", "true"
        buildConfigField "String", "HOST", '"http://www.jianshu.com/"'//项目里面,正式服务器地址
        resValue "string", "app_name", "*****"//配置了该属性,需要在values中strings.xml里面把app_name删掉,否则编译会报错,正式版本的APK名字,以区分正式测试不同版本

        //混淆
        minifyEnabled true

        //前一部分代表系统默认的android程序的混淆文件,该文件已经包含了基本的混淆声明,后一个文件是自己的定义混淆文件
        proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'//混淆配置文件
        signingConfig signingConfigs.releaseConfig//使用上面签名配置中的releaseConfig配置
    }
}
app_name的特殊处理

当我们配置了app_name时,需要去values中找到strings.xml文件,把里面的app_name删除掉,否则编译项目会报如下错误,解决方案就是删除strings.xml里面的app_name后重新构建下就好了

《build.gradle文件使用》

有些配置我们该如何在项目代码中使用呢?<br />

比如测试正式服务器地址,debug标识状态,我们该如何使用呢。首先任何一个build.gradle修改了,都要重新构建下才能生效。构建完成后,我们就可以直接通过BuildConfig.配置的属性名,进行使用了,例如上述中的HOST:BuildConfig.HOST就可以取出我们上边配置的url勒。<br />

配置了两个,具体什么时候取哪个呢?

这个具体取决于你运行程序时AS里Build Variant设置了,点开该设置,找到我们的主module,根据下图我们可以看到默认是debug配置,此时我们如果需要使用release的配置时,只需要在此处进行切换就好了

《build.gradle文件使用》

4.自动按规范更改打包命名

在主module的build.gradle文件里,添加区域为android{}

  applicationVariants.all { variant ->

    variant.outputs.each { output ->

        output.outputFile = new File(

                output.outputFile.parent,

                "demo-${variant.buildType.name}-${defaultConfig.versionName}.apk")//打包的命名为:demo-debug-1.0.apk(debug配置下)
                                                                                    //        demo-release-1.0.apk(release配置下)

    }

}

三、settings.gradle文件

这个文件里面所配置的是我们项目module信息,如果新导入进来的module无法进行添加依赖,那么需要检查一下,在该文件中是否有添加该module,添加语法:

include ':app'//当前Demo因为只有一个app主module,所以就在打开该文件只能看到这一条配置,如果需要添加其他module,直接把app替换成module名即可
    原文作者:b77535296c81
    原文地址: https://www.jianshu.com/p/a8f034a03318
    本文转自网络文章,转载此文章仅为分享知识,如有侵权,请联系博主进行删除。
点赞