Gradle实战及学习建议

末蓝、 2022-06-01 06:19 155阅读 0赞

前言
    
      
       相信不少使用Android Studio开发Android的朋友都在为Gradle中的一些配置疑惑，今天来介绍一下我在学习Gradle的一些经验和总结，希望能对大家有所帮助。先大致的看一张Gradle学习的结构图，对正片文章有个大致的了解，其次逐一说明一些Android Gradle 插件中的一些变量的含义及用法实例。
    
      
       Gradle学习框架图 
    
      
       Groovy简介
    
      
       由于Gradle使用Groovy作为默认的编译语言，所以在学习Gradle之前，可以简单的了解一下Groovy的一些简单语法会事半功倍。
    
      
       Groovy特点
    
      
       Groovy和Java一样，源码都会被编译成class字节码文件然后可以在JVM中运行； Groovy兼容所有的Java语法，也就是说，你可以在.groovy中直接写Java代码，编译运行； Groovy中自定义变量和方法都使用关键字 def 来定义； 闭包（注意，这将是在Gradle配置中经常使用的） 
    
      
       关于Groovy的语法学习教程很多，这里篇幅原因，就不详细解释了。可以参看简书的另一篇博文：《Groovy语法》
    
      
       Gradle语法介绍
    
      
       这里就具体的Gradle语法进行介绍，如果要详细介绍可能需要一本书才能讲完。本文仅结合具体的项目来介绍一些关键的知识点。 在Gradle中，每个Project都对应一个build.gradle文件，而buidl.gralde中定义了每个Project所需要执行的Task，而这些Task是由具体的插件(Plugin)决定的。 比如Java Project的Gradle插件在build.gradle中配置如下：
    
      
       group 'Sample' version '1.0-SNAPSHOT' //配置java插件 apply plugin: 'java' //编译源文件时使用的Java版本 sourceCompatibility = 1.5 repositories { mavenCentral() } dependencies { testCompile group: 'junit', name: 'junit', version: '4.11' } 
      
       以上是我基于IDEA新建的一个简单的Java工程，build.gralde为自动生成文件。由于项目为Java工程，所以需要使用Gradle的Java插件来定义编译规则。 同理，我们在使用AndroidStudio 新建一个Android项目时，也会生成对应的build.gradle文件。以新建一个Sample工程为例： /app/build.gradle如下（注释详解）：
      
       //使用Gradle Android插件 //DSL语法网址：http://google.github.io/android-gradle-dsl/current/index.html apply plugin: 'com.android.application' //android{...} 表示插件的 dsl 入口，凡是在DSL中定义的都只在此闭包中生效 android { //编译的sdk版本（必填） compileSdkVersion 23 //构建工具版本 （必填） buildToolsVersion "23.0.2" //默认配置 defaultConfig { //应用标识 applicationId "com.mrljdx.sample" //最小sdk版本 minSdkVersion 9 //编译sdk版本 targetSdkVersion 23 //版本号 versionCode 1 //版本名称 versionName "1.0" } //编译类型，在构建编译变种时，可以在此定义 buildTypes { release { minifyEnabled false proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' } } //android dsl 结束 } dependencies { compile fileTree(dir: 'libs', include: ['*.jar']) testCompile 'junit:junit:4.12' compile 'com.android.support:appcompat-v7:23.2.0' compile 'com.android.support:design:23.2.0' } 
      
       Gradle Android Plugin 工程目录结构约定如下：
      
       
      
       Android工程目录结构.png 
      
       
    其中说明一下
      
       jniLibs目录，它主要存放.so库文件。在
      
       jni文件夹下存放ndk编译相关的c/c++文件，编译后生成的文件会在jniLibs中，Gradle默认读取jniLibs目录下的.so库文件，所以一般习惯于Eclipse的为了改变文件目录，会使用Android Plugin 的 DSL 语法 sourceSet来重新定义文件目录，如下：
      
       
      
       sourceSets { main { //将jniLibs下的文件/子文件目录 定义到与'src'同级的'libs'目录下 jniLibs.srcDirs = ['libs'] } } 
      
       对比Eclipse目录结构和Android Studio的目录结构
      
       Eclipse.png 
      
       AndroidStudio.png 
      
       
    
      
       可以发现在Android Studio中，会默认识别Gradle Android Plugin 预先约定的工程目录结构，有些文件夹会变成蓝色，表示源码目录，而带有数据表示的文件夹，则表示存放资源文件。这点比起Eclipse要好很多。 那么问题来了，如何通过配置build.gralde来适配Eclipse工程导出的文件目录结构呢？其实不难，如下配置即可：
      
       sourceSets { main { manifest.srcFile 'AndroidManifest.xml' java.srcDirs = ['src'] resources.srcDirs = ['src'] aidl.srcDirs = ['src'] renderscript.srcDirs = ['src'] res.srcDirs = ['res'] assets.srcDirs = ['assets'] } // Move the tests to tests/java, tests/res, etc... instrumentTest.setRoot('tests') // Move the build types to build-types/<type> // For instance, build-types/debug/java, build-types/debug/AndroidManifest.xml, ... // This moves them out of them default location under src/<type>/... which would // conflict with src/ being used by the main source set. // Adding new build types or product flavors should be accompanied // by a similar customization. debug.setRoot('build-types/debug') release.setRoot('build-types/release') androidTest.setRoot('test') } 
      
       理解以上代码并不难，请参阅《Android Plugin DSL参考手册》 即可。
      
       Gradle的生命周期
      
       通过分析Android Studio创建的项目结构或者IDEA创建的Java工程项目结构，不难发现，在每个Project的根目录下，一定会存在 setting.gradle文件。 Gradle有一个初始化流程，这个时候setting.gradle会执行，通过setting.gradle可以获取当前整个工程的配置获取一个Settings对象(查看Gradle DSL参考手册 了解更多详情) 关于Gradle的Project相关的生命周期、任务、依赖等官方解释如下：
      
       
      
       Gradle Offical.png 
      
       
    可以简单的总结一下，就是在初始化时，读取setting.gradle中的项目配置，来确定编译的工程，通过每个工程中的build.gradle来确定编译的任务，而这些任务是由对应的plugin来决定的，比如 'com.android.application'插件决定编译成apk，而'com.android.library'插件决定项目编译成.aar库文件等。
      
       
    在每个插件中，都有相应的语法约定。通过
      
       Android DSL 手册 可以理解为啥要那么定义。以及每个定义中的变量所对应的类型和方法。
      
       
    在博客
      
       《Android中实用的Gradle配置》 中说明了一个应用在开发过程中的一些配置问题，其中对于每一个配置都有解释说明，感兴趣的可以参考一下。
      
       
      
       Gradle学习建议
      
       关于Gradle的具体语法相关DSL细节，如果在这里讲可能要写很多。授人以鱼不如授人以渔，这里结合自身的学习过程给大家一点建议和参考：
      
       Gradle 官方文档 ：了解Project对应的章节，仔细阅读LifeCycle、Tasks、Dependencies、Multi-project Builds、Plugins、Properties、Extra Properties、Dynamic Methods相关内容。基本上可以理解为何一个工程项目的结构以及依赖是如何导入的。 深入理解Android（一）：Gradle详解 ：详细的介绍了Groovy相关语法、Gradle构建细节等内容。其中关于Groovy的 List、Map、Range、闭包等内容值得细看，因为在Gradle的使用中，比如多版本多渠道的APK构建会用到这些内容。 Android DSL 参考手册 ：可以结合本片文章开头的图来进行系统学习，了解Android DSL的语法层级，了解构建的一些内容，理解即可。 Gralde In Action 中文版：看名字就知道，这本书主要讲解一些Gradle常用的实例讲解，可以好好看看 
      
       END
      
       由于个人能力有限，在文中如有纰漏还请斧正，关于Gradle构建项目相关的问题欢迎交流，开卷有益~
     
      
    
    作者：追云_似梦
    链接：https://www.jianshu.com/p/b7fc7a6abffb
    來源：简书
    著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。