Gradle 構建 Android 應用常見問題解決指南

前言

Android gradle 插件已經發展到0.5.7,同時gradle 本身也到了1.8,相比兩個月前,android gradle 更快,更完善,也更好用了,為了讓各位androider 早日用上gradle這樣的神器,特地寫一篇關於gradle一些奇葩錯誤的解決指南.

使用最新的gradle android插件

以前我們寫的時候會這麼寫

dependencies {  classpath 'com.android.tools.build:gradle:0.5.0'}

不過,由於android gradle 插件的開發還是很活躍的,而且目前而言,可能還存在一些我們不知道的坑,但是,別人踩過,後邊,官方修復,為了不踩坑,我建議android gradle 始終保持最新版本,寫法如下:

dependencies {  classpath 'com.android.tools.build:gradle:0.5+'}

由於代碼編碼與編譯環境編碼不一致,導致構建失敗

有時候,我們的代碼使用utf-8 保存的,但是,進行gradle build 的環境是gbk這類的,這時候會包如下錯誤:

15: 錯誤: 編碼GBK的不可映射字符

   * 鍑虹幇涓枃璇鋒敞鎰?

這個時候我們就需要手動的設置編譯時編碼類型.

tasks.withType(Compile) {  options.encoding = "UTF-8"}apply plugin: 'android'android {}

android support v4 重復引用問題

UNEXPECTED TOP-LEVEL EXCEPTION:java.lang.IllegalArgumentException: already added: Landroid/support/v4/app/ActivityCompatHoneycomb;    at com.android.dx.dex.file.ClassDefsSection.add(ClassDefsSection.java:123)    at com.android.dx.dex.file.DexFile.add(DexFile.java:163)    at com.android.dx.command.dexer.Main.processClass(Main.java:490)    at com.android.dx.command.dexer.Main.processFileBytes(Main.java:459)    at com.android.dx.command.dexer.Main.access$400(Main.java:67)    at com.android.dx.command.dexer.Main$1.processFileBytes(Main.java:398)    at com.android.dx.cf.direct.ClassPathOpener.processArchive(ClassPathOpener.java:245)

出現這個問題的原因一般是由於我們這樣的寫法導致:

dependencies {  compile fileTree(dir: 'libs', include: '*.jar')}

某個相同的jar包,被復制到了build目錄導致重復編譯使編譯時失敗,

由於這個問題android support v4 出現的比較多,所以同類型的都歸類為v4 問題吧.

要避免這個問題,我們盡量少使用依賴某個目錄下所有包,畢竟android項目不想java web項目動不動就有好幾十jar 包依賴.要修復這個v4,原理很簡單,可以使用依賴maven的寫法.

dependencies {  compile 'com.android.support:support-v4:13.0.0'}

打包後缺少*.so文件

用指定依賴包的方式打包,我們會發現,最終打包後的jar沒有了*.so文件,這個時候,我們需要自定義一個tasks,寫如下:

task copyNativeLibs(type: Copy) {  from(new File('libs')) { include '**/*.so' }  into new File(buildDir, 'native-libs')}tasks.withType(Compile) { compileTask -> compileTask.dependsOn copyNativeLibs }clean.dependsOn 'cleanCopyNativeLibs'tasks.withType(com.android.build.gradle.tasks.PackageApplication) { pkgTask ->  pkgTask.jniDir new File(buildDir, 'native-libs')}

這樣,在編譯時,就會自動把libs目錄下的**/*.so 文件復制到apk裡面了.

構建多渠道包

在最新版本的gradle 0.5.7 中,構建多渠道包比之前簡單多了,在以前,你需要這麼寫:

android {  buildTypes {     hiapk {       packageNameSuffix ".hiapk"     }     playstore {       packageNameSuffix ".playstore"    }   }  sourceSets {    hiapk {      manifest.srcFile 'hiapk/AndroidManifest.xml'    }    playstore {      manifest.srcFile 'hiapk/AndroidManifest.xml'    }  }}

要替換某個類型的文件需要自己手動寫,渠道多了,這代碼量是可想而知的多,在0.5.7中,進行了一個約定規則,構建,渠道包你只需

android {  buildTypes {     hiapk {       packageNameSuffix ".hiapk"     }     playstore {       packageNameSuffix ".playstore"    }   }  sourceSets {     hiapk.setRoot('build-types/hiapk')     playstore.setRoot('build-types/playstore')  }}

在項目的根目錄下創建一個build-types的目錄,在創建對應渠道的子目錄,然後把一些,諸如要替換AndroidManifest.xml,裡面友盟渠道號什麼的,直接把xml復制進去就行,gradle在構建項目的時候,會自動的優先使用build-types下目錄文件的目錄,諸如,根據不同渠道,不同國家換個程序圖標什麼的,都只要放到目錄下即可.