史上最詳細的Android Studio系列教程四--Gradle基礎

原文來自：http://stormzhang.com/devtools/2014/12/18/android-studio-tutorial4/

其實很早之前也寫了一篇Gradle的基礎博客，但是時間很久了，現在Gradle已經更新了很多，所以暫且結合Stduio 1.0正式版與最新的Gradle語法來詳細講解下，小伙伴們直接跟我一步步來學習吧。

什么是Gradle？

Gradle是一種依賴管理工具，基於Groovy語言，面向Java應用為主，它拋棄了基於XML的各種繁瑣配置，取而代之的是一種基於Groovy的內部領域特定（DSL）語言。

安裝Gradle

在Android Studio系列教程一–下載與安裝中新建項目成功后會下載Gradle，貌似這個過程不翻牆也是可以下載，但是訪問特別慢，建議翻牆下載。那么下載的Gradle到什么地方呢？

• Mac上會默認下載到 **/Users/<用戶名>/.gradle/wrapper/dists** 目錄

• Win平台會默認下載到 C:\Documents and Settings<用戶名>.gradle\wrapper\dists 目錄

你會看到這個目錄下有個 gradle-x.xx-all 的文件夾, 如果下載實在太慢，但是又不想翻牆的話，可以自己手動到Gradle官網下載對應的版本，然后將下載的.zip文件(也可以解壓)復制到上述的gradle-x.xx-all 文件夾下，不過還是建議讓它直接下載的好。

Gradle 基本概念

下面就以我的開源項目 9GAG 來詳細講解下和Gradle相關的知識, 和Gradle相關的幾個文件一般有如下幾個：

紅色標記部分從上到下咱們來一步步分析：

1. 9GAG/app/build.gradle

這個文件是app文件夾下這個Module的gradle配置文件，也可以算是整個項目最主要的gradle配置文件，我們來看下這個文件的內容：

// 聲明是Android程序
apply plugin: 'com.android.application'

android {
    // 編譯SDK的版本
    compileSdkVersion 21
    // build tools的版本
    buildToolsVersion "21.1.1"

    defaultConfig {
        // 應用的包名
        applicationId "me.storm.ninegag"
        minSdkVersion 14
        targetSdkVersion 21
        versionCode 1
        versionName "1.0.0"
    }

    // java版本
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_7
        targetCompatibility JavaVersion.VERSION_1_7
    }
    
    buildTypes {
        debug {
            // debug模式
        }
        
        release {
            // 是否進行混淆
            minifyEnabled false
            // 混淆文件的位置
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.txt'
        }
    }
    
    // 移除lint檢查的error
    lintOptions {
      abortOnError false
    }
}

dependencies {
    // 編譯libs目錄下的所有jar包
    compile fileTree(dir: 'libs', include: ['*.jar'])
    compile 'com.android.support:support-v4:21.0.2'
    compile 'com.etsy.android.grid:library:1.0.5'
    compile 'com.alexvasilkov:foldable-layout:1.0.1'
    // 編譯extras目錄下的ShimmerAndroid模塊
    compile project(':extras:ShimmerAndroid')
}

 

這里需要說明幾點：

• 文件開頭apply plugin是最新gradle版本的寫法，以前的寫法是apply plugin: ‘android’, 如果還是以前的寫法，請改正過來。

• buildToolsVersion這個需要你本地安裝該版本才行，很多人導入新的第三方庫，失敗的原因之一是build version的版本不對，這個可以手動更改成你本地已有的版本或者打開 SDK Manager 去下載對應版本。

• applicationId代表應用的包名，也是最新的寫法，這里就不在多說了。

• android 5.0開始默認安裝jdk1.7才能編譯，但是由於mac系統自帶jdk的版本是1.6，所以需要手動下載jdk1.7並配置下，具體可以見我這篇博客Mac下安裝和管理Java

• minifyEnabled也是最新的語法，很早之前是runProguard,這個也需要更新下。

• proguardFiles這部分有兩段，前一部分代表系統默認的android程序的混淆文件，該文件已經包含了基本的混淆聲明，免去了我們很多事，這個文件的目錄在 **<sdk目錄>/tools/proguard/proguard-android.txt** , 后一部分是我們項目里的自定義的混淆文件，目錄就在 **app/proguard-rules.txt** , 如果你用Studio 1.0創建的新項目默認生成的文件名是 **proguard-rules.pro** , 這個名字沒關系，在這個文件里你可以聲明一些第三方依賴的一些混淆規則，由於是開源項目，9GAG里並未進行混淆，具體混淆的語法也不是本篇博客討論的范圍。最終混淆的結果是這兩部分文件共同作用的。

• compile project(‘:extras:ShimmerAndroid’)這一行是因為9GAG中存在其他Module，不知道Module的概念可以看下這篇博客Android Studio系列教程二–基本設置與運行, 總之你可以理解成Android Library，由於Gradle的普及以及遠程倉庫的完善，這種依賴漸漸的會變得非常不常見，但是你需要知道有這種依賴的。

• 以上文件里的內容只是基本配置，其實還有很多自定義部分，如自動打包debug，release，beta等環境，簽名，多渠道打包等，后續會單獨拿出來講解。

2. 9GAG/extras/ShimmerAndroid/build.gradle

每一個Module都需要有一個gradle配置文件，語法都是一樣，唯一不同的是開頭聲明的是 apply plugin: ‘com.android.library’

3. 9GAG/gradle

這個目錄下有個 wrapper 文件夾，里面可以看到有兩個文件，我們主要看下 gradle-wrapper.properties 這個文件的內容：

#Thu Dec 18 16:02:24 CST 2014 distributionBase=GRADLE_USER_HOME distributionPath=wrapper/dists zipStoreBase=GRADLE_USER_HOME zipStorePath=wrapper/dists distributionUrl=https\://services.gradle.org/distributions/gradle-2.2.1-all.zip

可以看到里面聲明了gradle的目錄與下載路徑以及當前項目使用的gradle版本，這些默認的路徑我們一般不會更改的，這個文件里指明的gradle版本不對也是很多導包不成功的原因之一。

4. 9GAG/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:1.0.0'
    }
}

allprojects {
    repositories {
        jcenter()
    }
}

 

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

5. 9GAG/settings.gradle

這個文件是全局的項目配置文件，里面主要聲明一些需要加入gradle的module，我們來看看9GAG該文件的內容：

include ':app', ':extras:ShimmerAndroid'

文件中的 app, extras:ShimmerAndroid 都是module，如果還有其他module都需要按照如上格式加進去。