gradle在Android中的使用

参考https://www.jianshu.com/p/8b8a550246bd,整理为自己需要的方便查看

App

settings.gradle

配置Project和module

include ':app' , ':module1',':module2'

build.gradle

buildscript

gradle自身所使用的资源。可以声明的资源包括依赖项、第三方插件、仓库地址等

repositories

仓库 jcenter()、maven()和google()等

dependencies

配置依赖 classpath:'group:name:version'

ext

自定义属性

  • 只在当前配置文件使用的,在当前文件定义 ext.xxx_name='xxx',使用的时候$xxx_name获取值
  • 通用自定义配置,单独定义文件ext{xxx_1='xxx'} 在需要使用的文件中 apply from: '文件名',使用${xxx_1}获取值

allprojects

为所有项目提供共同所需依赖包

task

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

运行gradle clean时,执行此处定义的task,删除根目录中的build目录

Module

每个module都有一个build.gradle文件

build.gradle

这里主要就是dependencies,和一些plugin。主要介绍下plugin,以'com.android.application'插件为例

plugin

apply plugin:'×××': 二进制插件,一般都是被打包在一个jar里独立发布的

apply from:'×××':应用脚本插件,其实就是把这个脚本加载进来

插件的作用

  • 添加一些task,帮助完成一些工作
  • 添加一些依赖
  • 给现有对象添加一些扩展,android{}这个配置块就是Android Gradle插件为Project对象添加的一个扩展
  • 对项目进行一些约定,比如应用Java插 件之后,约定src/main/java目录下是我们的源代码存放位置

com.android.application插件

android{} 是Android插件提供的一个扩展类型,可以让我们自定义Android Gradle工程,是Android Gradle工程配置的唯一入口。下面列举一下主要的配置项。

  1. compileSdkVersion 是编译所依赖的Android SDK的版本,这里是API Level。
  2. buildToolsVersion 是构建该Android工程所用构建工具的版本。
  3. defaultConfig{} 它是一个ProductFlavor的默认的配置,后面会介绍ProductFlavor
      1. applicationId 包名,app的唯一标识。跟AndroidManifest里面的package是可以不同的。package指的是代码目录下路径;applicationId指的是app对外发布的唯一标识,会在签名、申请第三方库、发布时候用到。
      
      2. minSdkVersion 是支持的Android系统的api level
      
      3. targetSdkVersion 基于哪个Android版本开发的
      
      4. versionCode app应用内部版本号,一般用于控制app升级
      
      5. versionName app应用的版本名称,一般是发布的时候写在app上告诉用户的
      
      6. multiDexEnabled 是否启用自动拆分多个Dex的功能
      
      7. ndk{} 多平台编译,生成有so包的时候使用,包括四个平台'armeabi', 'x86', 'armeabi-v7a', 'mips'
      
      8. flavorDimensions 定义需要定制化的字段,然后在productFlavors中使用
  1. sourceSets 源代码集合,是Java插件用来描述和管理源代码及资源的一个抽象概念,是一个Java源代码文件和资源文件的集合,我们可以通过sourceSets更改源集的Java目录或者资源目录等。
  2. buildTypes 构建类型,内置了debug和release两个构建类型,一般用在代码混淆
       name:build type的名字
       applicationIdSuffix:应用id后缀
       versionNameSuffix:版本名称后缀
       debuggable:是否生成一个debug的apk
       minifyEnabled:是否混淆
       proguardFiles:混淆文件
       signingConfig:签名配置
       manifestPlaceholders:清单占位符
       shrinkResources:是否去除未利用的资源,默认false,表示不去除。
       zipAlignEnable:是否使用zipalign工具压缩。
       multiDexEnabled:是否拆成多个Dex
       multiDexKeepFile:指定文本文件编译进主Dex文件中
       multiDexKeepProguard:指定混淆文件编译进主Dex文件中
  1. signingConfigs 签名配置。一个app只有在签名之后才能被发布、安装、使用,签名是保护app的方式,标记该app的唯一性。
       storeFile: 签名文件
       storePassword: 签名证书文件的密码
       storeType: 签名证书类型
       keyAlias: 签名证书中秘钥别名
       keyPassword: 签名证书中改密钥的密码
  1. productFlavors Gradle的多渠道打包,你可以在不同的包定义不同的变量,实现自己的定制化版本的需求。
       defaultConfig 中定义的 flavorDimensions
       manifestPlaceholders 占位符,我们可以通过它动态配置AndroidManifest文件一些内容,譬如app的名字
       buildConfigField 是BuildConfig文件的一个函数,而BuildConfig这个类是Android Gradle构建脚本在编译后生成的,而buildConfigField就是其中的自定义函数变量
       定义常量 buildConfigField "boolean","isTest","true" 
       就会在BuildConfig类中添加一个变量 public static final boolean isTest = true
       然后我们就可以在代码中使用   BuildConfig.isTest
  1. dexOptions{} dx命令只是一个脚本,它调用的还是Java编写的dx.jar库,是Java程序处理的,所以当内存不足的时候,就会内存溢出。给dx分配的内存是一个G,给它增加内存分配来解决这个问题。

    dexOptions {
        javaMaxHeapSize "2g"
        incremental = true
    }
    

dependencies{}

  • compile fileTree(include: ['.jar'], dir: 'libs')* 依赖本地libs文件夹下的扩展名为jar
  • compile project('×××') 引入某个本地module
  • compile group:name:version

gradle 3.0中依赖implementation、api的区别

  • api跟以前的compile没什么区别,指令依赖会传递,只需要引入一次,其它module不用再次引入
  • implementation指令依赖是不会传递的,也就是说当前引用的第三方库仅限于本module内使用
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,126评论 6 481
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,254评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 152,445评论 0 341
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,185评论 1 278
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,178评论 5 371
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,970评论 1 284
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,276评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,927评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,400评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,883评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,997评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,646评论 4 322
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,213评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,204评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,423评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,423评论 2 352
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,722评论 2 345

推荐阅读更多精彩内容

  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 171,498评论 25 707
  • 说明 本文主要介绍和Gradle关系密切、相对不容易理解的配置,偏重概念介绍。部分内容是Android特有的(例如...
    jzj1993阅读 15,573评论 1 62
  • 当毕业不够两年,身边的朋友慢慢得有车有房有女朋友周末有自己的节目,而我觉得很多美好的事情我都遥不可及,找不到可以让...
    19snow93阅读 11,821评论 34 192
  • 如果我们需要一个模型,让线程能随时处理事件但并不退出,这种模型通常称作Event Loop.实现这种模型的关键点在...
    August24阅读 313评论 0 0
  • 忽然夕阳淹没了等待 满街的树影 安静了某时某刻 风吹进黄昏的微凉后 我走了 视线开始模糊 谁知道 我一生的入迷 终...
    葛卡阅读 125评论 3 0