使用ANT打包Android应用

大家好,今天来分享一下如何使用ANT打包Android应用。

通常我们习惯用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 强制覆盖

-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:

首先我们需要定义大量的变量属性,用来表示使用到的路径、目录等,如下:

[html] view plaincopy

  1. <project name="ant" default="release">
  2. <!-- ANT环境变量 -->
  3. <property environment="env" />
  4. <!-- 应用名称 -->
  5. <property name="appName" value="${ant.project.name}"/>
  6. <!-- SDK目录(获取操作系统环境变量ANDROID_SDK_HOME的值) -->
  7. <property name="sdk-folder" value="${env.ANDROID_SDK_HOME}" />
  8. <!-- SDK指定平台目录 -->
  9. <property name="sdk-platform-folder" value="${sdk-folder}/platforms/android-8"/>
  10. <!-- SDK中tools目录 -->
  11. <property name="sdk-tools" value="${sdk-folder}/tools" />
  12. <!-- SDK指定平台中tools目录 -->
  13. <property name="sdk-platform-tools" value="${sdk-platform-folder}/tools" />
  14. <!-- 使用到的命令(当前系统为windows,如果系统为linux,可将.bat文件替换成相对应的命令) -->
  15. <property name="aapt" value="${sdk-platform-tools}/aapt" />
  16. <property name="aidl" value="${sdk-platform-tools}/aidl" />
  17. <property name="dx" value="${sdk-platform-tools}/dx.bat" />
  18. <property name="apkbuilder" value="${sdk-tools}/apkbuilder.bat" />
  19. <property name="jarsigner" value="${env.JAVA_HOME}/bin/jarsigner" />
  20. <!-- 编译需要的jar; 如果项目使用到地图服务则需要maps.jar -->
  21. <property name="android-jar" value="${sdk-platform-folder}/android.jar" />
  22. <property name="android-maps-jar" value="${sdk-folder}/add-ons/addon_google_apis_google_inc_8/libs/maps.jar"/>
  23. <!-- 编译aidl文件所需的预处理框架文件framework.aidl -->
  24. <property name="framework-aidl" value="${sdk-platform-folder}/framework.aidl" />
  25. <!-- 生成R文件的相对目录 -->
  26. <property name="outdir-gen" value="gen" />
  27. <!-- 编译后的文件放置目录 -->
  28. <property name="outdir-bin" value="bin" />
  29. <!-- 清单文件 -->
  30. <property name="manifest-xml" value="AndroidManifest.xml" />
  31. <!-- 源文件目录 -->
  32. <property name="resource-dir" value="res" />
  33. <property name="asset-dir" value="assets" />
  34. <!-- java源文件目录 -->
  35. <property name="srcdir" value="src" />
  36. <property name="srcdir-ospath" value="${basedir}/${srcdir}" />
  37. <!-- 外部类库所在目录 -->
  38. <property name="external-lib" value="lib" />
  39. <property name="external-lib-ospath" value="${basedir}/${external-lib}" />
  40. <!-- 生成class目录 -->
  41. <property name="outdir-classes" value="${outdir-bin}" />
  42. <property name="outdir-classes-ospath" value="${basedir}/${outdir-classes}" />
  43. <!-- classes.dex相关变量 -->
  44. <property name="dex-file" value="classes.dex" />
  45. <property name="dex-path" value="${outdir-bin}/${dex-file}" />
  46. <property name="dex-ospath" value="${basedir}/${dex-path}" />
  47. <!-- 经过aapt生成的资源包文件 -->
  48. <property name="resources-package" value="${outdir-bin}/resources.ap_" />
  49. <property name="resources-package-ospath" value="${basedir}/${resources-package}" />
  50. <!-- 未认证apk包 -->
  51. <property name="out-unsigned-package" value="${outdir-bin}/${appName}-unsigned.apk" />
  52. <property name="out-unsigned-package-ospath" value="${basedir}/${out-unsigned-package}" />
  53. <!-- 证书文件 -->
  54. <property name="keystore-file" value="${basedir}/release.keystore" />
  55. <!-- 已认证apk包 -->
  56. <property name="out-signed-package" value="${outdir-bin}/${appName}.apk" />
  57. <property name="out-signed-package-ospath" value="${basedir}/${out-signed-package}" />
  58. ...
  59. </project>

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

[html] view plaincopy

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

其次是生成R.java文件:

