build.gradle 详解（一）

待我称王封你为后i 2023-06-16 07:54 188阅读 0赞

# 简述： #

1） Java 开发中有两个大名鼎鼎的项目构建 ANT、Maven。

2） Google 推荐使用的 Android studio 是采用 Gradle 来构建项目。Gradle 是一个非常先进的项目构建工具。

Gradle 是用了一种基于 Groovy 的领域特定语言（DSL，Demain Specific Language）来声明项目设置，摒弃了 XML（如 ANT 和 Maven）的各种繁琐配置。

3） 项目中一般会出现2个或者多个 build.gradle 文件，一个在根目录下，一个在 app 目录下。

如果切换到 Android 模式下则全部在 Gradle Scripts。

![format_png][]

# 1. 根目录下的 build.gradle #

1） repositories 闭包，声明了 jcenter() 的配置；

2） dependencies 闭包，声明了一个 Gradle 插件。

![复制代码][aHR0cHM6Ly9jb21tb24uY25ibG9ncy5jb20vaW1hZ2VzL2NvcHljb2RlLmdpZg]

1 buildscript {
     2     
     3     repositories {  //repositories闭包
     4         google()
     5         jcenter() //代码托管库：设置之后可以在项目中轻松引用jcenter上的开源项目
     6     }
     7     dependencies {  //dependencies闭包
     8         classpath 'com.android.tools.build:gradle:3.0.0' 声明gradle插件，插件版本号为3.0.0
     9         //gradle是一个强大的项目构建工具，不仅可以构建Android，还可以构建java，C++等
    10         //此处引用android的插件
    11         // NOTE: Do not place your application dependencies here; they belong
    12         // in the individual module build.gradle files
    13     }
    14 }
    15 
    16 allprojects {
    17     repositories {
    18         google()
    19         jcenter() //代码托管库：设置之后可以在项目中轻松引用jcenter上的开源项目
    20     }
    21 }
    22 
    23 task clean(type: Delete) {
    24     delete rootProject.buildDir
    25 }

![复制代码][aHR0cHM6Ly9jb21tb24uY25ibG9ncy5jb20vaW1hZ2VzL2NvcHljb2RlLmdpZg]

# 2. app 目录下的build.gradle #

1） **apply plugin**，声明是 Android 应用程序还是库模块；

2）** android 闭包**，配置项目构建的各种属性，compileSDKVersion 用于指定项目的变异 SDK  版本， buildToolsVersion 用户指定项目构建工具的版本。

◆ defaultConfig 闭包：默认配置、应用程序包名、最小sdk版本、目标sdk版本、版本号、版本名称；

◆ buildTypes 闭包：指定生成安装文件的配置，是否对代码进行混淆；

◆ signingConfigs 闭包：签名信息配置；

◆ sourceSets  闭包：源文件路径配置；

◆ lintOptions 闭包：lint 配置；

3） **dependencies 闭包**，指定当前项目的所有以来关系，本地以来，库依赖以及远程依赖；

4）** repositories 闭包**，仓库配置。

![复制代码][aHR0cHM6Ly9jb21tb24uY25ibG9ncy5jb20vaW1hZ2VzL2NvcHljb2RlLmdpZg]

