build.gradle详解

本文详细介绍Android Studio中Gradle配置文件build.gradle的结构与用法,包括根目录与app目录下的配置项,以及如何通过Gradle进行项目构建。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

简述:

1 > java开发中有两个大名鼎鼎的项目构建ANT、Maven
2 > Google推荐使用的Android Studio是采用Gradle来构建项目的。Gradle是一个非常先进的项目构建工具。

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

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

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



系统:Windows 7 64bit

Android版本:Android Studio 3.0.0.18


1、根目录下的build.gradle


1 > repositories闭包,声明了jcenter()的配置

2 > dependencies闭包,声明了一个Gradle插件

[java]  view plain  copy
  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. }  


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闭包,仓库配置


[java]  view plain  copy
  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 26  
  17.     //build tools的版本,其中包括了打包工具aapt、dx等等。  
  18.     //这个工具的目录位于你的sdk目录/build-tools/下  
  19.     buildToolsVersion '26.0.2'  
  20.   
  21.     //关闭Android Studio的PNG合法性检查  
  22.     aaptOptions.cruncherEnabled = false  
  23.     aaptOptions.useNewCruncher = false  
  24.   
  25.     defaultConfig {  //默认配置  
  26.         applicationId "com.hebbe.espressotest" //应用程序的包名  
  27.         minSdkVersion 22  //最小sdk版本,如果设备小于这个版本或者大于maxSdkVersion将无法安装这个应用  
  28.         targetSdkVersion 26 //目标sdk版本,充分测试过的版本(建议版本)  
  29.         versionCode 1  //版本号,第一版是1,之后每更新一次加1  
  30.         versionName "1.0" //版本名,显示给用户看到的版本号  
  31.   
  32.         archivesBaseName = "weshare-$versionName" //指定打包成Jar文件时候的文件名称  
  33.         ndk {  
  34.             moduleName "hebbewifisafe"                   //设置库(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  
  115.             applicationVariants.all { variant ->  
  116.                 variant.outputs.each { output ->  
  117.                     def outputFile = output.outputFile  
  118.                     if (outputFile != null && outputFile.name.endsWith('release.apk')) {  
  119.                         def timeStamp = new Date().format('yyyyMMddHH');  
  120.                         def fileName = "WeShare-${defaultConfig.versionName}" + "-" + timeStamp + "-lj-" + ".apk";  
  121.                         output.outputFile = file("${outputFile.parent}/${fileName}")  
  122.                     }  
  123.                 }  
  124.             }  
  125.             jniDebuggable false  //关闭jni调试  
  126.         }  
  127.         debug {//debug版本的配置  
  128.             minifyEnabled false  
  129.             zipAlignEnabled true  
  130.             shrinkResources true // 移除无用的resource文件  
  131.             proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'  
  132.             debuggable true  
  133. //          jniDebuggable true  
  134.             ndk {  
  135.                 cFlags "-std=c++11 -fexceptions -g -D __DEBUG__" // C++11  
  136.             }  
  137.             jniDebuggable true  
  138.         }  
  139.     }  
  140.   
  141.     packagingOptions  
  142.         {  
  143.             exclude 'META-INF/ASL2.0'  
  144.             exclude 'META-INF/LICENSE'  
  145.             exclude 'META-INF/NOTICE'  
  146.             exclude 'META-INF/MANIFEST.MF'  
  147.         }  
  148.       
  149.     compileOptions {  
  150.         //在这里你可以进行 Java 的版本配置,  
  151.         //以便使用对应版本的一些新特性  
  152.     }  
  153.     productFlavors {  
  154.         //在这里你可以设置你的产品发布的一些东西,  
  155.         //比如你现在一共软件需要发布到不同渠道,  
  156.         //且不同渠道中的包名不同,那么可以在此进行配置;  
  157.         //甚至可以设置不同的 AndroidManifest.xml 文件。  
  158.         hebbe {  
  159.         }  
  160.         googlePlay {  
  161.         }  
  162.         solo {  
  163.         }  
  164.     }  
  165.     productFlavors.all {  
  166.         flavor -> flavor.manifestPlaceholders = [UMENG_CHANNEL_VALUE: name]  
  167.     }  
  168.     //所谓ProductFlavors其实就是可定义的产品特性,  
  169.     //配合 manifest merger 使用的时候就可以达成在一次编译  
  170.     //过程中产生多个具有自己特性配置的版本。  
  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. }  


简单的例子:

[java]  view plain  copy
  1. // 声明是Android程序,  
  2. //com.android.application 表示这是一个应用程序模块,可直接运行  
  3. //com.android.library 标识这是一个库模块,是依附别的应用程序运行  
  4. apply plugin: 'com.android.application'  
  5.   
  6. android {  
  7.     //编译sdk的版本,也就是API Level,例如API-19、API-20、API-21等等。  
  8.     compileSdkVersion 26  
  9.     //build tools的版本,其中包括了打包工具aapt、dx等等。  
  10.     //这个工具的目录位于你的sdk目录/build-tools/下  
  11.     buildToolsVersion '26.0.2'  
  12.   
  13.     //关闭Android Studio的PNG合法性检查  
  14.     aaptOptions.cruncherEnabled = false  
  15.     aaptOptions.useNewCruncher = false  
  16.   
  17.     defaultConfig {  //默认配置  
  18.         applicationId "com.hebbe.espressotest" //应用程序的包名  
  19.         minSdkVersion 22  //最小sdk版本,如果设备小于这个版本或者大于maxSdkVersion将无法安装这个应用  
  20.         targetSdkVersion 26 //目标sdk版本,充分测试过的版本(建议版本)  
  21.         versionCode 1  //版本号,第一版是1,之后每更新一次加1  
  22.         versionName "1.0" //版本名,显示给用户看到的版本号  
  23.   
  24.         //Instrumentation单元测试  
  25.         testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"  
  26.     }  
  27.   
  28.     buildTypes { //build配置  
  29.         release {  
  30.             minifyEnabled false //是否对代码进行混淆  
  31.             proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'  
  32.         }  
  33.     }  
  34. }  
  35.   
  36. //指定当前项目的所有依赖关系:本地依赖、库依赖、远程依赖  
  37. dependencies {  
  38.     implementation fileTree(dir: 'libs', include: ['*.jar']) //本地依赖  
  39.     //远程依赖,com.android.support是域名部分,appcompat-v7是组名称,26.1.0是版本号  
  40.     implementation 'com.android.support:appcompat-v7:26.1.0'  
  41.     implementation 'com.android.support.constraint:constraint-layout:1.0.2'  
  42.     testImplementation 'junit:junit:4.12' //声明测试用列库  
  43.     androidTestImplementation 'com.android.support.test:runner:1.0.1'  
  44.     androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.1'  
  45. }  


3、聊聊Groovy


Gradle选择了Groovy。Groovy基于Java并拓展了Java。 Java程序员可以无缝切换到使用Groovy开发程序。Groovy说白了就是把写Java程序变得像写脚本一样简单。写完就可以执行,Groovy内部会将其编译成Javaclass然后启动虚拟机来执行。

Groovy是一种动态语言。Groovy对自己的定义是:Groovy是在java平台上的、 具有像Python, Ruby 和 Smalltalk 语言特性的灵活动态语言, Groovy保证了这些特性像 Java语法一样被 Java开发者使用。




参考:

详解build.gradle

深入理解Groovy


评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值