如何在Android Studio專案中匯入開源庫?

isming.me發表於2015-03-06

  前兩天,谷歌釋出了Android Studio 1.0的正式版,也有更多的人開始遷移到Android Studio進行開發。然而,網上很多的開源庫,控制元件等還是以前的基於Eclipse進行開發,很多人不知道怎麼匯入到自己的基於Android Studio專案中來,微博上也有人私信我,讓我來寫寫,正好今天回來的比較早,就寫寫吧。主要介紹一下常見的一些導包的場景。

  前言

--project //專案目錄
|
build.gradle //專案的gradle配置檔案
|
settings.gradle //gradle設定,會儲存所有的module
|
app //module 目錄
|__build.gradle module的配置
|
module2 //module2目錄
|__build.gradle module的配置

  同eclipse中的專案一樣,gradle/android studio 構建也可以有module,將moudle放到專案目錄下面,然後在settings.gradle中增加該module,最簡單的方法是用資料夾名。比如我們上面的結構,build.gradle檔案應該如下:

include ':app', ':module2'

  更多關於gralde的知識可以看我以前的文章:

  使用gradle構建android專案(續) 使用Gradle構建Android專案

  匯入Jar檔案

  這種可能很常見,可以下載到別人搞好的jar包,這樣可以直接在自己的主module下建立libs資料夾(我這裡這樣,只是為了相容eclipse方式),然後把jar檔案放進去,然後在module的build.gradle檔案中的dependecies{}新增如下程式碼:

compile files('libs/name.jar')

  當libs資料夾下面有多個檔案時,可以用一句程式碼包含這些包:

compile fileTree(dir: 'libs', include: ['*.jar'])

  當有檔案不需要被包含時,可以這樣:

compile fileTree(dir: 'libs', exclude: ['android-support*.jar'], include: ['*.jar'])

  從上面的程式碼中可以看到我們可以使用萬用字元, +表示一個字元,*表示0到多個字元。

  匯入maven中的庫

  如果開源庫作者有將程式碼放到Maven庫中,我們可以在gradle配置中直接引入,類似如下:

compile 'com.github.dmytrodanylyk.android-process-button:library:1.0.1'

  一般我們可以在開源庫的github頁面上面看有沒有這樣一個地址,或者到maven庫中根據包名搜尋有沒有,我們前面這個引入的專案分三個部分 group:name:version,我們引入其他的包也有遵守這個規則。

  匯入gradle構建的開源庫

  這種情況的比較少用到,因為這張的開源庫,作者一般都有放到maven庫中,但是偶爾也會用到這裡也提一下。

  首先下載檔案,將我們需要的這個庫的module資料夾拷貝到我們的專案的目錄下面,然後在setting.gradle檔案中增加資料夾名稱, 然後在我們需要依賴這個模組的module中的build.gradle檔案中加入如下程式碼:

compile project(':libmodule')

  這樣就可以了。

  匯入基於Eclipse構建的開源庫

  基於Eclipse構建的專案,和基於Android Studio構建的專案的很大區別是目錄結構不同。我們首先將module資料夾拷貝到我們的專案目錄下面,然後在settings.gradle檔案中增加這個module,然後在要使用的module中的build.gradle檔案中引入依賴,這樣看的話,似乎和引入基於gradle構建的沒什麼不同。但是,基於Eclipse構建的專案中,沒有build.gradle檔案,所以我們需要自己新建一個放到module下面,下面是一個模版:

apply plugin: 'android-library'
 
repositories {
mavenCentral()
}
 
android {
compileSdkVersion 19
buildToolsVersion "20.0.0"
 
defaultConfig {
minSdkVersion 9
targetSdkVersion 19
}
 
sourceSets {
main {
manifest.srcFile 'AndroidManifest.xml'
java.srcDirs = ['src']
resources.srcDirs = ['src']
aidl.srcDirs = ['src']
res.srcDirs = ['res']
assets.srcDirs = ['assets']
jniLibs.srcDirs = ['libs']
}
 
}
 
lintOptions {
abortOnError false
}
 
}
 
dependencies {
compile fileTree(dir: 'libs', include: ['*.jar'])
} 

  當然,根據各自的sdk和buildtools版本等等,以及其他,配置會有變化,可以看我之前的文章。

  其他

  以上就是主要的集中匯入場景,自己可以根據自己的實際情況然後改變配置等等。

  另外,我們匯入的倉庫可能不是maven中心倉庫,或者可能是我們自己搭建的倉庫,我們可以自定義倉庫地址的,修改build.gradle檔案中的repositories就可以了,例如:

buildscript {
repositories {
jcenter()
mavenCentral()
maven {
url "https://oss.sonatype.org/content/repositories/snapshots"
}
}
}

  另外,project層的buildscript在module層也是會生效的,所以不用在每個module都配置。

相關文章