[html] view plaincopy

  1. <!-- 根据工程中的资源文件生成R.java文件  -->
  2. <target name="gen-R" depends="init">
  3. <echo>Generating R.java from the resources...</echo>
  4. <exec executable="${aapt}" failonerror="true">
  5. <arg value="package" />
  6. <arg value="-f" />
  7. <arg value="-m" />
  8. <arg value="-J" />
  9. <arg value="${outdir-gen}" />
  10. <arg value="-S" />
  11. <arg value="${resource-dir}" />
  12. <arg value="-M" />
  13. <arg value="${manifest-xml}" />
  14. <arg value="-I" />
  15. <arg value="${android-jar}" />
  16. </exec>
  17. </target>

接着是aidl生成java源文件:

[html] view plaincopy

  1. <!-- 编译aidl文件 -->
  2. <target name="aidl" depends="gen-R">
  3. <echo>Compiling .aidl into java files...</echo>
  4. <apply executable="${aidl}" failonerror="true">
  5. <!-- 指定预处理文件 -->
  6. <arg value="-p${framework-aidl}"/>
  7. <!-- aidl声明的目录 -->
  8. <arg value="-I${srcdir}"/>
  9. <!-- 目标文件目录 -->
  10. <arg value="-o${outdir-gen}"/>
  11. <!-- 指定哪些文件需要编译 -->
  12. <fileset dir="${srcdir}">
  13. <include name="**/*.aidl"/>
  14. </fileset>
  15. </apply>
  16. </target>

我们指定了一个framework.aidl,里面定义了很多android内置对象,然后我们指定了aidl所在目录和输出目录,组后指定编译后缀为aidl的文件。

接下来是将源文件编译成class文件:

[html] view plaincopy

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

如果使用到了第三方类库,我们可以在classpath标签下配置。

接着是将class文件转换成classes.dex:

[html] view plaincopy

  1. <!-- 将.class文件转化成.dex文件 -->
  2. <target name="dex" depends="compile">
  3. <echo>Converting compiled files and external libraries into a .dex file...</echo>
  4. <exec executable="${dx}" failonerror="true">
  5. <arg value="--dex" />
  6. <!-- 输出文件 -->
  7. <arg value="--output=${dex-ospath}" />
  8. <!-- 要生成.dex文件的源classes和libraries -->
  9. <arg value="${outdir-classes-ospath}" />
  10. <arg value="${external-lib-ospath}"/>
  11. </exec>
  12. </target>

就像上面的代码一样,如果使用到第三方类库,可以在最后一参数的形式追加进去。

然后是将资源文件打包:

[html] view plaincopy

  1. <!-- 将资源文件放进输出目录 -->
  2. <target name="package-res-and-assets">
  3. <echo>Packaging resources and assets...</echo>
  4. <exec executable="${aapt}" failonerror="true">
  5. <arg value="package" />
  6. <arg value="-f" />
  7. <arg value="-M" />
  8. <arg value="${manifest-xml}" />
  9. <arg value="-S" />
  10. <arg value="${resource-dir}" />
  11. <arg value="-A" />
  12. <arg value="${asset-dir}" />
  13. <arg value="-I" />
  14. <arg value="${android-jar}" />
  15. <arg value="-F" />
  16. <arg value="${resources-package}" />
  17. </exec>
  18. </target>

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

[html] view plaincopy

  1. <!-- 打包成未签证的apk -->
  2. <target name="package" depends="dex, package-res-and-assets">
  3. <echo>Packaging unsigned apk for release...</echo>
  4. <exec executable="${apkbuilder}" failonerror="true">
  5. <arg value="${out-unsigned-package-ospath}" />
  6. <arg value="-u" />
  7. <arg value="-z" />
  8. <arg value="${resources-package-ospath}" />
  9. <arg value="-f" />
  10. <arg value="${dex-ospath}" />
  11. <arg value="-rf" />
  12. <arg value="${srcdir-ospath}" />
  13. </exec>
  14. <echo>It will need to be signed with jarsigner before being published.</echo>
  15. </target>

然后是对apk签证:

[html] view plaincopy

  1. <!-- 对apk进行签证 -->
  2. <target name="jarsigner" depends="package">
  3. <echo>Packaging signed apk for release...</echo>
  4. <exec executable="${jarsigner}" failonerror="true">
  5. <arg value="-keystore" />
  6. <arg value="${keystore-file}" />
  7. <arg value="-storepass" />
  8. <arg value="123456" />
  9. <arg value="-keypass" />
  10. <arg value="123456" />
  11. <arg value="-signedjar" />
  12. <arg value="${out-signed-package-ospath}" />
  13. <arg value="${out-unsigned-package-ospath}"/>
  14. <!-- 不要忘了证书的别名 -->
  15. <arg value="release"/>
  16. </exec>
  17. </target>

