Gradle Android客戶端程序打包（基於gradle 1.12版本驗證通過）

　　一、前言

　　android客戶端開發進入尾聲，負責SEO同事突然發給我一個涉及45個發布渠道的噩耗，之前只發布自有渠道的工作方式（手動修改參數打包）已經不滿足需求，所以引入最近比較流行的gradle打包技術。

　　gradle基於groovy語言，引入的原因也方便了以後從現在使用的eclipse開發環境遷移到Android Studio，所以blablabla……，不多說了，先上干貨。

　　二、准備工作

　　1、首先，如果使用eclipse作為開發環境，需右鍵點擊項目，在菜單中選擇“Export…”

　　2、然後，在彈出的列表中依次選擇“Android->Generate Gradle build files”

　　3、選擇"Next>"

　　4、再選擇"Next>"

　　5、在列表中勾選需要創建gradle配置腳本的項目，繼續"Next>"

　　6、選擇"Finish"

　　至此，eclipse中已生成gradle配置腳本，可能這是需要右鍵刷新一下項目

　　三、簡單項目Gradle打包腳本配置

1. buildscript {  
2.     repositories {  
3.         jcenter()  
4.     }  
5.     dependencies {  
6.         classpath 'com.android.tools.build:gradle:0.12.+'  
7.     }  
8. }  
9. //項目配置版本號，與apk輸出目錄  
10. ext.appVersionCode = 2  
11. ext.appVersionName = "2.0"  
12. ext.appReleaseDir = "/Users/freedoms/Desktop/release"  
13.   
14. apply plugin: 'com.android.application'  
15.   
16. //獲取時間戳  
17. def getDate() {  
18.     def date = new Date()  
19.     def formattedDate = date.format('yyyyMMdd')  
20.     return formattedDate  
21. }  
22.   
23. //程序包配置  
24. android {  
25.     compileSdkVersion 19  
26.     buildToolsVersion "21.1.2"  
27.   
28.     sourceSets {  
29.         main {  
30.             manifest.srcFile 'AndroidManifest.xml'  
31.             java.srcDirs = ['src']  
32.             resources.srcDirs = ['src']  
33.             aidl.srcDirs = ['src']  
34.             renderscript.srcDirs = ['src']  
35.             res.srcDirs = ['res']  
36.             assets.srcDirs = ['assets']  
37.   
38. 　　　//項目中含有so包，需增加jni相關目錄配置，否則程序運行到調用so時將發生錯誤  
39.             jniLibs.srcDir(['libs'])    
40.         }  
41.   
42.         instrumentTest.setRoot('tests')  
43.   
44.         debug.setRoot('build-types/debug')  
45.         release.setRoot('build-types/release')  
46.     }  
47. //打包開始時，lint運行將有可能發生錯誤，當有異常發生時，此設置將忽略警告，繼續運行腳本，若忽略，打包過程將被強行終止  
48. lintOptions {   
49. 　　abortOnError false  
50.  }   
51. 　　//簽名配置  
52.     signingConfigs {  
53.         myConfig {  
54.             storeFile file("/Users/freedoms/Desktop/產品需求文檔/android.keystore")  
55.             storePassword "123123"  
56.             keyAlias "android.keystore"  
57.             keyPassword "123123"  
58.         }  
59.     }  
60.   
61.   　//混淆配置  
62.     buildTypes{  
63.         release {  
64.             signingConfig  signingConfigs.myConfig  
65. 　　　　　　　　　 //不需混淆設置為false  
66.             runProguard true  
67.             proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-project.txt'  
68.         }  
69.     }  
70.   
71. 　　//自定義配置  
72.     productFlavors {  
73.         //百度  
74.         baidu{  
75. 　　　　　　　　　 //AndroidManifest.xml配置中定義的占位符補全配置，實例中在AndroidManifest.xml中配置"${UMENG_CHANNEL_VALUE}",腳本運行後，將baidu_android_channel自動替換到此位置，AndroidManifest.xml其他需要分渠道動態配置的參數可以參考此做法操作  
76.             manifestPlaceholders = [UMENG_CHANNEL_VALUE:"baidu_android_channel",BAIDU_CHANNEL_VALUE:"baidu_baidu_android_channel"]  
77.         }  
78.         //360  
79.         "360"{//若配置渠道名為數字開頭，必須加引號  
80.             manifestPlaceholders = [UMENG_CHANNEL_VALUE:"360_android_channel",BAIDU_CHANNEL_VALUE:"baidu_360_android_channel"]  
81.         }  
82. 　　　　　　 //可參考以上兩項進行擴展……  
83.     }  
84.       
85. 　　  //打包重命名算法，輸出XXX_Android_v2.0_20160127_baidu.apk到腳本前配置的輸出目錄當中  
86.     android.applicationVariants.all { variant ->  
87.         def file = variant.outputFile  
88.         if(variant.buildType.name.equals('release')){  
89.             variant.outputFile = new File(appReleaseDir + '/','XXX_Android_v' + appVersionName +getDate()+ '_' + variant.productFlavors[0].name + '.apk')  
90.         }  
91.     }  
92. }  
93.   
94. //編碼配置  
95. tasks.withType(Compile) {    
96.     options.encoding = "UTF-8"    
97. }  