1 // 声明是Android程序，
      2 // com.android.application 表示这是一个应用程序模块,可直接运行
      3 // com.android.library 标识这是一个库模块，是依附别的应用程序运行
      4 apply plugin: 'com.android.application'
      5 
      6 android {
      7     // 程序在编译的时候会检查lint，有任何错误提示会停止build，我们可以关闭这个开关
      8     lintOptions {
      9         // 即使报错也不会停止打包
     10         abortOnError false
     11         // 打包release版本的时候是否进行检测
     12         checkReleaseBuilds false
     13     }
     14 
     15     // 编译sdk的版本，也就是API Level，例如API-19、API-20、API-21等等。
     16     compileSdkVersion 27
     17     // build tools的版本，其中包括了打包工具aapt、dx等等。
     18     // 这个工具的目录位于你的sdk目录/build-tools/下
     19     buildToolsVersion '27.0.3'
     20 
     21     //关闭Android Studio的PNG合法性检查
     22     aaptOptions.cruncherEnabled = false
     23     aaptOptions.useNewCruncher = false
     24 
     25     defaultConfig {  // 默认配置
     26         applicationId "com.demo.test" // 应用程序的包名
     27         minSdkVersion 22  / 最小sdk版本，如果设备小于这个版本或者大于maxSdkVersion将无法安装这个应用
     28         targetSdkVersion 27 // 目标sdk版本，充分测试过的版本（建议版本）
     29         versionCode 1  // 版本号，第一版是1，之后每更新一次加1
     30         versionName "1.0" // 版本名，显示给用户看到的版本号
     31 
     32         archivesBaseName = "demo-$versionName" // 指定打包成Jar文件时候的文件名称
     33         ndk {
     34             moduleName "testwifisafe"                   // 设置库(so)文件名称
     35             ldLibs "log", "z", "m", "jnigraphics", "android"
     36             // 引入库，比如要用到的__android_log_print
     37             abiFilters "armeabi", "x86", "armeabi-v7a"      // "x86"  显示指定支持的ABIs
     38             cFlags "-std=c++11 -fexceptions"                // C++11
     39             stl "gnustl_static"
     40         }
     41 
     42         // 当方法数超过65535(方法的索引使用的是一个short值，
     43         // 而short最大值是65535)的时候允许打包成多个dex文件，动态加载dex。这里面坑很深啊
     44         multiDexEnabled true
     45 
     46         // Instrumentation单元测试
     47         testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
     48     }
     49 
     50     // 默认的一些文件路径的配置
     51     sourceSets {
     52         main {
     53             manifest.srcFile 'AndroidManifest.xml' // 指定清单文件
     54             res.srcDirs = ['res'] // 指定res资源目录
     55             assets.srcDirs = ['assets']    // asset资源目录
     56             jni.srcDirs 'src/main/jni'     // jni代码目录
     57             jniLibs.srcDir 'src/main/jniLibs' // jni库目录
     58             java.srcDirs = ['src'] // 指定java源代码目录
     59             resources.srcDirs = ['src'] // 指定resource目录
     60             aidl.srcDirs = ['src'] // 指定aidl目录
     61             renderscript.srcDirs = ['src'] // 指定source目录
     62         }
     63         debug.setRoot('build-types/debug') // 指定debug模式的路径
     64         release.setRoot('build-types/release') // 指定release模式的路径
     65     }
     66 
     67     // multiDex的一些相关配置，这样配置可以让你的编译速度更快
     68     dexOptions {
     69         // 让它不要对Lib做preDexing
     70         preDexLibraries = false
     71         // 开启incremental dexing,优化编译效率，这个功能android studio默认是关闭的。
     72         incremental true
     73         javaMaxHeapSize "4g" // 增加java堆内存大小
     74     }
     75 
     76     signingConfigs {// 签名配置
     77         release {// 发布版签名配置
     78             storeFile file("fk.keystore") // 密钥文件路径
     79             storePassword "123456" // 密钥文件密码
     80             keyAlias "fk" // key别名
     81             keyPassword "123456" // key密码
     82         }
     83         debug {// debug版签名配置
     84             storeFile file("fk.keystore")
     85             storePassword "123456"
     86             keyAlias "fk"
     87             keyPassword "123456"
     88         }
     89     }
     90 
     91     // 指定生成安装文件的配置，常有两个子包:release,debug，注：直接运行的都是debug安装文件
     92     buildTypes {
     93         // release版本的配置，即生成正式版安装文件的配置
     94         release {
     95             zipAlignEnabled true  // 是否支持zip
     96             shrinkResources true  // 移除无用的resource文件
     97             minifyEnabled false // 是否对代码进行混淆，true表示混淆
     98             // 指定混淆时使用的规则文件；
     99             // proguard-android.txt指所有项目通用的混淆规则，proguard-rules.pro当前项目特有的混淆规则
    100             // release的Proguard默认为Module下的proguard-rules.pro文件
    101             proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
    102             debuggable false  //是否支持调试
    103             //ndk的一些配置
    104             ndk {
    105                 // cFlags "-std=c++11 -fexceptions -O3 -D__RELEASE__" // C++11
    106                 // platformVersion = "19"
    107                 moduleName "hebbewifisafe" // 设置库(so)文件名称
    108                 ldLibs "log", "z", "m", "jnigraphics", "android"
    109                 // 引入库，比如要用到的__android_log_print
    110                 abiFilters "armeabi", "x86", "armeabi-v7a"// "x86"
    111                 cFlags "-std=c++11 -fexceptions" // C++11
    112                 stl "gnustl_static"
    113             }
    114             // 采用动态替换字符串的方式生成不同的 release.apk （3.0之后版本的修改方式）
    115             applicationVariants.all { variant ->
    116                 variant.outputs.all { output ->
    117                     if (!variant.buildType.isDebuggable()) {
    118                         // 获取签名的名字 variant.signingConfig.name
    119                         // 要被替换的源字符串
    120                         def sourceFile = "app-release";
    121                         // 替换的字符串
    122　　　　　　　　　　　　　　　def replaceFile = "Demo-V${variant.versionName}.${releaseTime()}"
    123　　　　　　　　　　　　　　　outputFileName = output.outputFile.name.replace(sourceFile, replaceFile)
    124                     }
    125                 }
    126             }
    127             jniDebuggable false  // 关闭jni调试
    128         }
    129         debug { // debug版本的配置
    130             minifyEnabled false
    131             zipAlignEnabled true
    132             shrinkResources true // 移除无用的resource文件
    133             proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
    134             debuggable true
    135 //          jniDebuggable true
    136             ndk {
    137                 cFlags "-std=c++11 -fexceptions -g -D __DEBUG__" // C++11
    138             }
    139             jniDebuggable true
    140         }
    141     }
    142 
    143     packagingOptions {
    144         exclude 'META-INF/ASL2.0'
    145         exclude 'META-INF/LICENSE'
    146         exclude 'META-INF/NOTICE'
    147         exclude 'META-INF/MANIFEST.MF'
    148     }
    149     
    150     compileOptions {
    151         // 在这里你可以进行 Java 的版本配置，
    152         // 以便使用对应版本的一些新特性
    153     }
    154     productFlavors {
    155         // 在这里你可以设置你的产品发布的一些东西，
    156         // 比如你现在一共软件需要发布到不同渠道，
    157         // 且不同渠道中的包名不同，那么可以在此进行配置；
    158         // 甚至可以设置不同的 AndroidManifest.xml 文件。
    159         hebbe {
    160         }
    161         googlePlay {
    162         }
    163         solo {
    164         }
    165     }
    166     productFlavors.all {
    167         flavor -> flavor.manifestPlaceholders = [UMENG_CHANNEL_VALUE: name]
    168     }
    169     // 所谓ProductFlavors其实就是可定义的产品特性，
    170     // 配合 manifest merger 使用的时候就可以达成在一次编译
    171     // 过程中产生多个具有自己特性配置的版本。
    172     // 上面这个配置的作用就是，为每个渠道包产生不同的 UMENG_CHANNEL_VALUE 的值。
    173 }
    174 
    175 // 指定当前项目的所有依赖关系：本地依赖、库依赖、远程依赖
    176 // 本地依赖：可以对本地 Jar 包或目录添加依赖关系
    177 // 库依赖：可以对项目中的库模块添加依赖关系
    178 // 远程依赖：可以对 jcenter 库上的开源项目添加依赖
    179 // 标准的远程依赖格式是 域名:组织名:版本号
    180 dependencies {
    181     implementation fileTree(dir: 'libs', include: ['*.jar']) // 本地依赖
    182     // 远程依赖，com.android.support是域名部分，appcompat-v7是组名称，26.1.0是版本号
    183     implementation 'com.android.support:appcompat-v7:26.1.0'
    184     implementation 'com.android.support.constraint:constraint-layout:1.0.2'
    185     implementation project(':hello') // 库依赖
    186     testImplementation 'junit:junit:4.12' // 声明测试用列库
    187     androidTestImplementation 'com.android.support.test:runner:1.0.1'
    188     androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.1'
    189 }
    190 
    191 // 声明是要使用谷歌服务框架
    192 apply plugin: 'com.google.gms.google-services'
    193 
    194 // 第三方依赖库的本地缓存路径
    195 task showMeCache << {
    196     configurations.compile.each { println it }
    197 }
    198 // 使用maven仓库。android有两个标准的library文件服务器，一个jcenter一个maven。两者毫无关系。
    199 // jcenter有的maven可能没有，反之亦然。
    200 // 如果要使用jcenter的话就把mavenCentral()替换成jcenter()
    201 repositories {
    202     mavenCentral()
    203 }
    204
    205 // 获取日期方法
    206 def releaseTime() {
    207    return new Date().format("MMdd.HHmm")
    208 }

[format_png]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pbWFnZXMyMDE4LmNuYmxvZ3MuY29tL2Jsb2cvNjQ4MDM3LzIwMTgwNi82NDgwMzctMjAxODA2MjIxMTIxMTM4ODctMTI4MDE1MTE0My5qcGc?x-oss-process=image/format,png
[aHR0cHM6Ly9jb21tb24uY25ibG9ncy5jb20vaW1hZ2VzL2NvcHljb2RlLmdpZg]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9jb21tb24uY25ibG9ncy5jb20vaW1hZ2VzL2NvcHljb2RlLmdpZg