本文Demo的完整工程代碼, 參考這里的StudyPackage
目錄
什么是Gradle
雖然原文定義又長(zhǎng)又晦澀, 但是為了準(zhǔn)確性, 還是引用Wiki中Gradle的定義如下
Gradle is an open source build automation system that builds upon the concepts of Apache Ant and Apache Maven and introduces a Groovy-based domain-specific language (DSL) instead of the XML form used by Apache Maven of declaring the project configuration.[2] Gradle uses a directed acyclic graph ("DAG") to determine the order in which tasks can be run.
介紹完"學(xué)院派"的定義, 我們來看看"世俗派"的定義
Gradle是一種構(gòu)建工具, 它可以幫你管理項(xiàng)目中的差異, 依賴, 編譯, 打包, 部署......, 你可以定義滿足自己需要的構(gòu)建邏輯, 寫入到build.gradle中供日后復(fù)用
更多可以參考如何通俗地理解 Gradle浮毯？
就我個(gè)人的理解
Gradle就是用來解決除Coding以外對(duì)開發(fā)的所有常見需求(差異, 依賴, 編譯, 打包, 部署......)
為什么是Gradle
工具總是會(huì)有很多種, 那為什么偏偏就是Gradle呢? Gradle官方的解釋如下
Polyglot Builds - 支持多種語言(例如Java, Scala, Python, C/C++, Android, IOS and many many more)
Tool Integrations - 集成開發(fā)工具
Robust Dependency Management - 強(qiáng)大的依賴管理
Powerful Yet Concise Logic - 簡(jiǎn)潔但強(qiáng)大的邏輯
High Performance Builds - 高性能構(gòu)建
Build Reporting - 編譯結(jié)果報(bào)告
介紹完"自賣自夸"的定義, 其實(shí)Marven與Gradle最核心的分歧在于
Marven基于XML, 而Gradle基于Groovy的DSL(Domain Specific Language) -- 一種圖靈完備的構(gòu)建語言
所以Gradle的表達(dá)更加
- 簡(jiǎn)潔 - XML依賴的寫法很繁瑣, 而Gradle只要一句話, 例如
compile 'com.android.support:appcompat-v7:24.2.0'
- 智能 - 例如Gradle支持動(dòng)態(tài)版本依賴, 例如
testCompile ‘junit:junit:4.+'
Gradle的安裝
使用Android Studio構(gòu)建項(xiàng)目時(shí), IDE會(huì)幫我們下載和安裝Gradle
Mac上會(huì)默認(rèn)下載到/Users/<用戶名>/.gradle/wrapper/dists目錄
Windows平臺(tái)會(huì)默認(rèn)下載到C:\Documents and Settings<用戶名>.gradle\wrapper\dists目錄
由于Gradle無法"正常訪問"導(dǎo)致Android Studio會(huì)經(jīng)常"假死", 所以可以離線下載(參考AndroidDevTools), 然后拷貝至相應(yīng)目錄
Gradle項(xiàng)目結(jié)構(gòu)
使用Android Studio創(chuàng)建的Gradle項(xiàng)目的典型目錄結(jié)構(gòu)如下
其中與Gradle相關(guān)的文件主要有
Gradle相關(guān)文件
build.gradle
build.gradle是Gradle的核心配置文件, 它一般分為兩種
- 根目錄配置文件, 例如build.gradle(Project: StudyPackage)
buildscript {
repositories {
jcenter()
}
dependencies {
classpath 'com.android.tools.build:gradle:2.2.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
}
根目錄配置文件中定義的是所有子模塊的公共配置, 例如: 倉(cāng)庫(kù)源為jcenter(), android gradle plugin的版本
- 模塊的配置文件, 例如build.gradle(Module: app)
apply plugin: 'com.android.application' // 聲明是Android程序
android {
compileSdkVersion 24 // 編譯SDK的版本
buildToolsVersion "24.0.2" // build tools的版本
defaultConfig {
applicationId "com.example.yuanlin.studypackage" // 應(yīng)用包名
minSdkVersion 21
targetSdkVersion 24
versionCode 1
versionName "1.0"
testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
}
buildTypes {
release {
minifyEnabled false // 是否代碼混淆
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' // 混淆文件的位置
}
}
}
dependencies {
compile fileTree(dir: 'libs', include: ['*.jar']) // 編譯libs目錄下的所有jar包
androidTestCompile('com.android.support.test.espresso:espresso-core:2.2.2', {
exclude group: 'com.android.support', module: 'support-annotations'
})
compile 'com.android.support:appcompat-v7:24.2.0'
testCompile 'junit:junit:4.12'
}
模塊的配置文件中定義的都是當(dāng)前模塊的Gradle配置
settings.gradle
這是全局的項(xiàng)目配置文件, 里面聲明了需要加入gradle的module, 例如
include ':app'
gradle.properties
gradle.properties是gradle的配置文件
其中可以定義一些常量供build.gradle使用, 比如可以配置簽名相關(guān)信息如keystore位置, 密碼, keyalias等, build.gradle就可以直接引用, 因此
gradle中的一些配置參數(shù)建議寫到gradle.properties
例如google/iosched的gradle.properties中配置了
###############################################################################
# App variables.
###############################################################################
# If versions end in odd numbers they are development builds, even versions are release candidates.
# The AndroidManifest.xml must also be updated currently.
version_code = 333
version_name = 3.3.3
......
模塊中的build.gradle就可以這樣引用
......
android {
compileSdkVersion 23
buildToolsVersion "23.0.1"
defaultConfig {
version "${version_code}"
versionName "${version_name}"
minSdkVersion 14
targetSdkVersion 22
......
}
}
......
local.properties
該文件描述的是SDK的路徑, 例如
sdk.dir=/Users/yuanlin/Workspace/android-sdk
需要注意的是
- Android Studio會(huì)自動(dòng)生成該該文件, 所以一般需要配置該文件, 只有當(dāng)不使用Android Studio時(shí), 才自己配置
該文件不需要添加到版本控制系統(tǒng)中
Gradle Wrapper
為什么要使用Gradle Wrapper
如果開發(fā)者配置了Gradle Wrapper, 那么在其他開發(fā)者構(gòu)建該項(xiàng)目時(shí), 可以直接執(zhí)行如下命令
./gradlew [task] // Mac OS/Linux
gradlew [task] // Windows
當(dāng)用戶第一次執(zhí)行上面的命令時(shí), Wrapper會(huì)自動(dòng)地下載并安裝對(duì)應(yīng)版本的Gradle, 這樣
用戶不必自己下載讹挎、安裝、配置Gradle; 用戶進(jìn)行項(xiàng)目構(gòu)建時(shí)能夠確保使用正確的Gradle版本
Gradle Wrapper需要哪些文件
在配置了Wrapper的Gradle項(xiàng)目中, 有以下文件
|--gradle
|---- wrapper
|---- gradle-wrapper.jar
|---- gradle-wrapper.properties
|--gradlew (Mac OS/Linux)
|--gradlew.bat (Windows)
其中g(shù)radler-wrapper.properties文件的內(nèi)容大概如下
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-2.14.1-all.zip
以上文件都需要添加到版本控制系統(tǒng)中
Gradle Wrapper的基本使用
./gradlew -v - 版本信息
./gradlew clean - 清除build和app/build目錄
./gradlew build - 檢查依賴并編譯打包(注意這里會(huì)將debug页屠、release包都打出來)
./gradlew assembleDebug - 編譯并打Debug包
./gradlew assembleRelease - 編譯并打Release的包
關(guān)于更多GradleWrapper的使用, 可以參考幫助: ./gradlew -h
Gradle編譯優(yōu)化
這里的優(yōu)化方法主要參考Making Gradle builds faster
配置編譯選項(xiàng)
--dry-run: Runs the builds with all task actions disabled
--configure-on-demand: Only relevant projects are configured in this build run. This means faster build for large multi-project builds
--daemon: Uses the Gradle daemon to run the build. Starts the daemon if not running
--parallel: Build projects in parallel. Gradle will attempt to determine the optimal number of executor threads to use
這些配置選項(xiàng)還可以添加系統(tǒng)全局配置文件~/.gradle/gradle.properties中
echo 'org.gradle.configureondemand=true' >> ~/.gradle/gradle.properties
echo 'org.gradle.daemon=true' >> ~/.gradle/gradle.properties
echo 'org.gradle.parallel=true' >> ~/.gradle/gradle.properties
經(jīng)過實(shí)際測(cè)試, 對(duì)編譯速度有明顯提升的主要還是--daemon
使用最新版本的Gradle
Offline work
如果項(xiàng)目的Gradle和依賴沒有更新, 還可以勾選Offline work來加快編譯速度
參考
更多文章, 請(qǐng)支持我的個(gè)人博客
