用Ant手动打包android程序 _android

亦余心之所善兮，虽九死其犹未悔。这篇文章主要讲述用Ant手动打包android程序相关的知识，希望能为你提供帮助。
首先我们要给自己的IDE eclispe配置ant,默认的eclipse是集成了ant构建工具的，但是google提供的android集成开发工具ADT，里面封装了Eclipse，但是很奇怪的是竟然没有Ant插件在里面标准的Eclipse一般都是内置集成了Ant的。然后我们到eclipse的plugins目录下查看了,其实是有安装ant插件的，但是没有在界面体现出来。要让Eclipse在界面显示Ant的相关配置，可在命令行下作如下操作：

$ cd < your eclipse install folder> $ eclipse -application org.eclipse.equinox.p2.director -repository http://download.eclipse.org/releases/juno -installIU org.eclipse.ant.ui Installingorg.eclipse.ant.ui 3.5.400.v20130514-1341.

然后重启一下你的eclipse就可以看到ant插件在菜单中正常显示出来了。

通常我们习惯用eclipse来开发Android程序，它会自动帮我们打包当前的应用程序。如果在Navigator视图下，我们可以看到以下几个文件：

文章图片

在上图中，com包放置的是我们的class文件，classes.dex是class文件经过转换后的可以在dalvik上跑的精简类文件，resources.ap_是经过打包的资源文件，ant.apk就是最终的打包文件。
使用ANT来对应用打包，一般会经过以下几个步骤：
1.用aapt命令生成R.java文件
2.用aidl命令生成相应java文件
3.用javac命令编译java源文件生成class文件
4.用dx.bat将class文件转换成classes.dex文件
5.用aapt命令生成资源包文件resources.ap_
6.用apkbuilder.bat打包资源和classes.dex文件,生成unsigned.apk
7.用jarsinger命令对apk认证,生成signed.apk
为了便于理解和记忆，下面来用一张流程图来说明以上的几个过程：

文章图片

以上就是整体的流程，下面我们就对其每个部分进行做出详细讲解，把每一个步骤都弄清楚了。
我们需要先熟悉一下每一个步骤所使用到的命令：
1.aapt（Android Asset Packaging Tool）命令，根据资源文件生成R.java文件

文章图片

参数说明：
-f 强制覆盖已存在的文件。
-m 在-J指定的位置下自动生成相应的包的目录。
-J 指定R.java文件生成的目录。
-S 指定资源目录。
-M 指定清单文件。
-I 引入类库。
注意，我们当前所在的位置是ant项目根目录，所以必要时需要输入很多关于命令的路径，以下示例也是一样。
2.aidl（Android Interface Definition Language）命令，根据.aidl定义文件生成java文件

文章图片

上面的示例所在位置为com/scott/ant下，根据包中的Person.aidl文件，在gen对应的目录中生成Person.java文件，示例中只是处理单一文件，下文中会讲述如何处理目录中的多个aidl文件。
3.javac（Java Compiler）命令，根据源文件生成对应的class文件

文章图片

参数说明：
-d < 目录> 指定存放生成的类文件的位置
-bootclasspath < 路径> 覆盖引导类文件的位置
示例中并没有考虑到引用类路径下面的类库，复杂的情况会在稍后遇到的。
4.dx命令，将class文件转换成.dex文件

文章图片

以上示例是将bin目录下的class文件转换成classes.dex文件，输出到bin目录，我们也许会用到第三方类库，等一会就会看到。
5.aapt将资源文件打包

文章图片

参数说明：
-f 强制覆盖
【用Ant手动打包android程序】-M 指定Manifest文件
-S 指定资源目录
-A 指定资产目录
-I 指定引入的类库
-F 指定要生成的包
6.apkbuilder命令，根据classes.dex文件和resources.ap_生成为签证的apk包

文章图片

参数说明：
-rf 参照源文件的目录的结构
7.jarsigner命令，对上面生成的apk包进行签证

文章图片

在签证的过程中，需要使用到证书文件，需要注意的是最后的release是证书的别名，关于如何创建证书，请看下图：

文章图片

当然也可以在eclipse里使用ADT提供的图形界面完成以上步骤，选中项目，点击右键，“ Android Tools=> Export Signed Application Package” ，然后再其中的Keystore selection环节选择“ Create new keystore” ，然后按照提示填写信息就可以了。
以上是我们使用到的命令，接下来我们就该来分析一下ANT所必须的build.xml：
首先我们需要定义大量的变量属性，用来表示使用到的路径、目录等，如下：