最后发布:

[html] view plaincopy

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

这样就完成了build.xml的编辑,eclipse继承了ANT,所以我们可以在eclipse中直接运行,也可以在代码中调用。

首先我们需要下载ANT,然后配置相应的环境变量信息,最后我们这样调用:

[java] view plaincopy

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

就先讲到这里吧,谢谢大家。

时间: 2024-08-06 15:43:47

使用ANT打包Android应用的相关文章

使用Ant打包Android应用具体解释

计划写个完整的使用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 一.简单应用出包流

使用Ant打包Android应用具体解释——Ant使用解析

上篇<使用Ant打包Android应用具体解释>描写叙述了使用Ant打包的流程,但非常多步骤并没有说明如此做的原因,本篇将从Ant方面来理解,下一篇从APK生成的流程来说明. APK包的生成是一系列操作的结果,而Ant则是将这一系列操作流程化.提供出定制化的接口,以及可配置的參数供改动,而这些都是通过指定的构建文件来实现. 我们就从Ant的打包流程来理解Ant的一些基本使用方法. 当在命令行中运行ant.默认会去解析当前文件夹的build.xml作为构建文件.以下是个删除部分注视的版本号: &

使用Ant打包Android应用详解——Ant使用解析

上篇<使用Ant打包Android应用详解>描述了使用Ant打包的流程,但很多步骤并没有说明如此做的原因,本篇将从Ant方面来理解,下一篇从APK生成的流程来说明. APK包的生成是一系列操作的结果,而Ant则是将这一系列操作流程化,提供出定制化的接口,以及可配置的参数供修改,而这些都是通过指定的构建文件来实现.我们就从Ant的打包流程来理解Ant的一些基本用法.当在命令行中执行ant,默认会去解析当前目录的build.xml作为构建文件.下面是个删除部分注视的版本: <project

使用Ant打包Android应用详解

计划写个完整的使用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 一.简单应用出包流程

Ant打包Android代码生成apk文件

可參考下面,实现一套代码不同渠道的打包 http://blog.csdn.net/liuhe688/article/details/6679879 http://cnn237111.blog.51cto.com/2359144/1130502 http://www.cnblogs.com/hoojo/p/ant_increment_svn_diff_diffsummarize.html http://www.eoeandroid.com/thread-323111-1-1.html http:/

使用Ant批量打包Android应用完全指南

本文章由Socks完成,博客地址:http://blog.csdn.net/zhaokaiqiang1992 转载请说明! 折腾了一下午,百度了一下午,终于实现了使用Ant对Android应用的批量打包,也算是了却了我的一桩心事.虽然网上的这部分教程也有,但是感觉写的不是详细.更为重要的是,各种方法之间的差异比较大,对于新手来说,各种方法之间的选择是极为痛苦的,一个方法一个方法的去实验,是很浪费时间的.因此,我想给大家提供一套完整的,详细的Ant打包Android应用的教程,方便大家的学习和以后

【Android开发经验】使用Ant批量打包Android应用全然指南

本文章由Socks完毕.博客地址:http://blog.csdn.net/zhaokaiqiang1992 转载请说明. 折腾了一下午.百度了一下午,最终实现了使用Ant对Android应用的批量打包,也算是了却了我的一桩心事.尽管网上的这部分教程也有,可是感觉写的不是具体. 更为重要的是.各种方法之间的差异比較大.对于新手来说.各种方法之间的选择是极为痛苦的,一个方法一个方法的去实验,是非常浪费时间的. 因此,我想给大家提供一套完整的,具体的Ant打包Android应用的教程,方便大家的学习

理解使用Gradle编译打包Android apk

本篇的目的:理解Gradle构建过程,解读Android Gradle插件的配置 阅读本文一定是要使用过Gradle生成apk,文中不会讲如何安装运行Gradle,如有需要可先看文末的参考文章. APK包是一个ZIP压缩包,从Java源代码.资源文件到生成这个APK,经过了编译打包一系列特定的过程,这个过程可以参看<使用Ant打包Android应用--apk生成过程>,也可以从自己的旧版SDK文档(/docs/tools/building/index.html)中找到.而这一系列特定的过程,重

Ant编译打包Android工程流程

一.Ant编译打包android工程步骤 二.Ant apk签名 1.keystore签名    定义自己的签名文件 生成keystore文件:keytool -genkey -alias android.keystore -keyalg RSA - validity 20000 -keystore android.keystore 对应的java命令:jarsigner -verbose -keystore android.keystore -signedjar android_signed.