開始前先說下什麼是Gradle

這是我在網上找到的對Gradle的描述：

At the heart of Gradle lies a rich extensible Domain Specific Language (DSL) based on Groovy. Gradle pushes declarative builds to the next level by providing declarative language elements that you can assemble as you like. Those elements also provide build-by-convention support for Java, Groovy, OSGi, Web and Scala projects. Even more, this declarative language is extensible. Add your own new language elements or enhance the existing ones, thus providing concise, maintainable and comprehensible builds.
<翻譯>Gradle的核心是一個豐富的可擴充套件的基於Groovy的領域特定語言(DSL)。Gradle通過提供說明性語言元素將說明性構建推到下一層，您可以組裝。這些元素也提供build-by-convention支援Java、Groovy、OSGi、Web和Scala專案。更多，這個說明性語言是可擴充套件的。新增自己的新語言元素或提高現有的，從而提供簡潔、易於維護和理解構建。

並且它是一個開源的工具，你可以在它的官網去下載Gradle官網。總的來說Gradle是一種構建工具Android Studio使用它來構建你的Android專案。Andrd Studio在建立專案的時候會自動去下載，你也可以去官網手動下載後在Android Studio中配置。現在在Android StudioV2.0中使用的Gradle版本是V2.8， 官網中最新的版本本是V2.9。

那麼我們在Android Studio中自動下載的Gradle在哪裡呢？
- Mac上會預設下載到 /Users/<使用者名稱>/.gradle/wrapper/dists 目錄
- Win平臺會預設下載到 C:\Documents and Settings\<使用者名稱>.gradle\wrapper\dists 目錄

Project目錄結構

先來看下之前新建的專案

.gradle目錄

gradle 執行時自動生成的目錄，一般情況不做修改，不需要納入專案原始碼管理中。

.idea目錄

Intellij IDEA 執行時候生成的檔案目錄，一般情況不做修改，不需要納入專案原始碼管理中。
Intellij IDEA是JetBrains公司推出的Java整合開發環境，Android Studio是基於IDEA Commutity Edition開發的，Community 版本不僅是免費的而且是開源的。

module（app）

每一個module可看成在Eclipse中的一個Project，裡面的檔案結構與父類差不多。裡面也能包含build.gradle、gradle.properties、setting.gradle 等相關gradle檔案，若沒有定義，則在專案中使用父類的設定。更多的內容，後面再詳細介紹了。

build目錄

編譯時產生檔案，不需要修改，也不需要納入專案原始碼管理中。

captures目錄

如右圖中，使用改功能會抓取相應的資訊並儲存在captures目錄中，不需要納入專案原始碼管理中。

gradle目錄

可以看到裡面wrapper目錄下有兩個檔案，裡面有一些專案對gradle的配置資訊，我們來看下gradle-wrapper.properties裡的內容

#Wed Oct 21 11:34:03 PDT 2015
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

可以看到裡面聲明瞭gradle的目錄與下載路徑以及當前專案使用的gradle版本。預設的路徑我們一般不會更改，還記得之前介紹匯入Eclipse專案時，對專案使用的gradle版本做的修改嗎？

.gitignore檔案

git對專案檔案管理，可以在裡面新增你不希望納入git管理的檔案。來看一下里面的內容。

 *.iml
.gradle
/local.properties
/.idea/workspace.xml
/.idea/libraries
.DS_Store
/build
/captures

Android Studio已經自動幫我們添加了一些不需要的檔案，我們可以按照同樣的格式來加入自己的檔案。

build.gradle檔案

專案的編譯環境配置，可以說是Gradle最主要的配置檔案。先來看下里面的內容。

// Top-level build file where you can add configuration options common to all sub-projects/modules.

buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:2.0.0-alpha2'

        // 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
}

這裡是對Project的配置，是最頂層的配置，在module中同樣有一個build.gradle檔案，是對module的配置，如果module裡沒有進行配置，將使用這裡的配置資訊。一個是宣告倉庫的源，這裡可以看到是指明的jcenter(), jcenter可以理解成是一個新的中央遠端倉庫，相容maven中心倉庫，而且效能更優。另一個是聲明瞭android gradle plugin的版本。再說一下這裡，各位是否還有映像。

dependencies {
        classpath 'com.android.tools.build:gradle:2.0.0-alpha2'
    }

gradle.properties檔案

gradlew & gradlew.bat 檔案

分別是linux下的shell指令碼和windows下的批處理檔案，它們的作用是根據gradle-wrapper.properties檔案中的distributionUrl下載對應的gradle版本。這樣就可以保證在不同的環境下構建時都是使用的統一版本的gradle，即使該環境沒有安裝gradle也可以，因為gradle wrapper會自動下載對應的gradle版本。更多內容可以看下下面的連結，這裡沒有做更多的研究了：
http://blog.csdn.net/maserkinger/article/details/36011235

local.properties檔案

配置android NDK，SDK的地方，非android專案可能沒有這個檔案，這個路徑根據不同想電腦不同，一般也不會納入原始碼管理之中。

