什麼是Gradle?
Gradle是一種依賴管理工具,基於Groovy語言,面向Java應用爲主,它拋棄了基於XML的各種繁瑣配置,取而代之的是一種基於Groovy的內部領域特定(DSL)語言。
安裝Gradle
在新建項目成功後會下載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相關的幾個文件一般有如下幾個:
紅色標記部分從上到下咱們來一步步分析:
- 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'compile(name: 'pulltorefresh', ext: 'aar')
}
這裏需要說明幾點:
文件開頭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程序的混淆文件,該文件已經包含了基本的混淆聲明,免去了我們很多事,這個文件的目錄在 /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等環境,簽名,多渠道打包等,後續會單獨拿出來講解。
- 9GAG/extras/ShimmerAndroid/build.gradle
每一個Module都需要有一個gradle配置文件,語法都是一樣,唯一不同的是開頭聲明的是 apply plugin: ‘com.android.library’
- 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版本不對也是很多導包不成功的原因之一。
- 9 GAG/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的版本。
- 9GAG/settings.gradle
這個文件是全局的項目配置文件,裏面主要聲明一些需要加入gradle的module,我們來看看9GAG該文件的內容:
include':app', ':extras:ShimmerAndroid'
文件中的 app, extras:ShimmerAndroid 都是module,如果還有其他module都需要按照如上格式加進去。