< project name="ant" default="release"> < !-- ANT环境变量 --> < property environment="env" /> < !-- 应用名称 --> < property name="appName" value="https://www.songbingjia.com/android/${ant.project.name}"/> < !-- SDK目录(获取操作系统环境变量ANDROID_SDK_HOME的值) --> < property name="sdk-folder" value="https://www.songbingjia.com/android/${env.ANDROID_SDK_HOME}" /> < !-- SDK指定平台目录 --> < property name="sdk-platform-folder" value="https://www.songbingjia.com/android/${sdk-folder}/platforms/android-8"/> < !-- SDK中tools目录 --> < property name="sdk-tools" value="https://www.songbingjia.com/android/${sdk-folder}/tools" /> < !-- SDK指定平台中tools目录 --> < property name="sdk-platform-tools" value="https://www.songbingjia.com/android/${sdk-platform-folder}/tools" /> < !-- 使用到的命令(当前系统为windows,如果系统为linux,可将.bat文件替换成相对应的命令) --> < property name="aapt" value="https://www.songbingjia.com/android/${sdk-platform-tools}/aapt" /> < property name="aidl" value="https://www.songbingjia.com/android/${sdk-platform-tools}/aidl" /> < property name="dx" value="https://www.songbingjia.com/android/${sdk-platform-tools}/dx.bat" /> < property name="apkbuilder" value="https://www.songbingjia.com/android/${sdk-tools}/apkbuilder.bat" /> < property name="jarsigner" value="https://www.songbingjia.com/android/${env.JAVA_HOME}/bin/jarsigner" /> < !-- 编译需要的jar; 如果项目使用到地图服务则需要maps.jar --> < property name="android-jar" value="https://www.songbingjia.com/android/${sdk-platform-folder}/android.jar" /> < property name="android-maps-jar" value="https://www.songbingjia.com/android/${sdk-folder}/add-ons/addon_google_apis_google_inc_8/libs/maps.jar"/> < !-- 编译aidl文件所需的预处理框架文件framework.aidl --> < property name="framework-aidl" value="https://www.songbingjia.com/android/${sdk-platform-folder}/framework.aidl" /> < !-- 生成R文件的相对目录 --> < property name="outdir-gen" value="https://www.songbingjia.com/android/gen" /> < !-- 编译后的文件放置目录 --> < property name="outdir-bin" value="https://www.songbingjia.com/android/bin" /> < !-- 清单文件 --> < property name="manifest-xml" value="https://www.songbingjia.com/android/AndroidManifest.xml" /> < !-- 源文件目录 --> < property name="resource-dir" value="https://www.songbingjia.com/android/res" /> < property name="asset-dir" value="https://www.songbingjia.com/android/assets" /> < !-- java源文件目录 --> < property name="srcdir" value="https://www.songbingjia.com/android/src" /> < property name="srcdir-ospath" value="https://www.songbingjia.com/android/${basedir}/${srcdir}" /> < !-- 外部类库所在目录 --> < property name="external-lib" value="https://www.songbingjia.com/android/lib" /> < property name="external-lib-ospath" value="https://www.songbingjia.com/android/${basedir}/${external-lib}" /> < !-- 生成class目录 --> < property name="outdir-classes" value="https://www.songbingjia.com/android/${outdir-bin}" /> < property name="outdir-classes-ospath" value="https://www.songbingjia.com/android/${basedir}/${outdir-classes}" /> < !-- classes.dex相关变量 --> < property name="dex-file" value="https://www.songbingjia.com/android/classes.dex" /> < property name="dex-path" value="https://www.songbingjia.com/android/${outdir-bin}/${dex-file}" /> < property name="dex-ospath" value="https://www.songbingjia.com/android/${basedir}/${dex-path}" /> < !-- 经过aapt生成的资源包文件 --> < property name="resources-package" value="https://www.songbingjia.com/android/${outdir-bin}/resources.ap_" /> < property name="resources-package-ospath" value="https://www.songbingjia.com/android/${basedir}/${resources-package}" /> < !-- 未认证apk包 --> < property name="out-unsigned-package" value="https://www.songbingjia.com/android/${outdir-bin}/${appName}-unsigned.apk" /> < property name="out-unsigned-package-ospath" value="https://www.songbingjia.com/android/${basedir}/${out-unsigned-package}" /> < !-- 证书文件 --> < property name="keystore-file" value="https://www.songbingjia.com/android/${basedir}/release.keystore" /> < !-- 已认证apk包 --> < property name="out-signed-package" value="https://www.songbingjia.com/android/${outdir-bin}/${appName}.apk" /> < property name="out-signed-package-ospath" value="https://www.songbingjia.com/android/${basedir}/${out-signed-package}" /> ... < /project>

