Gradle Android客戶端程序打包，gradleandroid

Gradle Android客戶端程序打包，gradleandroid

一、前言
　　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打包腳本配置

buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:0.12.+'
    }
}
//項目配置版本號，與apk輸出目錄
ext.appVersionCode = 2
ext.appVersionName = "2.0"
ext.appReleaseDir = "/Users/freedoms/Desktop/release"

apply plugin: 'com.android.application'

//獲取時間戳
def getDate() {
    def date = new Date()
    def formattedDate = date.format('yyyyMMdd')
    return formattedDate
}

//程序包配置
android {
    compileSdkVersion 19
    buildToolsVersion "21.1.2"

    sourceSets {
        main {
            manifest.srcFile 'AndroidManifest.xml'
            java.srcDirs = ['src']
            resources.srcDirs = ['src']
            aidl.srcDirs = ['src']
            renderscript.srcDirs = ['src']
            res.srcDirs = ['res']
            assets.srcDirs = ['assets']

　　　//項目中含有so包，需增加jni相關目錄配置，否則程序運行到調用so時將發生錯誤
            jniLibs.srcDir(['libs'])  
        }

        instrumentTest.setRoot('tests')

        debug.setRoot('build-types/debug')
        release.setRoot('build-types/release')
    }
//打包開始時，lint運行將有可能發生錯誤，當有異常發生時，此設置將忽略警告，繼續運行腳本，若忽略，打包過程將被強行終止
lintOptions { 
　　abortOnError false
 } 
　　//簽名配置
    signingConfigs {
   		myConfig {
        	storeFile file("/Users/freedoms/Desktop/產品需求文檔/android.keystore")
        	storePassword "123123"
        	keyAlias "android.keystore"
        	keyPassword "123123"
   		}
  	}

  　//混淆配置
  	buildTypes{
		release {
	    	signingConfig  signingConfigs.myConfig
　　　　　　　　　 //不需混淆設置為false
	    	runProguard true
	    	proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-project.txt'
	    }
	}

　　//自定義配置
	productFlavors {
	    //百度
	    baidu{
　　　　　　　　　 //AndroidManifest.xml配置中定義的占位符補全配置，實例中在AndroidManifest.xml中配置"${UMENG_CHANNEL_VALUE}",腳本運行後，將baidu_android_channel自動替換到此位置，AndroidManifest.xml其他需要分渠道動態配置的參數可以參考此做法操作
	     	manifestPlaceholders = [UMENG_CHANNEL_VALUE:"baidu_android_channel",BAIDU_CHANNEL_VALUE:"baidu_baidu_android_channel"]
	    }
	    //360
	    "360"{//若配置渠道名為數字開頭，必須加引號
	     	manifestPlaceholders = [UMENG_CHANNEL_VALUE:"360_android_channel",BAIDU_CHANNEL_VALUE:"baidu_360_android_channel"]
	    }
　　　　　　 //可參考以上兩項進行擴展……
	}
	
　　  //打包重命名算法，輸出XXX_Android_v2.0_20160127_baidu.apk到腳本前配置的輸出目錄當中
	android.applicationVariants.all { variant ->
        def file = variant.outputFile
        if(variant.buildType.name.equals('release')){
        	variant.outputFile = new File(appReleaseDir + '/','XXX_Android_v' + appVersionName +getDate()+ '_' + variant.productFlavors[0].name + '.apk')
        }
    }
}

//編碼配置
tasks.withType(Compile) {  
   	options.encoding = "UTF-8"  
} 

四、帶有項目依賴關系的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文本文件，用作引用依賴項目配置

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

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

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

五、運行build腳本
　　1、在命令行中cd 到主項目根目錄下
　　2、輸入gradle clean執行（清理gradle生成的檢查文件和打出的APK，可以不做，但是不保證中間是否會有什麼奇怪問題，養成好習慣）
　　3、輸入gradle check執行（檢查項目，根據渠道數量不同需要時間不同）
　　4、輸入gradle build執行（執行build腳本，開始打包，根據渠道數量不同需要時間不同，45個渠道大概需要1個多小時）
　　5、檢查主項目build.gradle配置的輸出目錄中，打好的渠道包已經在裡面了

六、注意事項（待續）
　　Q1:在執行check或者build時，可能會報如下錯誤

FAILURE: Build failed with an exception.

* What went wrong:
Execution failed for task ':lint'.
> Lint found errors in the project; aborting build.

  Fix the issues identified by lint, or add the following to your build script to proceed with errors:
  ...
  android {
      lintOptions {
          abortOnError false
      }
  }
  ...

* Try:
Run with --stacktrace option to get the stack trace. Run with --info or --debug option to get more log output.

BUILD FAILED

　　A1:在build.gradle腳本中增加

    lintOptions {
          abortOnError false
    }

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

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

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