gradle

Gradle是一個基於Apache Ant和Apache Maven概念的專案自動化建構工具。它使用一種基於Groovy的特定領域語言(DSL)來宣告專案設定，拋棄了基於XML的各種繁瑣配置。
面向Java應用為主。當前其支援的語言限於Java、Groovy和Scala，計劃未來將支援更多的語言。

      Android Studio下載與安裝中新建專案成功後會下載Gradle

• Mac上會預設下載到 /Users/<使用者名稱>/.gradle/wrapper/dists 目錄

• Win平臺會預設下載到 C:\Documents and Settings\<使用者名稱>.gradle\wrapper\dists 目錄

檔案介紹

• 模組/build.gradle

//宣告是Android 程式
apply plugin: 'com.android.application'

//配置了用於 android 構建的所有引數。這是Android DSL的入口。
//預設情況下，只需要配置編譯目標，以及build-tools的版本。
//它通過compileSdkVersion和buildtoolsVersion屬性來完成。
//提示：你應該只配置使用這個android外掛。如果同時配置使用了java外掛也會導致構建錯誤。
android {
    //編譯SDK的版本
    compileSdkVersion 19
 

    //build tools 的版本
    // 構建工具的版本，其中包括了打包工具aapt、dx等等。
    // 這個工具的目錄位於..sdk_path/build-tools/XX.XX.XX
    buildToolsVersion "19.1.0"

    //在android元素的內部的defaultConfig元素是定義所有這些配置的地方。
    defaultConfig {
        // 應用的包名
        applicationId "com.example.lidecheng.myapplication"
        minSdkVersion 14
        targetSdkVersion 19
 

        versionCode 1
        versionName "1.0"
    }

    // java版本
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_7
        targetCompatibility JavaVersion.VERSION_1_7
    }

    buildTypes {
        release {
            // 是否進行混淆
            minifyEnabled false
            // 混淆檔案的位置
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }


    // 移除lint檢查的error
    lintOptions {
        abortOnError false
    }
}

dependencies {
    //編譯libs目錄下的所有jar包
    compile fileTree(dir: 'libs', include: ['*.jar'])
    testCompile 'junit:junit:4.12'
    compile 'com.android.support:appcompat-v7:19.+'
}

// 這個檔案是app資料夾下這個Module的gradle配置檔案，也可以算是整個專案最主要的gradle配置檔案

• 專案/build.gradle

// Top-level build file where you can add configuration options common to all sub-projects/modules.
//整個專案的gradle基礎配置檔案
//buildscript { ... }配置了驅動構建的程式碼。
// 聲明瞭使用jcenter 中央庫，並且對一個Maven 檔案有一個類路徑依賴。
// 這個檔案是包含 Gradle Android 外掛的 1.5.0版本的庫
buildscript {
    repositories {
        jcenter()
    }

    dependencies {
        //聲明瞭android gradle plugin的版本
        classpath 'com.android.tools.build:gradle:1.5.0'

        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
    }
}

allprojects {
    repositories {
        jcenter()
    }
}

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

// 內容主要包含了兩個方面：一個是宣告倉庫的源，這裡可以看到是指明的jcenter(), 之前版本則是mavenCentral(), jcenter可以理解成是一個新的中央遠端倉庫，相容maven中心倉庫，而且效能更優。另一個是聲明瞭android gradle plugin的版本，android studio 1.0正式版必須要求支援gradle plugin 1.0的版本。

• settings.gradle

//全域性的專案配置檔案
include ':app'

• gradle-wrapper.properties

#聲明瞭gradle的目錄與下載路徑以及當前專案使用的gradle版本，
#這些預設的路徑我們一般不會更改的，這個檔案裡指明的gradle版本不對也是很多導包不成功的原因之一。

distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-2.8-all.zip

• local.properties

## This file is automatically generated by Android Studio.
# Do not modify this file -- YOUR CHANGES WILL BE ERASED!
//通過sdk.dir屬性來設定 SDK 的位置，並且所設定的這個SDK要求存在。 
//或者，您也可以設定一個ANDROID_HOME環境變數。這兩種方法之間沒什麼差別
ndk.dir=/Users/lidecheng/Documents/android/android-sdk-macosx-2/ndk-bundle
sdk.dir=/Users/lidecheng/Documents/android/android-sdk-macosx-2

android DSL

• defaultConfig{} 預設配置，是ProductFlavor型別。它共享給其他ProductFlavor使用

• sourceSets{ } 原始檔目錄設定，是AndroidSourceSet型別。

• buildTypes{ } BuildType型別

• signingConfigs{ } 簽名配置，SigningConfig型別

• productFlavors{ } 產品風格配置，ProductFlavor型別

• testOptions{ } 測試配置，TestOptions型別

• aaptOptions{ } aapt配置，AaptOptions型別

• lintOptions{ } lint配置，LintOptions型別

• dexOptions{ } dex配置，DexOptions型別

• compileOptions{ } 編譯配置，CompileOptions型別

• packagingOptions{ } PackagingOptions型別

• jacoco{ } JacocoExtension型別。 用於設定 jacoco版本

• splits{ } Splits型別。

  android { … }配置了用於 android 構建的所有引數。這是Android DSL的入口。

預設情況下，只需要配置編譯目標，以及build-tools的版本。它通過compileSdkVersion和buildtoolsVersion屬性來完成。

重要提示：你應該只配置使用這個android外掛。如果同時配置使用了java外掛也會導致構建錯誤。