然后，我们分步骤来进行，首先是初始化：

< !-- 初始化工作 --> < target name="init"> < echo> Initializing all output directories...< /echo> < delete dir="${outdir-bin}" /> < mkdir dir="${outdir-bin}" /> < mkdir dir="${outdir-classes}" /> < /target>

其次是生成R.java文件：

< !-- 根据工程中的资源文件生成R.java文件--> < target name="gen-R" depends="init"> < echo> Generating R.java from the resources...< /echo> < exec executable="${aapt}" failonerror="true"> < arg value="https://www.songbingjia.com/android/package" /> < arg value="https://www.songbingjia.com/android/-f" /> < arg value="https://www.songbingjia.com/android/-m" /> < arg value="https://www.songbingjia.com/android/-J" /> < arg value="https://www.songbingjia.com/android/${outdir-gen}" /> < arg value="https://www.songbingjia.com/android/-S" /> < arg value="https://www.songbingjia.com/android/${resource-dir}" /> < arg value="https://www.songbingjia.com/android/-M" /> < arg value="https://www.songbingjia.com/android/${manifest-xml}" /> < arg value="https://www.songbingjia.com/android/-I" /> < arg value="https://www.songbingjia.com/android/${android-jar}" /> < /exec> < /target>

接着是aidl生成java源文件：

< !-- 编译aidl文件 --> < target name="aidl" depends="gen-R"> < echo> Compiling .aidl into java files...< /echo> < apply executable="${aidl}" failonerror="true"> < !-- 指定预处理文件 --> < arg value="https://www.songbingjia.com/android/-p${framework-aidl}"/> < !-- aidl声明的目录 --> < arg value="https://www.songbingjia.com/android/-I${srcdir}"/> < !-- 目标文件目录 --> < arg value="https://www.songbingjia.com/android/-o${outdir-gen}"/> < !-- 指定哪些文件需要编译 --> < fileset dir="${srcdir}"> < include name="**/*.aidl"/> < /fileset> < /apply> < /target>

我们指定了一个framework.aidl，里面定义了很多android内置对象，然后我们指定了aidl所在目录和输出目录，组后指定编译后缀为aidl的文件。接下来是将源文件编译成class文件：

< !-- 将工程中的java源文件编译成class文件 --> < target name="compile" depends="aidl"> < echo> Compiling java source code...< /echo> < javac encoding="utf-8" target="1.5" srcdir="." destdir="${outdir-classes}" bootclasspath="${android-jar}"> < classpath> < fileset dir="${external-lib}" includes="*.jar"/> < filelist> < file name="${android-maps-jar}"/> < /filelist> < /classpath> < /javac> < /target>

如果使用到了第三方类库，我们可以在classpath标签下配置。接着是将class文件转换成classes.dex：

< !-- 将.class文件转化成.dex文件 --> < target name="dex" depends="compile"> < echo> Converting compiled files and external libraries into a .dex file...< /echo> < exec executable="${dx}" failonerror="true"> < arg value="https://www.songbingjia.com/android/--dex" /> < !-- 输出文件 --> < arg value="https://www.songbingjia.com/android/--output=${dex-ospath}" /> < !-- 要生成.dex文件的源classes和libraries --> < arg value="https://www.songbingjia.com/android/${outdir-classes-ospath}" /> < arg value="https://www.songbingjia.com/android/${external-lib-ospath}"/> < /exec> < /target>

就像上面的代码一样，如果使用到第三方类库，可以在最后一参数的形式追加进去。然后是将资源文件打包：

< !-- 将资源文件放进输出目录 --> < target name="package-res-and-assets"> < echo> Packaging resources and assets...< /echo> < exec executable="${aapt}" failonerror="true"> < arg value="https://www.songbingjia.com/android/package" /> < arg value="https://www.songbingjia.com/android/-f" /> < arg value="https://www.songbingjia.com/android/-M" /> < arg value="https://www.songbingjia.com/android/${manifest-xml}" /> < arg value="https://www.songbingjia.com/android/-S" /> < arg value="https://www.songbingjia.com/android/${resource-dir}" /> < arg value="https://www.songbingjia.com/android/-A" /> < arg value="https://www.songbingjia.com/android/${asset-dir}" /> < arg value="https://www.songbingjia.com/android/-I" /> < arg value="https://www.songbingjia.com/android/${android-jar}" /> < arg value="https://www.songbingjia.com/android/-F" /> < arg value="https://www.songbingjia.com/android/${resources-package}" /> < /exec> < /target>

