Android Studio之gradle的配置與介紹
1、gradle的簡單介紹
Gradle是可以用於Android開發的新一代的Build System,也是Android Studio預設的build工具。其實Gradle指令碼是基於一種JVM語言— Groovy,再加上DSL組成的。由於Groovy是JVM語言,所以可以使用大部分的Java語言庫。所謂DSL就是專門針對Android開發的外掛,比如標準Gradle之外的一些新的方法(Method)、閉包(Closure)等等。通過我們簡單的瞭解知道Gradle的語法足夠簡潔和簡單,而且可以使用大部分的java包,所以它就當之無愧地成為新一代的Build System。
我想使用過Android Studio的都知道,使用Android Studio新建一個工程後,預設會生成兩個build.gralde檔案,一個位於工程根目錄,一個位於app目錄下。如下所示:
$ find -name build.gradle
./app/build.gradle
./build.gradle
還有另外一個檔案 --settings.gradle。
根目錄下的指令碼檔案是針對module的全域性配置,它的作用域所包含的所有module是通過settings.gradle來配置。
app資料夾就是一個module,如果在當前工程中添加了一個新的module — lib,就需要在settings.gralde檔案中包含這個新的module。
2、深入瞭解其基本結構
我們用工程例子來深入的瞭解一下它的基本結構。
①、根目錄的build.gradle的內容所示如下:
buildscript {
repositories {
jcenter()
}
dependencies {
classpath 'com.android.tools.build:gradle:1.0.0-rc4'
}
}
allprojects {
repositories {
jcenter()
maven {
url 'http://mvnrepo.xxx.com/mvn/repository'
}
}
}
解釋:classpath 'com.android.tools.build:gradle:1.0.0-rc4'就是Android特有的外掛,maven倉庫地址通過方法jCenter() 獲取,這也是預設的maven倉庫。當然也可以新增額外的maven倉庫地址,例如以上檔案中的
maven {
url 'http://mvnrepo.xxx.com/mvn/repository'
}
②、app目錄下的build.gradle的內容展示如下:
//設定指令碼的執行環境
buildscript {
//支援java 依賴庫管理(maven/ivy),用於專案的依賴。
repositories {
mavenCentral()
}
//依賴包的定義。支援maven/ivy,遠端,本地庫,也支援單檔案
dependencies {
classpath 'com.android.tools.build:gradle:0.4'
}
}
//宣告構建的專案型別,這裡當然是android了
apply plugin: 'android'
//設定編譯android專案的引數
android {
compileSdkVersion 17
buildToolsVersion "17"
defaultConfig {
minSdkVersion 8
targetSdkVersion 17
}
//Android預設配置
sourceSets {
main {
manifest.srcFile 'AndroidManifest.xml'
java.srcDirs = ['src']
resources.srcDirs = ['src']
aidl.srcDirs = ['src']
renderscript.srcDirs = ['src']
res.srcDirs = ['res']
assets.srcDirs = ['assets']
}
//測試所在的路徑,這裡假設是tests資料夾,沒有可以不寫這一行
instrumentTest.setRoot('tests')
}
//這個是解決lint報錯的程式碼
lintOptions {
abortOnError false
}
/**
* 簽名設定
*/
signingConfigs {
myConfigs {
storeFile file("簽名檔案地址")
keyAlias "..."
keyPassword "..."
storePassword "..."
}
}
/**
* 混淆設定
*/
buildTypes {
release {
signingConfig signingConfigs.myConfigs
runProguard true
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
}
}
/**
* 渠道打包(不同包名)
*/
productFlavors {
qqqq {
applicationId = '包名'
}
hhhhh {
applicationId='包名'
}
}
}
/**
* .so檔案的匯入
*/
task copyNativeLibs(type: Copy) {
from fileTree(dir: 'libs', include: 'armeabi/*.so') into 'build/lib'
}
tasks.withType(Compile) {
options.encoding = "UTF-8"
}
tasks.withType(Compile) {
compileTask -> compileTask.dependsOn copyNativeLibs
}
clean.dependsOn 'cleanCopyNativeLibs'
tasks.withType(com.android.build.gradle.tasks.PackageApplication) { pkgTask ->
pkgTask.jniFolders = [new File(buildDir, 'lib')]
}
//依賴庫
dependencies {
compile fileTree(dir: 'libs', include: ['*.jar'])
}
包依賴使用aar時分為本地依賴和遠端依賴,分別如下:
本地依賴:
gradle 作為構建工具,能夠很方便的使用本地jar包,以下為使用的程式碼塊:
dependencies {
//單檔案依賴
compile files('libs/android-support-v4.jar')
//某個資料夾下面全部依賴
compile fileTree(dir: 'libs', include: '*.jar')
}
android {
}
遠端依賴:
gradle 同時支援maven,ivy,我們用maven 作為例子,以下為程式碼塊:
repositories {
//從中央庫裡面獲取依賴
mavenCentral()
//或者使用指定的本地maven 庫
maven{
url "file://F:/githubrepo/releases"
}
//或者使用指定的遠端maven庫
maven{
url "遠端庫地址"
}
}
dependencies {
//應用格式: packageName:artifactId:version
compile 'com.google.android:support-v4:r13'}
android {
}
對於專案依賴 android library的話,就不是依賴一個jar,那麼簡單了,在這裡需要使用gradle mulit project 機制。在過去,android library並沒有一個很好的包管理方式,簡單來說,在gradle出現以前,官方並沒有一種用於管理android library 依賴包的方式,一般我們都是直接下載別人的android library project 原始碼進行整合,而對於第三方的android-maven-plugin 用的是apklib 格式。而現在,官方終於推出一種android library的打包格式,副檔名為*.aar。前面提到,目前android gradle外掛並不支援本地直接使用*.aar檔案,對android library 進行打包直接在library專案下面使用gradle build 即可,然後,你就會在 build/libs 目錄下看到兩個*.aar檔案,一個debug包用的,一個是release 下用的,看個人需求使用,這裡我們用的是release 版本的 .aar 檔案。
引用指令碼跟前面講的依賴庫相似:
dependencies {
compile(name: 'pulltorefresh', ext: 'aar')
}
包依賴jar:
依賴多個jar時:
compile group: 'com.alibaba', module: 'fastjson', version: 'latest.integration'
我們其實可以簡寫成:
compile 'com.alibaba:fastjson:latest.integration'
而latest.integration可以替換成具體的版本號,這裡是獲取伺服器上的最新版本。
如果要去除重複依賴可以這樣:
compile 'com.alibaba.fastjson.latest.integration' {
exclude module: 'annotations', group: 'com.google.android'
}
3、命令執行指令碼
在Android工程根目錄下會自動生成一個shell指令碼 - gradlew,執行之前記得加上x屬性 - chomod +x gradlew
gradle指令碼中包含了很多 task,可以通過task名來指定需要執行的task。
./gradlew build./gradlew assemble./gradlew assembleInnderDebug
4、總結說明
我估計現在大部分開發的專案普遍使用的是maven,但是不知道為什麼,使用Gradle時經常會遇到一些無法獲取遠端依賴包的問題,最簡單的解決辦法就是把依賴包下載的本地。所以建議大家儘量使用本地依賴。如果介紹了這些你還不是太明白,那你可以自己在網上搜一些相關的知識學習學習,或者自己找些資料進行了解,最好的學習就是挑戰自己而不是依賴別人。
個人組織了一個高階Android微信交流群,有意向的可以先分享此文章到朋友圈,再加我微信,傳送分享到朋友圈的截圖給我,我把你拉進去。保你學到更多知識,可以第一時間收到乾貨推送。
微訊號:smart_android (←長按複製)介紹:非著名程式設計師,字耿左直右,號澀郎,愛搞機,愛程式設計,是爬行在移動網際網路中的一名碼匠!
個人微訊號:loonggg
微博:澀郎
QQ群:413589216 更多資料和原始碼盡在QQ群檔案
今日頭條:搜尋“非著名程式設計師”訂閱更多資訊
工作:專注於移動網際網路的開發和研究,本號致力於分享IT技術和程式猿工作心得體會。歡迎大家關注與轉載。