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/Activ
ityCompatHoneycomb;
        at com.android.dx.dex.file.ClassDefsSection.add(ClassDefsSection.java:12
3)
        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(ClassPathOpen
er.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下目录文件的目录,诸如,根据不一样渠道,不一样国家换个程序图标什么的,都只要放到目录下便可.