理解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所需的配置項和依賴庫,以在插件所定義的編譯任務中使用。更多信息請參考官方文檔

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。

推薦閱讀更多精彩內容

  • Android 自定義View的各種姿勢1 Activity的顯示之ViewRootImpl詳解 Activity...
    passiontim閱讀 173,552評論 25 708
  • Gradle對于很多開發者來說有一種既熟悉又陌生的感覺,他是離我們那么近,以至于我每天做項目都需要他,但是他又是離...
    阿_希爸閱讀 9,606評論 10 199
  • 轉載注明出處:http://www.lxweimin.com/p/5255b100930e 0. 前言 完全由個人翻...
    王三的貓阿德閱讀 2,575評論 0 4
  • 初來師大時,學校食堂的飯菜讓我很不適應,早上的粥是冷的,中午的飯菜以米飯搭配菜居多,我竟有些無所適從。 我一個地道...
    茗天知道閱讀 296評論 0 0
  • 走在樓道,悠揚的樂器聲就沖斥著自己的耳朵,心情瞬間美好起來。剛走到橄欖樹教室門口就能看到張老師和著旋律打...
    我心向陽啦閱讀 377評論 0 0