计划写个完整的使用Ant打包Android应用的系列文章,三篇文章。首篇详细介绍采用Ant打包Android应用的流程,列出部分定制问题及其解决方法,第二篇介绍我理解的Ant打包的思路与基本的概念和使用,最后一篇描述apk包的生成过程。
实现的环境:
操作系统:ubuntu 64bit 14.04
Android SDK Build Tools:22.0.1
Android SDK Tools:24.3.3
Ant:1.9.4
ProGuard:5.2.1
JDK:1.7
一、简单应用出包流程
这里的出包流程包括编译、代码混淆、apk签名。对于简单的Android应用,简单的几步操作就能完成:
1.生成Ant编译需要的build.xml
在SDK目录的tools下,调用android update project生成,具体命令的用法可以查看参考1,例如:切换到你的工程目录
android update project --name 自己起的工程名 -p .
-p参数后面的点是表示当前目录
在工程目录下就会生成Ant编译需要的build.xml,直接运行ant debug,即可完成编译,并在bin目录下生成debug版本的apk包。需要注意的几个问题是:
(1)自动生成的build.xml生成了几个跟Android相关的target呢:可以通过直接输入ant来查看help说明
(2)遇到BUILD FAILED如何解决:可以查看BUILD FAILED上面的log看执行到什么地方,还有看提示在build.xml的哪一行出现问题,这里的build.xml是指在sdk/tools/ant下的,例如:
[aapt] invalid resource directory name: 工程目录/bin/res crunch BUILD FAILED sdk/tools/ant/build.xml:649: The following error occurred while executing this line: build.xml:694:null returned: 1
一般看到res crunch,应该就是你在eclipse中工程自动编译的文件与ant生成文件冲突,只要关掉eclipse的自动编译,clean下工程重新跑ant即可。
(3)可以留心看下project.properties和local.properties
2.添加代码混淆
在工程的project.properties文件中有注释说明如何打开代码混淆
#proguard.config=${sdk.dir}/tools/proguard/proguard-android.txt:proguard-project.txt
去除#号即可,同时可以在proguard-project.txt增加你需要特殊处理的配置
修改后,再执行ant release,你会在输出中看到
-obfuscate: [mkdir] Created dir:工程目录/bin/proguard [jar] Building jar: 工程目录/bin/proguard/original.jar [proguard] ProGuard, version 5.2.1 ...
可以看到我用的proguard版本,但是用ant debug是没有proguard,因为只有release版本才需要混淆,具体原因后续文章会详细讲述。混淆后的mapping文件在bin目录下。
注意的问题:工程的AndroidManifest.xml中如果配置了android:debuggable=true,那么即使ant release也不会混淆代码
3.签名
首先给apk签名需要keystore,具体的生成此处不细讲,简单的说在eclipse中选则工程,右键android tools -> export android application 中有生成选项
其次是在工程目录下新建ant.properties文件,里面配置你的签名信息
例如:
key.store=kestore文件的路径
key.store.password=密码
key.alias.password=密码
key.alias=别名
此时再执行ant release,在bin目录下可生成“工程名-release.apk”,你最终要的release版本的apk
到此,简单android工程的的ant编译打包完成,非常方便。
二、添加定制化
1.加入so库
Android应用的Ant编译默认是不会编译jni工程的,它只会处理libs中的库文件。如果你的libs中刚好有编译好的so,那打包好的apk似乎能正常运行。在配置好的jni工程,只要运行ndk的ndk-build即可完成so的编译。因此,只要在build.xml同目录中添加custom_rules.xml文件,内容如下:
<?xml version="1.0" encoding="UTF-8"?> <project name="工程名" default="help"> <target name="-pre-compile"> <echo >ndk build.............................</echo> <exec executable="${ndk.dir}/ndk-build" > </exec> </target> </project>
在同目录下的local.properties中增加一行,指定你的ndk目录
ndk.dir=ndk路径
再次执行ant release,查看你的so库是否已生成
如果你的jni工程是作为库工程存在,方法是一样的。主工程依赖你的库工程,在库工程中也生成build.xml,然后按照上面的方法操作即可。
2.调用隐藏api,加入android.jar
不少工程是基于Android原生代码修改而来,或者就是想调用系统隐藏的部分api,就会用到别人编译好的android.jar,或者framework.jar等其它什么名字的库文件,而且会要求加载的顺序在你选择的android编译版本之前。在eclipse的Java Build Path->Libraries中调整其加载顺序,那么ant编译怎么修改呢?还是利用前面编写的custom_rules.xml,内容如下:
<?xml version="1.0" encoding="UTF-8"?> <project name="hooktest" default="help"> <property name="project.target.android.jar" value="${sdk.dir}/platforms/${target}/android.jar" /> <target name="-pre-compile"> <echo >set project target class path.............................</echo> <path id="project.target.class.path"> <pathelement location="framework.jar"/> <pathelement location="${project.target.android.jar}"/> </path> <property name="my.project.target.class.path" refid="project.target.class.path" /> <echo message="project.target.class.path:${my.project.target.class.path}" /> </target> </project>
3.一个工程中多源码目录
如果一个工程中设置了多个源码目录,不太合适的方法就是先拷贝其它的源码目录到默认的src下,在编译完成后再删除。其实顺便看看文件拷贝和删除,在多源码目录的工程中也建立custom_rules.xml,主要内容如下:
<target name="-pre-build"> <echo >copy file.............................</echo> <copy todir="${source.absolute.dir}"> <fileset dir="其它源码目录"> <include name="**/*.java" /> <include name="**/*.aidl" /> </fileset> </copy> </target> <target name="src-clean" > <echo >delete file.............................</echo> <delete dir="${source.absolute.dir}/拷贝的源码目录" /> </target> <target name="-post-build" depends="src-clean"> </target> <target name="-pre-clean" depends="src-clean"> </target>
上述代码在执行ant clean时也会执行删除拷贝的源码操作,而在编译前先拷贝源码,包括aidl文件,之后在打包完成后删除拷贝的源码目录。
一个工程中的源码尽量就弄在一个目录里吧。其它问题还有如库工程间的资源引用,如果直接使用默认的R文件是没有问题的,但是要是在eclipse中利用build Java Build Path->project添加了子工程,并且还用了其中的R文件来应用资源,那么ant打包就还得再继续折腾
结尾:
这里仅给出了使用Ant打包Android应用的基本过程和可能问题的解决方法,至于ant的使用和打包原理既可以看参考文章,也可以看后续的补充文章。
参考:
1.android命令详细说明http://developer.android.com/tools/help/android.html
2.ant参考手册https://ant.apache.org/manual/
3.ant打包apk详细的过程可阅读sdk/tools/ant/build.xml文件
版权声明:本文为博主原创文章,未经博主允许不得转载。