Android Studio之gradle的配置與介紹

yangxi_001發表於2017-02-10


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時經常會遇到一些無法獲取遠端依賴包的問題,最簡單的解決辦法就是把依賴包下載的本地。所以建議大家儘量使用本地依賴。如果介紹了這些你還不是太明白,那你可以自己在網上搜一些相關的知識學習學習,或者自己找些資料進行了解,最好的學習就是挑戰自己而不是依賴別人。

轉自:http://blog.csdn.net/loongggdroid/article/details/47037413

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時經常會遇到一些無法獲取遠端依賴包的問題,最簡單的解決辦法就是把依賴包下載的本地。所以建議大家儘量使用本地依賴。如果介紹了這些你還不是太明白,那你可以自己在網上搜一些相關的知識學習學習,或者自己找些資料進行了解,最好的學習就是挑戰自己而不是依賴別人。

相關文章