## This file is automatically generated by Android Studio.
# Do not modify this file -- YOUR CHANGES WILL BE ERASED!
#
# This file must *NOT* be checked into Version Control Systems,
# as it contains information specific to your local configuration.
#
# Location of the SDK. This is only used by Gradle.
# For customization when using a Version Control System, please read the
# header note.
#Tue Dec 08 19:51:24 CST 2015
ndk.dir=D\:\\Tools\\android-ndk-r10
sdk.dir=D\:\\Tools\\Android-SDK

setting.gradle檔案

聲明當前專案中含有什麼module。如果有多個module會以‘,’分開，如：include ‘:app’, ‘:app2’

include ':app'

Test.iml檔案

編譯專案時生成的檔案，其名為‘專案名.iml’，iml檔案是Android Studio識別專案的配置檔案，跟Eclipse裡面的.project檔案作用類似。

<?xml version="1.0" encoding="UTF-8"?>
<module external.linked.project.id="Test" external.linked.project.path="$MODULE_DIR$" external.root.project.path="$MODULE_DIR$" external.system.id="GRADLE" external.system.module.group="" external.system.module.version="unspecified" type="JAVA_MODULE" version="4">
  <component name="FacetManager">
    <facet type="java-gradle" name="Java-Gradle">
      <configuration>
        <option name="BUILD_FOLDER_PATH" value="$MODULE_DIR$/build" />
        <option name="BUILDABLE" value="false" />
      </configuration>
    </facet>
  </component>
  <component name="NewModuleRootManager" LANGUAGE_LEVEL="JDK_1_7" inherit-compiler-output="true">
    <exclude-output />
    <content url="file://$MODULE_DIR$">
      <excludeFolder url="file://$MODULE_DIR$/.gradle" />
    </content>
    <orderEntry type="inheritedJdk" />
    <orderEntry type="sourceFolder" forTests="false" />
  </component>
</module>

Module目錄結構

再看下Module裡面的結構

build目錄

module的編譯檔案目錄，編譯中生成的中間檔案就在這裡。

我們編譯最終生成的apk就在build/outputs/apk目錄下，裡面包含了app-debug.apk, app-debug-unaligned.apk,app-release-unaligned.apk三種apk, 另外app-release.apk是生成在module的根目錄下。

lib目錄

第三方庫存放目錄，我們可以把需要的第三方庫jar檔案放到這裡，*.so也同樣放在這裡。可以在Project Structure中管理它的依賴關係，也可以在build.gradle中直接修改。

src目錄

module原始碼目錄，我們工作的主要地方，沒什麼好多說的了。

.gitignore檔案

module模組的git管理檔案，可對module單獨管理。

app.iml檔案

同Project中的*.iml一樣。管理module的配置。

build.gradle檔案

這個檔案是Module的gradle配置檔案，也可以算是整個專案最主要的gradle配置檔案。它的內容比較複雜，我們先來看一下

apply plugin: 'com.android.application'

android {
    compileSdkVersion 23
    buildToolsVersion "23.0.2"

    defaultConfig {
        applicationId "eric.test"
        minSdkVersion 17
        targetSdkVersion 23
        versionCode 1
        versionName "1.0"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    testCompile 'junit:junit:4.12'
    compile 'com.android.support:appcompat-v7:23.1.1'
    compile 'com.android.support:design:23.1.1'
}

其中

// 這句是gradle版本的寫法，宣告是這是一個Android程式。
apply plugin: 'com.android.application'

Android專案中的配置：

// 編譯android的sdk版本
compileSdkVersion 23

// build tools的版本
buildToolsVersion "23.0.2"

defaultConfig {
        //  應用的包名
        applicationId "eric.test"
        // 允許的最少版本
        minSdkVersion 17
        // 目標版本
        targetSdkVersion 23
        // apk的版本
        versionCode 1
        // apk的顯示版本
        versionName "1.0"
    }

buildTypes {
        // 表明是在release版本中使用的配置
        release {
            // 是否執行混淆
            minifyEnabled false
            // 混淆的配置檔案路徑，預設給了我們兩個配置檔案。
            // proguard-android.txt在<sdk目錄>/tools/proguard下面，裡面已經包含了基本的混淆宣告，有興趣的可以去看下。
            // proguard-rules.pro是在module根目錄下面，我們可以根據專案去新增。
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }

依賴的配置：

// 表明是依賴庫配置
dependencies {
    // 表明依賴libs目錄下的所有jar包
    compile fileTree(dir: 'libs', include: ['*.jar'])
    // 表明在編譯專案的測試程式碼時依賴
    testCompile 'junit:junit:4.12'
    compile 'com.android.support:appcompat-v7:23.1.1'
    compile 'com.android.support:design:23.1.1'
}

關於依賴，在後面章節中還會做更多的介紹。

proguard-rules.pro檔案

module中的程式碼混淆配置檔案，使用方式和Eclipse中一樣。我們在build.gradle中可以看到如下片斷用來啟用混淆。

buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }

專案目錄結構大概就分析完了，這裡只是針對專案中的檔案做了一些簡單的說明，更說的使用在後面繼續介紹了。