理解app目录中的build.gradle

上一篇文章中,我们分析了在工程根目录中build.gradle每一行代码的含义。在创建App工程时,Android Studio还会在app目录下创建一个build.gradle文件,如下所示。本文将对其逐行进行分析。

//导入application plugin。
// apply是在Interface PluginWare中定义的method,其signature为void apply(Map<String,?> options)。
// key 'plugin'意味着可以导入plugin。此外key 'from'可以导入script.
// value 'com.android.application'为插件的名称。
// 该插件的代码实现在https://android.googlesource.com/platform/tools/build/+/android-7.0.0_r6/gradle/src/main/groovy/com/android/build/gradle/AppPlugin.groovy
apply plugin: 'com.android.application'

// 根据插件的代码实现,'android'为extension的名称。
// extension = project.extensions.create('android', AppExtension, this, (ProjectInternal) project, instantiator, buildTypeContainer, productFlavorContainer, signingConfigContainer)
// 在apply plugin: 'com.android.application'时,该插件的apply mehtod被调用,然后调用上面的代码创建了一个extension,用于收集配置属性。
// 关于这些配置属性的详细解释,可以参考官方文档(http://google.github.io/android-gradle-dsl/current/com.android.build.gradle.AppExtension.html#com.android.build.gradle.AppExtension)
android {
     // 下面这两个必需项必须与所安装的SDK一致,否则报错。
    // 必需项:SDK版本
    compileSdkVersion 23
    // 必需项:编译工具版本
    buildToolsVersion "23.0.1"

    // 默认配置,其类型为ProductFlavor,所有的product flavors共享这些配置。
    defaultConfig {
        // 在手机和Google Play中唯一识别app的id。
        // aapt dump badging命令所导出的package name就是在这定义的。这个与AndroidManifest.xml中的定义的package还是有所区别的。
// applicationId是手机和Google Play中唯一识别该app的id,而package则可用于组织app的resource。
        // 更多信息请参考官方文档http://tools.android.com/tech-docs/new-build-system/applicationid-vs-packagename
        applicationId "com.apkudo.uiautomatordemo"
        // 下面这四项在AndroidManifest.xml中定义的值会被此处的值覆盖掉。
        // 为了避免歧义,建议还是只在此处定义。
        minSdkVersion 19
        targetSdkVersion 23
        versionCode 1
        versionName "1.0"
        // For Uiautomator test.
        // 这个是为使用Uiautomator进行测试而添加的,指定使用AndroidJUnitRunner作为test runner.
        // testInstrumentationRunner是ProductFlavor中定义的属性,可以根据Flavor进行定制。
        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
    }

    // 本工程所用的编译类型。
    // 根据http://tools.android.com/tech-docs/new-build-system/user-guide, 插件中默认定义了release和debug两种类型。
    buildTypes {
        release {
            // 不对apk大小进行优化。如果使能的话,可以使用ProGuard将未使用的代码及资源不打入apk中。
            minifyEnabled false
            // 设置所用的proguard files: 从SDK中获取默认的proguard-android.txt,和本地定义的proguard-rules.pro。
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}

// 该app所依赖的库。
dependencies {
     // 'compile'为编译app时所用的库
    // 使用本地libs目录中的所有jar文件作为库
    compile fileTree(dir: 'libs', include: ['*.jar'])
    // 使用jcenter repositories中的Android支持包,格式为groupid:artifactid:version。
    compile 'com.android.support:appcompat-v7:23.1.1'

    // 'androidTestCompile'为编译测试程序时所用的库。
    androidTestCompile 'com.android.support:support-annotations:23.1.1'
    androidTestCompile 'com.android.support.test:runner:0.5'
    // Set this dependency to use JUnit 4 rules
    androidTestCompile 'com.android.support.test:rules:0.5'
    // Set this dependency to build and run UI Automator tests
    androidTestCompile 'com.android.support.test.uiautomator:uiautomator-v18:2.1.2'

}

总结一下,app目录中的build.gradle使用了com.android.application插件,收集编译app所需的配置项和依赖库,以在插件所定义的编译任务中使用。更多信息请参考官方文档

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

推荐阅读更多精彩内容

  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 171,978评论 25 707
  • Gradle对于很多开发者来说有一种既熟悉又陌生的感觉,他是离我们那么近,以至于我每天做项目都需要他,但是他又是离...
    阿_希爸阅读 9,575评论 10 199
  • 转载注明出处:http://www.jianshu.com/p/5255b100930e 0. 前言 完全由个人翻...
    王三的猫阿德阅读 2,509评论 0 4
  • 初来师大时,学校食堂的饭菜让我很不适应,早上的粥是冷的,中午的饭菜以米饭搭配菜居多,我竟有些无所适从。 我一个地道...
    茗天知道阅读 244评论 0 0
  • 走在楼道,悠扬的乐器声就冲斥着自己的耳朵,心情瞬间美好起来。刚走到橄榄树教室门口就能看到张老师和着旋律打...
    我心向阳啦阅读 359评论 0 0