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

Sam的部落格發表於2015-01-15

前兩天,谷歌釋出了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'

匯入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"
        }
    }
}

相關文章