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

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

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

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