　　四、帶有項目依賴關系的gradle打包腳本配置

　　1、依賴項目

　　a)如果使用eclipse作為開發環境，首先需要生成gradle配置腳本（詳見二、准備工作）

　　b)修改gradle腳本中apply plugin為以下配置

　　apply plugin: 'android-library'

　　c)其他配置同主項目，可參考簡單項目gradle腳本配置

　　2、主項目

　　a)如果使用eclipse作為開發環境，首先需要生成gradle配置腳本（詳見二、准備工作）

　　b)修改gradle腳本中apply plugin為以下配置

　　apply plugin: 'com.android.application'

　　c)在主項目根目錄下創建setting.gradle文本文件，用作引用依賴項目配置

1. //引入依賴項目名  
2. include 'library'  
3. include 'library_pullToRefresh'  
4. //創建目錄引用，最後引號中是依賴項目存放的絕對路徑  
5. project(':library').projectDir = new File('/Users/freedoms/git/library')    
6. project(':library_pullToRefresh').projectDir = new File('/Users/freedoms/git/library_pullToRefresh')  

　　d)在主項目的build.gradle中增加以下配置

1. //依賴配置  
2. dependencies {  
3.     compile fileTree(dir: 'libs', include: '*.jar')  
4.     compile project(':library_pullToRefresh')    
5.     compile project(':library')  
6. }  

　　五、運行build腳本

　　1、在命令行中cd 到主項目根目錄下

　　2、輸入gradle clean執行（清理gradle生成的檢查文件和打出的APK，可以不做，但是不保證中間是否會有什麼奇怪問題，養成好習慣）

　　3、輸入gradle check執行（檢查項目，根據渠道數量不同需要時間不同）

　　4、輸入gradle build執行（執行build腳本，開始打包，根據渠道數量不同需要時間不同，45個渠道大概需要1個多小時）

　　5、檢查主項目build.gradle配置的輸出目錄中，打好的渠道包已經在裡面了

　　六、注意事項（待續）

　　Q1:在執行check或者build時，可能會報如下錯誤

1. FAILURE: Build failed with an exception.  
2.   
3. * What went wrong:  
4. Execution failed for task ':lint'.  
5. > Lint found errors in the project; aborting build.  
6.   
7.   Fix the issues identified by lint, or add the following to your build script to proceed with errors:  
8.   ...  
9.   android {  
10.       lintOptions {  
11.           abortOnError false  
12.       }  
13.   }  
14.   ...  
15.   
16. * Try:  
17. Run with --stacktrace option to get the stack trace. Run with --info or --debug option to get more log output.  
18.   
19. BUILD FAILED  

　　A1:在build.gradle腳本中增加

1. lintOptions {  
2.       abortOnError false  
3. }  

　　Q2:根據渠道數量的多少，可能在打包時會報java虛擬機內存不足

1. The system is out of resources.  
2. Consult the following stack trace for details.  
3. java.lang.OutOfMemoryError: Java heap space  
4.     at com.sun.tools.javac.util.Position$LineMapImpl.build(Position.java:139)  
5.     at com.sun.tools.javac.util.Position.makeLineMap(Position.java:63)  
6.     at com.sun.tools.javadoc.DocCommentScanner.getLineMap(DocCommentScanner.java:438)  
7.     at com.sun.tools.javac.main.JavaCompiler.parse(JavaCompiler.java:512)  
8.     at com.sun.tools.javac.main.JavaCompiler.parse(JavaCompiler.java:550)  
9.     at com.sun.tools.javac.main.JavaCompiler.parseFiles(JavaCompiler.java:804)  
10.     at com.sun.tools.javac.main.JavaCompiler.compile(JavaCompiler.java:727)  
11.     at com.sun.tools.javac.main.Main.compile(Main.java:353)  
12.     at com.sun.tools.javac.api.JavacTaskImpl.call(JavacTaskImpl.java:115)  

　　A2:可減少一次打包的渠道數量，然後再打包另一部分渠道（曲線救國）