接着是打包成未签证的apk包：

< !-- 打包成未签证的apk --> < target name="package" depends="dex, package-res-and-assets"> < echo> Packaging unsigned apk for release...< /echo> < exec executable="${apkbuilder}" failonerror="true"> < arg value="https://www.songbingjia.com/android/${out-unsigned-package-ospath}" /> < arg value="https://www.songbingjia.com/android/-u" /> < arg value="https://www.songbingjia.com/android/-z" /> < arg value="https://www.songbingjia.com/android/${resources-package-ospath}" /> < arg value="https://www.songbingjia.com/android/-f" /> < arg value="https://www.songbingjia.com/android/${dex-ospath}" /> < arg value="https://www.songbingjia.com/android/-rf" /> < arg value="https://www.songbingjia.com/android/${srcdir-ospath}" /> < /exec> < echo> It will need to be signed with jarsigner before being published.< /echo> < /target>

然后是对apk签证：

< !-- 对apk进行签证 --> < target name="jarsigner" depends="package"> < echo> Packaging signed apk for release...< /echo> < exec executable="${jarsigner}" failonerror="true"> < arg value="https://www.songbingjia.com/android/-keystore" /> < arg value="https://www.songbingjia.com/android/${keystore-file}" /> < arg value="https://www.songbingjia.com/android/-storepass" /> < arg value="https://www.songbingjia.com/android/123456" /> < arg value="https://www.songbingjia.com/android/-keypass" /> < arg value="https://www.songbingjia.com/android/123456" /> < arg value="https://www.songbingjia.com/android/-signedjar" /> < arg value="https://www.songbingjia.com/android/${out-signed-package-ospath}" /> < arg value="https://www.songbingjia.com/android/${out-unsigned-package-ospath}"/> < !-- 不要忘了证书的别名 --> < arg value="https://www.songbingjia.com/android/release"/> < /exec> < /target>

最后发布：

< !-- 发布 --> < target name="release" depends="jarsigner"> < !-- 删除未签证apk --> < delete file="${out-unsigned-package-ospath}"/> < echo> APK is released. path:${out-signed-package-ospath}< /echo> < /target>

这样就完成了build.xml的编辑，eclipse继承了ANT，所以我们可以在eclipse中直接运行，也可以在代码中调用。首先我们需要下载ANT，然后配置相应的环境变量信息，最后我们这样调用：

Process p = Runtime.getRuntime().exec("ant.bat -buildfile d:/workspace/ant/build.xml"); InputStream is = p.getInputStream(); BufferedReader br = new BufferedReader(new InputStreamReader(is)); String line = null; while ((line = br.readLine()) != null) { System.out.println(line); } System.out.println("SUCCESS.");

用ant去给android进行打包时，发现apkbuilder找不到了，sdk更新3.0以后貌似apkbuilder已经被删除了，并且一些命令的目录也换了。下面就说一下怎么在没有apkbuilder的情况下生成apk文件，其实apkbuilder是一个批处理文件，打开里面就能发现，其实他内部执行的是sdklib.jar里面的一个class，所以就知道怎么做了，很简单，我们自己直接去调用java去执行这个类，如下：

< java classpath="${android.tools}/lib/sdklib.jar" classname="com.android.sdklib.build.ApkBuilderMain"> < arg value="https://www.songbingjia.com/android/${path.build.main}/bin/unsigned.apk" /> < arg value="https://www.songbingjia.com/android/-u" /> < arg value="https://www.songbingjia.com/android/-z" /> < arg value="https://www.songbingjia.com/android/${path.build.main}/bin/res.zip" /> < arg value="https://www.songbingjia.com/android/-f" /> < arg value="https://www.songbingjia.com/android/${path.build.main}/bin/classes.dex" /> < arg value="https://www.songbingjia.com/android/-rf" /> < arg value="https://www.songbingjia.com/android/${path.build.main}/src" /> < arg value="https://www.songbingjia.com/android/-rj"/> < arg value="https://www.songbingjia.com/android/${path.build.main}/libs"/> < arg value="https://www.songbingjia.com/android/-nf"/> < arg value="https://www.songbingjia.com/android/${path.build.native}"/> < /java>

其实以前的apkbuilder.bat内部也是执行的