在上一篇文章中跃赚,我們分析了在工程根目錄中build.gradle每一行代碼的含義。在創(chuàng)建App工程時(shí)寥殖,Android Studio還會(huì)在app目錄下創(chuàng)建一個(gè)build.gradle文件舟奠,如下所示儒洛。本文將對(duì)其逐行進(jìn)行分析蔚携。
//導(dǎo)入application plugin希太。
// apply是在Interface PluginWare中定義的method,其signature為void apply(Map<String,?> options)酝蜒。
// key 'plugin'意味著可以導(dǎo)入plugin誊辉。此外key 'from'可以導(dǎo)入script.
// value 'com.android.application'為插件的名稱。
// 該插件的代碼實(shí)現(xiàn)在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'
// 根據(jù)插件的代碼實(shí)現(xiàn)亡脑,'android'為extension的名稱堕澄。
// extension = project.extensions.create('android', AppExtension, this, (ProjectInternal) project, instantiator, buildTypeContainer, productFlavorContainer, signingConfigContainer)
// 在apply plugin: 'com.android.application'時(shí)洲尊,該插件的apply mehtod被調(diào)用,然后調(diào)用上面的代碼創(chuàng)建了一個(gè)extension奈偏,用于收集配置屬性。
// 關(guān)于這些配置屬性的詳細(xì)解釋躯护,可以參考官方文檔(http://google.github.io/android-gradle-dsl/current/com.android.build.gradle.AppExtension.html#com.android.build.gradle.AppExtension)
android {
// 下面這兩個(gè)必需項(xiàng)必須與所安裝的SDK一致惊来,否則報(bào)錯(cuò)。
// 必需項(xiàng):SDK版本
compileSdkVersion 23
// 必需項(xiàng):編譯工具版本
buildToolsVersion "23.0.1"
// 默認(rèn)配置棺滞,其類型為ProductFlavor裁蚁,所有的product flavors共享這些配置。
defaultConfig {
// 在手機(jī)和Google Play中唯一識(shí)別app的id继准。
// aapt dump badging命令所導(dǎo)出的package name就是在這定義的枉证。這個(gè)與AndroidManifest.xml中的定義的package還是有所區(qū)別的。
// applicationId是手機(jī)和Google Play中唯一識(shí)別該app的id移必,而package則可用于組織app的resource室谚。
// 更多信息請(qǐng)參考官方文檔http://tools.android.com/tech-docs/new-build-system/applicationid-vs-packagename
applicationId "com.apkudo.uiautomatordemo"
// 下面這四項(xiàng)在AndroidManifest.xml中定義的值會(huì)被此處的值覆蓋掉。
// 為了避免歧義崔泵,建議還是只在此處定義秒赤。
minSdkVersion 19
targetSdkVersion 23
versionCode 1
versionName "1.0"
// For Uiautomator test.
// 這個(gè)是為使用Uiautomator進(jìn)行測(cè)試而添加的,指定使用AndroidJUnitRunner作為test runner.
// testInstrumentationRunner是ProductFlavor中定義的屬性憎瘸,可以根據(jù)Flavor進(jìn)行定制入篮。
testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
}
// 本工程所用的編譯類型。
// 根據(jù)http://tools.android.com/tech-docs/new-build-system/user-guide, 插件中默認(rèn)定義了release和debug兩種類型幌甘。
buildTypes {
release {
// 不對(duì)apk大小進(jìn)行優(yōu)化潮售。如果使能的話,可以使用ProGuard將未使用的代碼及資源不打入apk中锅风。
minifyEnabled false
// 設(shè)置所用的proguard files: 從SDK中獲取默認(rèn)的proguard-android.txt酥诽,和本地定義的proguard-rules.pro。
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
}
}
}
// 該app所依賴的庫(kù)皱埠。
dependencies {
// 'compile'為編譯app時(shí)所用的庫(kù)
// 使用本地libs目錄中的所有jar文件作為庫(kù)
compile fileTree(dir: 'libs', include: ['*.jar'])
// 使用jcenter repositories中的Android支持包盆均,格式為groupid:artifactid:version。
compile 'com.android.support:appcompat-v7:23.1.1'
// 'androidTestCompile'為編譯測(cè)試程序時(shí)所用的庫(kù)漱逸。
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'
}
總結(jié)一下泪姨,app目錄中的build.gradle使用了com.android.application插件,收集編譯app所需的配置項(xiàng)和依賴庫(kù)饰抒,以在插件所定義的編譯任務(wù)中使用肮砾。更多信息請(qǐng)參考官方文檔。