史上最全Android build.gradle配置详解(小结)

作者:Android高级架构师 时间:2023-05-09 00:08:36 

Android Studio是采用gradle来构建项目的,gradle是基于groovy语言的,如果只是用它构建普通Android项目的话,是可以不去学groovy的。当我们创建一个Android项目时会包含两个Android build.gradle配置详解文件,如下图:

史上最全Android build.gradle配置详解(小结)

一、Project的build.gradle文件:

对应的build.gradle代码如下:


// Top-level build file where you can add configuration options common to all sub-projects/modules.

buildscript {//这里是gradle脚本执行所需依赖,分别是对应的maven库和插件

repositories {
   google()//从Android Studio3.0后新增了google()配置,可以引用google上的开源项目
   jcenter()//是一个类似于github的代码托管仓库,声明了jcenter()配置,可以轻松引用 jcenter上的开源项目
 }
 dependencies {
   classpath 'com.android.tools.build:gradle:3.0.0'////此处是android的插件gradle,gradle是一个强大的项目构建工具

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

allprojects {//这里是项目本身需要的依赖,比如项目所需的maven库
 repositories {
   google()
   jcenter()
 }
}

// 运行gradle clean时,执行此处定义的task任务。
// 该任务继承自Delete,删除根目录中的build目录。
// 相当于执行Delete.delete(rootProject.buildDir)。
// gradle使用groovy语言,调用method时可以不用加()。
task clean(type: Delete) {
 delete rootProject.buildDir
}
  • buildscript{}闭包里是gradle脚本执行所需依赖,分别是对应的maven库和插件。

  • allprojects{}闭包里是项目本身需要的依赖,比如项目所需的maven库。

  • task clean(type: Delete){}是运行gradle clean时,执行此处定义的task任务,该任务继承自Delete,删除根目录中的build目录。其中buildscript包含repositories闭包和dependencies闭包。

repositories{}闭包:配置远程仓库

该闭包中声明了jcenter()和google()的配置,其中jcenter是一个代码托管仓库,上面托管了很多Android开源项目,在这里配置了jcenter后我们可以在项目中方便引用jcenter上的开源项目,从Android Studio3.0后新增了google()配置,可以引用google上的开源项目。

dependencies{}闭包:配置构建工具

该闭包使用classpath声明了一个Gradle插件,由于Gradle并不只是用来构建Android项目,因此此处引入相关插件来构建Android项目,其中'3.3.3'为该插件的版本号,可以根据最新的版本号来调整。

二、Module的build.gradle文件:

从文件内容可以看出,主要分为三大部分,如下图所示:

史上最全Android build.gradle配置详解(小结)

1、apply plugin:


// 声明是Android程序,
//com.android.application 表示这是一个应用程序模块
//com.android.library 标识这是一个库模块
//而这区别:前者可以直接运行,后着是依附别的应用程序运行
apply plugin: 'com.android.application'

文件中第一行使用apply plugin表示应用了一个插件,该插件一般有两种值可选:

  • 'com.android.application',表示该模块为应用程序模块,可以直接运行,打包得到的是.apk文件

  • 'com.android.library',表示该模块为库模块,只能作为代码库依附于别的应用程序模块来运行,打包得到的是.aar文件

2、android{}闭包:

这个闭包主要为了配置项目构建的各种属性:

2.1、添加signingConfigs{}闭包:


signingConfigs {// 自动化打包配置
   release {// 线上环境
     keyAlias 'test'
     keyPassword '123456'
     storeFile file('test.keystore')
     storePassword '123456'
   }
   debug {// 开发环境
     keyAlias 'test'
     keyPassword '123456'
     storeFile file('test.keystore')
     storePassword '123456'
   }
 }

可以手动添加签名配置,也可以通过Project Structure 选中app,点击Singing添加,具体步骤如下图所示:

史上最全Android build.gradle配置详解(小结)

签名配置完成后可以方便带签名打包,在module的Build Variants中有两个Type,分别是debug和release,可以选择任意一个类型进行打包,并且他们会利用各自配置的Key进行打包,执行 Run app或者Build->Build apk就会自动在module name/app/build/outputs/apk路径下生成Apk文件。另一种打包方式是Build->Generate Signed APK填写签名信息生成Apk。

2.2、compileSdkVersion:设置编译时用的Android版本

2.3、buildToolsVersion:设置编译时使用的构建工具的版本,Android Studio3.0后去除此项配置

2.4、defaultConfig{}闭包:


 compileSdkVersion 27//设置编译时用的Android版本
 defaultConfig {
   applicationId "com.billy.myapplication"//项目的包名
   minSdkVersion 16//项目最低兼容的版本
   targetSdkVersion 27//项目的目标版本
   versionCode 1//版本号
   versionName "1.0"//版本名称
   testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"//表明要使用AndroidJUnitRunner进行单元测试
 }
  1. applicationId :指定了项目的包名。

  2. minSdkVersion :指定项目最低兼容的版本,如果设备小于这个版本或者大于maxSdkVersion(一般不用)将无法安装这个应用,这里指定为16,表示最低兼容到Android 4.1系统。

  3. targetSdkVersion :指定项目的目标版本,表示在该目标版本上已经做过充分测试,系统会为该应用启动一些对应该目标系统的最新功能特性,Android系统平台的行为变更,只有targetSdkVersion的属性值被设置为大于或等于该系统平台的API版本时,才会生效。例如,若指定targetSdkVersion值为22,则表示该程序最高只在Android5.1版本上做过充分测试,在Android6.0系统上(对应targetSdkVersion为23)拥有的新特性如系统运行时权限等功能就不会被启用。

  4. versionCode :表示版本号,一般每次打包上线时该值只能增加,打包后看不见。

  5. versionName :表示版本名称,展示在应用市场上。

  6. testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"表明要使用AndroidJUnitRunner进行单元测试。

2.5、 buildTypes{}闭包:

这个闭包主要指定生成安装文件的主要配置,一般包含两个子闭包,一个是debug闭包,用于指定生成测试版安装文件的配置,可以忽略不写;另一个是release闭包,用于指定生成正式版安装文件的配置。两者能配置的参数相同,最大的区别默认属性配置不一样,两种模式支持的属性配置如下图:

史上最全Android build.gradle配置详解(小结)


buildTypes {// 生产/测试环境配置
   release {// 生产环境
     buildConfigField("boolean", "LOG_DEBUG", "false")//配置Log日志
     buildConfigField("String", "URL_PERFIX", "\"https://release.cn/\"")// 配置URL前缀
     minifyEnabled false//是否对代码进行混淆
     proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'//指定混淆的规则文件
     signingConfig signingConfigs.release//设置签名信息
     pseudoLocalesEnabled false//是否在APK中生成伪语言环境,帮助国际化的东西,一般使用的不多
     zipAlignEnabled true//是否对APK包执行ZIP对齐优化,减小zip体积,增加运行效率
     applicationIdSuffix 'test'//在applicationId 中添加了一个后缀,一般使用的不多
     versionNameSuffix 'test'//在applicationId 中添加了一个后缀,一般使用的不多
   }
   debug {// 测试环境
     buildConfigField("boolean", "LOG_DEBUG", "true")//配置Log日志
     buildConfigField("String", "URL_PERFIX", "\"https://test.com/\"")// 配置URL前缀
     minifyEnabled false//是否对代码进行混淆
     proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'//指定混淆的规则文件
     signingConfig signingConfigs.debug//设置签名信息
     debuggable false//是否支持断点调试
     jniDebuggable false//是否可以调试NDK代码
     renderscriptDebuggable false//是否开启渲染脚本就是一些c写的渲染方法
     zipAlignEnabled true//是否对APK包执行ZIP对齐优化,减小zip体积,增加运行效率
     pseudoLocalesEnabled false//是否在APK中生成伪语言环境,帮助国际化的东西,一般使用的不多
     applicationIdSuffix 'test'//在applicationId 中添加了一个后缀,一般使用的不多
     versionNameSuffix 'test'//在applicationId 中添加了一个后缀,一般使用的不多
   }
 }

release{}闭包和debug{}闭包两者能配置的参数相同,最大的区别默认属性配置不一样:

  • minifyEnabled :表明是否对代码进行混淆,true表示对代码进行混淆,false表示对代码不进行混淆,默认的是false。

  • proguardFiles :指定混淆的规则文件,这里指定了proguard-android.txt文件和proguard-rules.pro文件两个文件,proguard-android.txt文件为默认的混淆文件,里面定义了一些通用的混淆规则。proguard-rules.pro文件位于当前项目的根目录下,可以在该文件中定义一些项目特有的混淆规则。

  • buildConfigField :用于解决Beta版本服务和Release版本服务地址不同或者一些Log打印需求控制的。例如:配置buildConfigField("boolean", "LOG_DEBUG", "true"),这个方法接收三个非空的参数,第一个:确定值的类型,第二个:指定key的名字,第三个:传值,调用的时候BuildConfig.LOG_DEBUG即可调用。

  • debuggable :表示是否支持断点调试,release默认为false,debug默认为true。

  • jniDebuggable :表示是否可以调试NDK代码,使用lldb进行c和c++代码调试,release默认为false

  • signingConfig :设置签名信息,通过signingConfigs.release或者signingConfigs.debug,配置相应的签名,但是添加此配置前必须先添加signingConfigs闭包,添加相应的签名信息。

  • renderscriptDebuggable :表示是否开启渲染脚本就是一些c写的渲染方法,默认为false。

  • renderscriptOptimLevel :表示渲染等级,默认是3。

  • pseudoLocalesEnabled :是否在APK中生成伪语言环境,帮助国际化的东西,一般使用的不多。

  • applicationIdSuffix :和defaultConfig中配置是一的,这里是在applicationId 中添加了一个后缀,一般使用的不多。

  • versionNameSuffix :表示添加版本名称的后缀,一般使用的不多。

  • zipAlignEnabled :表示是否对APK包执行ZIP对齐优化,减小zip体积,增加运行效率,release和debug默认都为true。

2.6、sourceSets{}闭包:配置目录指向


sourceSets {//目录指向配置
   main {
     jniLibs.srcDirs = ['libs']//指定lib库目录
   }
 }

配置 jniLibs.srcDirs = ['libs'],可以在Android studio的Android视图下生成jniLibs文件夹,可以方便我们存放jar包和库文件,其中Android视图下的jniLibs和project视图下的libs指向同一文件夹(app→libs),如下图所示:

史上最全Android build.gradle配置详解(小结)

2.7、packagingOptions{}闭包:打包时的相关配置

当项目中依赖的第三方库越来越多时,有可能会出现两个依赖库中存在同一个(名称)文件。如果这样,Gradle在打包时就会提示错误(警告)。那么就可以根据提示,然后使用以下方法将重复的文件剔除,比较常用的是通过exclude去除重复的文件,例如:


 packagingOptions{
   //pickFirsts做用是 当有重复文件时 打包会报错 这样配置会使用第一个匹配的文件打包进入apk
   // 表示当apk中有重复的META-INF目录下有重复的LICENSE文件时 只用第一个 这样打包就不会报错
   pickFirsts = ['META-INF/LICENSE']

//merges何必 当出现重复文件时 合并重复的文件 然后打包入apk
   //这个是有默认值得 merges = [] 这样会把默默认值去掉 所以我们用下面这种方式 在默认值后添加
   merge 'META-INF/LICENSE'

//这个是在同时使用butterknife、dagger2做的一个处理。同理,遇到类似的问题,只要根据gradle的提示,做类似处理即可。
   exclude 'META-INF/services/javax.annotation.processing.Processor'
 }

2.8、productFlavors{}闭包:多个渠道配置

这个配置是经常会使用到的,通常在适配多个渠道的时候,需要为特定的渠道做部分特殊的处理,比如设置不同的包名、应用名等。场景:当我们使用友盟统计时,通常需要设置一个渠道ID,那么我们就可以利用productFlavors来生成对应渠道信息的包,如:


android {
 productFlavors {
   wandoujia {
     //豌豆荚渠道包配置
     manifestPlaceholders = [UMENG_CHANNEL_VALUE: "wandoujia"]
     //manifestPlaceholders的使用在后续章节(AndroidManifest里的占位符)中介绍
   }
   xiaomi {
     manifestPlaceholders = [UMENG_CHANNEL_VALUE: "xiaomi"]
     applicationId "com.wiky.gradle.xiaomi" //配置包名

}
   _360 {
     manifestPlaceholders = [UMENG_CHANNEL_VALUE: "_360"]
   }
   //...
 }
}

当然也有更简洁的方式:


android {
 productFlavors {
   wandoujia {}
   xiaomi {}
   _360 {}
   //...
 }

productFlavors.all {
   //批量修改,类似一个循序遍历
   flavor -> flavor.manifestPlaceholders = [UMENG_CHANNEL_VALUE: name]
 }
}

配置完之后,在命令行窗口中(Terminal)中输入gradlew assembleRelease(windows)即可开始打包,在Mac系统中对应指令应该是./gradlew assembleRelease。当然,如果想要debug版本的包,将指令中assembleRelease改为assembleDebug即可。最后生成的包还是在app/build/outputs/apk中,默认命名格式如app-wandoujia-release-unsigned.apk,在module的Build Variants中可以选择相应的渠道。

注:Android Studio3.0需在主app的build.gradle里面的


defaultConfig {

targetSdkVersion:***

minSdkVersion :***

versionCode:***

versionName :***

//版本名后面添加一句话,意思就是flavor dimension 它的维度就是该版本号,这样维度就是都是统一的了

flavorDimensions "versionCode"

}

2.9、lintOptions{}闭包:代码扫描分析

Lint 是Android Studio 提供的 代码扫描分析工具,它可以帮助我们发现代码结构/质量问题,同时提供一些解决方案,而且这个过程不需要我们手写测试用例。

Lint 发现的每个问题都有描述信息和等级(和测试发现 bug 很相似),我们可以很方便地定位问题,同时按照严重程度进行解决。


//程序在编译的时候会检查lint,有任何错误提示会停止build,我们可以关闭这个开关
 lintOptions {
   abortOnError false //即使报错也不会停止打包
   checkReleaseBuilds false //打包release版本的时候进行检测
 }

3、dependencies{}闭包:

该闭包定义了项目的依赖关系,一般项目都有三种依赖方式:本地依赖、库依赖和远程依赖。本地依赖可以对本地的jar包或目录添加依赖关系,库依赖可以对项目中的库模块添加依赖关系,远程依赖可以对jcener库上的开源项目添加依赖关系。 从Android Studio3.0后compile引入库不在使用,而是通过api和implementation,api完全等同于以前的compile,用api引入的库整个项目都可以使用,用implementation引入的库只有对应的Module能使用,其他Module不能使用,由于之前的项目统一用compile依赖,导致的情况就是模块耦合性太高,不利于项目拆解,使用implementation之后虽然使用起来复杂了但是做到降低偶合兴提高安全性。


dependencies {//项目的依赖关系
 implementation fileTree(include: ['*.jar'], dir: 'libs')//本地jar包依赖
 implementation 'com.android.support:appcompat-v7:27.1.1'//远程依赖
 implementation 'com.android.support.constraint:constraint-layout:1.1.2'
 testImplementation 'junit:junit:4.12'//声明测试用例库
 androidTestImplementation 'com.android.support.test:runner:1.0.2'
 androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2'
}

implementation fileTree(include: ['*.jar'], dir: 'libs'):implementation fileTree是一个本地依赖声明,表示将libs目录下所有.jar后缀的文件都添加到项目的构建路径当中。

 implementation 'com.android.support:appcompat-v7:27.1.1' :implementation语句为 远程依赖声明,'com.android.support:appcompat-v7:27.1.1'为一个标准的远程依赖库格式,其中com.android.support为域名部分,用于区分不同公司的库;appcompat-v7为组件名称,用于区分同一个公司的不同库;27.1.1为版本号,用于区分同一个库的不同版本。加上这句声明后,Gradle在构建项目时会先检查一下本地是否已经缓存过该库,若没有缓存则自动联网下载,下载后自动添加到项目的构建路径中去。

testImplementation和androidTestImplementation :表示声明测试用例库。

Module完整的build.gradle配置如下:


// 声明是Android程序,
//com.android.application 表示这是一个应用程序模块
//com.android.library 标识这是一个库模块
//而这区别:前者可以直接运行,后着是依附别的应用程序运行
apply plugin: 'com.android.application'

android {
 signingConfigs {// 自动化打包配置
   release {// 线上环境
     keyAlias 'test'
     keyPassword '123456'
     storeFile file('test.jks')
     storePassword '123456'
   }
   debug {// 开发环境
     keyAlias 'test'
     keyPassword '123456'
     storeFile file('test.jks')
     storePassword '123456'
   }
 }
 compileSdkVersion 27//设置编译时用的Android版本
 defaultConfig {
   applicationId "com.billy.myapplication"//项目的包名
   minSdkVersion 16//项目最低兼容的版本
   targetSdkVersion 27//项目的目标版本
   versionCode 1//版本号
   versionName "1.0"//版本名称
   flavorDimensions "versionCode"
   testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"//表明要使用AndroidJUnitRunner进行单元测试
 }
 buildTypes {// 生产/测试环境配置
   release {// 生产环境
     buildConfigField("boolean", "LOG_DEBUG", "false")//配置Log日志
     buildConfigField("String", "URL_PERFIX", "\"https://release.cn/\"")// 配置URL前缀
     minifyEnabled false//是否对代码进行混淆
     proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'//指定混淆的规则文件
     signingConfig signingConfigs.release//设置签名信息
     pseudoLocalesEnabled false//是否在APK中生成伪语言环境,帮助国际化的东西,一般使用的不多
     zipAlignEnabled true//是否对APK包执行ZIP对齐优化,减小zip体积,增加运行效率
     applicationIdSuffix 'test'//在applicationId 中添加了一个后缀,一般使用的不多
     versionNameSuffix 'test'//在applicationId 中添加了一个后缀,一般使用的不多
   }
   debug {// 测试环境
     buildConfigField("boolean", "LOG_DEBUG", "true")//配置Log日志
     buildConfigField("String", "URL_PERFIX", "\"https://test.com/\"")// 配置URL前缀
     minifyEnabled false//是否对代码进行混淆
     proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'//指定混淆的规则文件
     signingConfig signingConfigs.debug//设置签名信息
     debuggable false//是否支持断点调试
     jniDebuggable false//是否可以调试NDK代码
     renderscriptDebuggable false//是否开启渲染脚本就是一些c写的渲染方法
     zipAlignEnabled true//是否对APK包执行ZIP对齐优化,减小zip体积,增加运行效率
     pseudoLocalesEnabled false//是否在APK中生成伪语言环境,帮助国际化的东西,一般使用的不多
     applicationIdSuffix 'test'//在applicationId 中添加了一个后缀,一般使用的不多
     versionNameSuffix 'test'//在applicationId 中添加了一个后缀,一般使用的不多
   }
 }

sourceSets {//目录指向配置
   main {
     jniLibs.srcDirs = ['libs']//指定lib库目录
   }
 }

packagingOptions{//打包时的相关配置
   //pickFirsts做用是 当有重复文件时 打包会报错 这样配置会使用第一个匹配的文件打包进入apk
   // 表示当apk中有重复的META-INF目录下有重复的LICENSE文件时 只用第一个 这样打包就不会报错
   pickFirsts = ['META-INF/LICENSE']

//merges何必 当出现重复文件时 合并重复的文件 然后打包入apk
   //这个是有默认值得 merges = [] 这样会把默默认值去掉 所以我们用下面这种方式 在默认值后添加
   merge 'META-INF/LICENSE'

//这个是在同时使用butterknife、dagger2做的一个处理。同理,遇到类似的问题,只要根据gradle的提示,做类似处理即可。
   exclude 'META-INF/services/javax.annotation.processing.Processor'
 }

productFlavors {
   wandoujia {}
   xiaomi {}
   _360 {}
 }

productFlavors.all {
     //批量修改,类似一个循序遍历
   flavor -> flavor.manifestPlaceholders = [IFLYTEK_CHANNEL: name]
 }

//程序在编译的时候会检查lint,有任何错误提示会停止build,我们可以关闭这个开关
 lintOptions {
   abortOnError false
   //即使报错也不会停止打包
   checkReleaseBuilds false
   //打包release版本的时候进行检测
 }

}

dependencies {
 //项目的依赖关系
 implementation fileTree(include: ['*.jar'], dir: 'libs')
 //本地jar包依赖
 implementation 'com.android.support:appcompat-v7:27.1.1'
 //远程依赖
 implementation 'com.android.support.constraint:constraint-layout:1.1.2'
 testImplementation 'junit:junit:4.12'
 //声明测试用例库
 androidTestImplementation 'com.android.support.test:runner:1.0.2'
 androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2'
}

来源:https://www.jianshu.com/p/98b61326acf7

标签:Android,build.gradle
0
投稿

猜你喜欢

  • springboot之如何获取项目目录路径

    2022-08-09 21:44:17
  • C#使用FtpWebRequest与FtpWebResponse完成FTP操作

    2021-08-24 04:58:26
  • Springboot+SpringSecurity+JWT实现用户登录和权限认证示例

    2021-11-14 11:06:11
  • C# 多线程编程技术基础知识入门

    2023-05-27 08:00:24
  • Unity3D获取当前键盘按键及Unity3D鼠标、键盘的基本操作

    2023-06-01 18:01:45
  • spring security动态配置url权限的2种实现方法

    2021-06-25 15:31:12
  • MyBatis多对多关联映射创建示例

    2023-08-09 06:40:10
  • Java 普通代码块静态代码块执行顺序(实例讲解)

    2022-07-11 05:44:28
  • JDK8并行流及串行流区别原理详解

    2023-06-25 16:23:39
  • Java解压和压缩带密码的zip文件过程详解

    2023-07-16 15:32:16
  • Java多种经典排序算法(含动态图)

    2023-09-24 00:45:02
  • Android开发中requestfocus()无效的原因及解决办法

    2023-05-25 07:15:00
  • Android中实现根据资源名获取资源ID

    2023-06-20 04:18:30
  • Java Runtime的使用详解

    2021-10-23 06:46:39
  • 一篇文章超详细的介绍Java继承

    2023-11-23 08:30:12
  • C#控件picturebox实现图像拖拽和缩放

    2023-08-09 08:23:05
  • 基于Spring-Security自定义登陆错误提示信息

    2021-09-20 17:33:40
  • C#多线程系列之任务基础(一)

    2022-12-09 04:48:22
  • C#键值对容器的介绍

    2023-04-14 12:26:56
  • Java命令设计模式优雅解耦命令和执行提高代码可维护性

    2023-11-23 06:25:46
  • asp之家 软件编程 m.aspxhome.com