整理記錄 AndroidStudio 把一個 module 專案打包成 jar 包。

一、預設自動生成的 jar 包

　　眾所周知 android studio 會在library所依賴的 app執行 或 build 之後自動生成 jar 包，路徑為 Module根目錄/build/intermediates/bundles/debug or release/classes.jar，這樣生成的jar是可以用的，但不是我們可以控制的，所以我們需要通過其他方式來解決這個問題。

　　注意：

　　若發現 Android Studio 專案 bundle 資料夾下沒有 release 目錄，可能是沒有將 module 新增到主 module 依賴中。

　　方式1：主module右鍵 --> 倒數第二個Open Module Setting--> 上面最後一個選項Dependencies-->右邊綠色加號-->Module dependency......然後確定

　　方式2：主Module的gradle的dependencies（平時新增第三方庫的地方）中加上 compile project(':lib-zxing')

二、自定義生成 jar 包

　　首先，需要將待打包 module 專案中的 build.gradld 檔案進行修改，如下圖： 
　　

　　其次，在 build.gradle 檔案中加入如下程式碼： 

　　方式一：

def _BASENAME = "TestJar";
def _VERSION = "_V1.0";
def _DestinationPath = "build"; //生成jar包的位置
def zipFile = file('build/intermediates/bundles/default/classes.jar'); //待打包檔案位置

task deleteBuild(type:Delete){
    delete _DestinationPath + _BASENAME + _VERSION + ".jar"
}

task makeJar(type:Jar){
    from zipTree(zipFile)
    from fileTree(dir:'src/main',includes:['assets/**']) //將assets目錄打入jar包  
    baseName = _BASENAME + _VERSION
    destinationDir = file(_DestinationPath)
}

makeJar.dependsOn(deleteBuild, build)
 

　　方式二：打包的 jar 只有原始碼的.class 檔案，不包含資原始檔

task makeJar(type: Copy) {
    delete 'build/TestJar_V1.0.jar' //刪除之前的舊jar包
    from('build/intermediates/bundles/default/') //從這個目錄下取出預設jar包
    into('build/') //將jar包輸出到指定目錄下
    include('classes.jar')
    rename('classes.jar', 'TestJar_V1.0.jar') //自定義jar包的名字
}
makeJar.dependsOn(build)

　　方式三：

task clearJar(type: Delete) {
    delete 'build/TestJar_V1.0.jar' //jar包的名字，隨便命名 
}
task makeJar(type:org.gradle.api.tasks.bundling.Jar) {
    //指定生成的jar名 
    baseName 'TestJar_V1.0'
    //從哪裡打包class檔案 
    from('build/intermediates/bundles/default/')
    //打包到jar後的目錄結構 
    into('build/')
    //去掉不需要打包的目錄和檔案 
    exclude('test/', 'BuildConfig.class', 'R.class')
    //去掉R開頭的檔案  
    exclude{it.name.startsWith('R');}
}
makeJar.dependsOn(clearJar, build)

　　注意：

　　以上配置資訊要與 android {…….} 配置的指令碼成平級關係。

　　其中 _BASENAME = "TestJar"; _VERSION = "_V1.0"; 是定義生成 jar 包的名字為TestJar_V1.0.jar。

　　配置好以後就可以編譯jar包了，有兩種方式：

　　方式 A ：點選 Android Studio 右側(一般在這個位置)的 Gradle 面板，在專案或者該類庫的目錄中找到 Tasks -> other -> makeJar 命令，雙擊這個makeJar之後等一會就會編譯好jar包。

　　打包成功後：在配置的指定目錄下生成jar包

　　方式 B ：通過 cmd 命令列，在專案根目錄下，執行 gradlew makeJar 命令，看到編譯完成的資訊以後就OK了，也能生成一樣的jar包，和直接使用①中的方式是等價的。

　　注意：使用此方式前要配置好 gradle 的“ 環境變數 ”，否則直接在專案根目錄下找不到這個命令。使用 cmd 比較費勁，不推薦。

　　方式 C ：在 Android Studio 終端視窗中輸入 gradlew makeJar 命令。

　　打包成功如下圖：

　　打包成功後：在配置的指定目錄下生成jar包

　　注意:

　　問題1：

　　對於以上配置 form 預設 jar 包部分，在用目錄是 from('build/intermediates/bundles/release/') ，注意粗體部分，最初我也是按照這個目錄寫的，確實沒問題。但後來，也就是Android Studio 更新到2.3以後，發現這個目錄沒有了，取而代之的是 default 和 debug 目錄，debug目錄之前也是有的，沒有變化，只是原來的release目錄被現在的default目錄代替了。這導致我後來生成jar包的時候始終沒有找到jar包，報上圖所示錯誤。

　　原因就是沒有了 release 目錄，找不到預設的 classes.jar 檔案，所以也就沒有生成自定義名字的jar包，改為 default 或者 debug 目錄以後就能正常生成jar包了，要注意這點變化。

　　問題2

Execution failed for task ':mylibrary:lint'.
> Lint found errors in the project; aborting build.

　　解決在 build.gradle 檔案中，加入下面的程式碼塊（注意程式碼塊所在的位置）,重新執行 gradlew makeJar 命令。

android {
    lintOptions {
        abortOnError false
    }
    ...
}

　　最後注意：

　　將被嵌入的應用打包成 jar 包，但是這樣的方式有侷限性，無法將被嵌入的應用所使用的資源性檔案一起打包。下面介紹 aar 打包方式。

三、直接使用 aar 包

　　將被嵌入的應用打包成 aar 包，這也是 Android Studio 的一種新特性，可以將應用所使用的資源性檔案一起打包。編譯即可打包生成 aar 包，而且也不用擔心漏掉資源問題。

　　如果Project 中 Module 是一個應用，則在 Module 的 build.gradle 檔案中定義屬性為：apply plugin: 'com.android.application'；而如果 Mudule 是一個被引用的依賴 lib 庫的話，則在 Module 的 build.gradle 檔案中定義屬性為： apply plugin: 'com.android.library；所以當我們將應用 Module 打包出 aar 檔案的時候，需要修改型別屬性。正常情況下，直接重新編譯 Module，生成的 aar 包在 Module 根目錄的／build／outputs／aar／，如下圖：

　　下面介紹將 aar 包新增到其他 Android 工程：

　　首先，將 aar 包複製到 libs 目錄下

　　其次，配置build.gradle檔案：

　　A 在 android 中加入，如下：

repositories {  
    flatDir {  
        dirs 'libs'  
    }  
}  

　　B 在 dependencies 中加入 compile(name:lib-zxing-release', ext:'aar')

　　完整 build.gradle 檔案如下：

apply plugin: 'com.android.application'  
  
android {  
    ...
    repositories {  
        flatDir {  
            dirs 'libs'  
        }  
    }  
}  
  
dependencies {  
    ...
    compile(name:'lib-zxing-release', ext:'aar')  
}  

　　最後，重新編譯 Rebuild 的以下工程。