使用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 plain copy
  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.   
  15.     <!-- 使用到的命令(当前系统为windows,如果系统为linux,可将.bat文件替换成相对应的命令) -->  
  16.     <property name="aapt" value="${sdk-platform-tools}/aapt" />  
  17.     <property name="aidl" value="${sdk-platform-tools}/aidl" />  
  18.     <property name="dx" value="${sdk-platform-tools}/dx.bat" />  
  19.     <property name="apkbuilder" value="${sdk-tools}/apkbuilder.bat" />  
  20.     <property name="jarsigner" value="${env.JAVA_HOME}/bin/jarsigner" />  
  21.       
  22.     <!-- 编译需要的jar; 如果项目使用到地图服务则需要maps.jar -->  
  23.     <property name="android-jar" value="${sdk-platform-folder}/android.jar" />  
  24.     <property name="android-maps-jar" value="${sdk-folder}/add-ons/addon_google_apis_google_inc_8/libs/maps.jar"/>  
  25.       
  26.     <!-- 编译aidl文件所需的预处理框架文件framework.aidl -->  
  27.     <property name="framework-aidl" value="${sdk-platform-folder}/framework.aidl" />  
  28.   
  29.     <!-- 生成R文件的相对目录 -->  
  30.     <property name="outdir-gen" value="gen" />  
  31.     <!-- 编译后的文件放置目录 -->  
  32.     <property name="outdir-bin" value="bin" />  
  33.       
  34.     <!-- 清单文件 -->  
  35.     <property name="manifest-xml" value="AndroidManifest.xml" />  
  36.     <!-- 源文件目录 -->  
  37.     <property name="resource-dir" value="res" />  
  38.     <property name="asset-dir" value="assets" />  
  39.     <!-- java源文件目录 -->  
  40.     <property name="srcdir" value="src" />  
  41.     <property name="srcdir-ospath" value="${basedir}/${srcdir}" />  
  42.     <!-- 外部类库所在目录 -->  
  43.     <property name="external-lib" value="lib" />  
  44.     <property name="external-lib-ospath" value="${basedir}/${external-lib}" />  
  45.   
  46.     <!-- 生成class目录 -->  
  47.     <property name="outdir-classes" value="${outdir-bin}" />  
  48.     <property name="outdir-classes-ospath" value="${basedir}/${outdir-classes}" />  
  49.   
  50.     <!-- classes.dex相关变量 -->  
  51.     <property name="dex-file" value="classes.dex" />  
  52.     <property name="dex-path" value="${outdir-bin}/${dex-file}" />  
  53.     <property name="dex-ospath" value="${basedir}/${dex-path}" />  
  54.   
  55.     <!-- 经过aapt生成的资源包文件 -->  
  56.     <property name="resources-package" value="${outdir-bin}/resources.ap_" />  
  57.     <property name="resources-package-ospath" value="${basedir}/${resources-package}" />  
  58.       
  59.     <!-- 未认证apk包 -->  
  60.     <property name="out-unsigned-package" value="${outdir-bin}/${appName}-unsigned.apk" />  
  61.     <property name="out-unsigned-package-ospath" value="${basedir}/${out-unsigned-package}" />  
  62.       
  63.     <!-- 证书文件 -->  
  64.     <property name="keystore-file" value="${basedir}/release.keystore" />  
  65.       
  66.     <!-- 已认证apk包 -->  
  67.     <property name="out-signed-package" value="${outdir-bin}/${appName}.apk" />  
  68.     <property name="out-signed-package-ospath" value="${basedir}/${out-signed-package}" />  
  69.         ...  
  70. </project>  

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

[html]  view plain copy
  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 plain copy
  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 plain copy
  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 plain copy
  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 plain copy
  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 plain copy
  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 plain copy
  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 plain copy
  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 plain copy
  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 plain copy
  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.");  


<?xml version="1.0" encoding="GBK"?>
<!-- 步骤 

	1.用aapt生成R.java

	2.JAVAC编译JAVA文件

	3.批处理生成classes.dex

	4.aapt打包资源 

	5.apkbuilder包资源和类文件为APK文件

	6.jarsinger 对APK进行签名-->

<project name="MyJbox2D" default="zipalign" basedir=".">

	<property file="local.properties" />

	<property name="jbox2dlib" value="D:/workspace/MyJbox2D/lib" />

	<!-- 定义自己的输出目录 -->

	<property name="outdir" value="outdir" />

	<property name="out.absolute.dir" location="${outdir}" />

	<!-- 定义 R.java 所有目录 -->

	<property name="outdir-gen" value="gen" />

	<!-- 读取目录 -->

	<property name="resource-dir" value="res" />

	<property name="asset-dir" value="assets" />

	<property name="src-dir" value="src" />

	<property name="src-dir-ospath" value="${basedir}/${src-dir}" />

	<!-- 输出目录 -->

	<property name="outdir-classes" value="${outdir}/classes" />

	<property name="out.classes.absolute.dir" location="${outdir-classes}" />

	<!-- 临时类资源文件 -->

	<property name="dex-file" value="classes.dex" />

	<property name="intermediate-dex" value="${out.absolute.dir}/${dex-file}" />

	<!-- 最终生成文件 -->

	<property name="out-package" value="${outdir}/${ant.project.name}.apk" />

	<!-- 要使用的工具 -->

	<property name="aapt" value="${sdk-platform-tools}/aapt.exe" />

	<property name="aidl" value="${sdk-platform-tools}/aidl.exe" />

	<property name="dx" value="${sdk-platform-tools}/dx.bat" />

	<property name="adb" value="${sdk-tools}/adb" />

	<property name="apk-builder" value="${sdk-tools}/apkbuilder.bat" />

	<property name="android-jar" value="${sdk-platform}/android.jar" />

	<!-- 最终生成各种包文件 -->

	<property name="resources-package" value="${outdir}/${ant.project.name}" />

	<property name="resources-package-ospath" value="${basedir}/${resources-package}" />

	<property name="out-unsigned-package" value="${outdir}/${ant.project.name}-unsigned.apk" />

	<property name="out-unsigned-package-ospath" value="${basedir}/${out-unsigned-package}" />

	<property name="out-signed-package" value="${outdir}/${ant.project.name}-signed.apk" />

	<property name="out-signed-package-ospath" value="${basedir}/${out-signed-package}" />

	<property name="zipalign-package-ospath" value="${basedir}/${outdir}/${ant.project.name}_release.apk" />


	<!--签名工具-->

	<property name="jarsigner" value="${jdk-home}/bin/jarsigner.exe" />

	<!--优化APK工具-->

	<property name="zipalign" value="${sdk-tools}/zipalign.exe" />

	<!-- 初始化 -->

	<target name="init">

		<echo>Creating all output directories </echo>

		<delete dir="${outdir}" />

		<delete dir="${outdir-classes}" />

		<delete dir="${outdir-gen}" />

		<mkdir dir="${outdir}" />

		<mkdir dir="${outdir-classes}" />

		<mkdir dir="${outdir-gen}" />

	</target>

	<!--步骤 1: aapt生成R.java -->

	<target name="resource-src" depends="init">

		<echo>Generating R.java...</echo>

		<exec executable="${aapt}" failοnerrοr="true">

			<arg value="package" />

			<arg value="-m" />

			<arg value="-J" />

			<arg value="${outdir-gen}" />

			<arg value="-M" />

			<arg value="AndroidManifest.xml" />

			<arg value="-S" />

			<arg value="${resource-dir}" />

			<arg value="-I" />

			<arg value="${android-jar}" />

		</exec>

	</target>

	<!-- Generate java classes from .aidl files. -->

	<target name="aidl" depends="init">

		<echo>Compiling aidl files into Java classes...</echo>

		<apply executable="${aidl}" failοnerrοr="true">

			<arg value="-p${android-framework}" />

			<arg value="-I${src-dir}" />

			<fileset dir="${src-dir}">

				<include name="**/*.aidl" />

			</fileset>

		</apply>

	</target>

	<!-- 步骤 2. 编译所有class文件. -->

	<target name="compile" depends="init, resource-src, aidl">

		<unjar src="${jbox2dlib}/jbox2d.jar" mce_src="${jbox2dlib}/jbox2d.jar" dest="${outdir-classes}" />

		<javac encoding="GBK" target="1.6" debug="true" extdirs="" srcdir="." destdir="${outdir-classes}" bootclasspath="${android-jar}" />

	</target>

	<!-- 混淆代码-->

	<target name="proguard" depends="compile">

		<jar basedir="${outdir-classes}" destfile="temp.jar" />

		<java jar="${proguard-home}/proguard.jar" fork="true" failοnerrοr="true">

			<jvmarg value="-Dmaximum.inlined.code.length=32" />

			<arg value="-injars temp.jar" />

			<arg value="-outjars optimized.jar" />

			<arg value="-libraryjars ${android-jar}" />

			<arg value="-dontpreverify" />

			<arg value="-dontoptimize" />

			<arg value="-dontusemixedcaseclassnames" />

			<arg value="-repackageclasses ''" />

			<arg value="-allowaccessmodification" />

			<!-- 要保留自己的主ACTIVITY类 -->

			<arg value="-keep public class com.jbox2d.demo.MyActivity" />

			<arg value="-optimizationpasses 7" />

			<arg value="-verbose" />

			<arg value="-dontskipnonpubliclibraryclasses" />

			<arg value="-dontskipnonpubliclibraryclassmembers" />

		</java>

		<delete file="temp.jar" />

		<delete dir="${outdir-classes}" />

		<mkdir dir="${outdir-classes}" />

		<unzip src="optimized.jar" mce_src="optimized.jar" dest="${outdir-classes}" />

		<delete file="optimized.jar" />

	</target>

	<!-- 步骤 3. 转换class文件为dex文件. -->

	<target name="dex" depends="proguard">

		<echo>Converting compiled files into ${intermediate-dex}... </echo>

		<exec executable="${dx}" failοnerrοr="true">

			<arg value="--dex" />

			<arg value="--output=${intermediate-dex}" />

			<arg path="${out.classes.absolute.dir}" />

		</exec>

	</target>

	<!-- 步骤 4. 将资源和清单打包. -->

	<target name="package-res-and-assets">

		<echo>Packaging resources and assets...</echo>

		<exec executable="${aapt}" failοnerrοr="true">

			<arg value="package" />

			<arg value="-f" />

			<arg value="-M" />

			<arg value="AndroidManifest.xml" />

			<arg value="-S" />

			<arg value="${resource-dir}" />

			<arg value="-A" />

			<arg value="${asset-dir}" />

			<arg value="-I" />

			<arg value="${android-jar}" />

			<arg value="-F" />

			<arg value="${resources-package}" />

		</exec>

	</target>

	<!-- 步骤 5. 将打好的包编译为APK文件. -->

	<target name="debug" depends="dex, package-res-and-assets">

		<echo>release:Packaging ${out-debug-package-ospath}, and signing it with a debug key...</echo>

		<exec executable="${apk-builder}" failοnerrοr="true">

			<arg value="${out-unsigned-package-ospath}" />

			<arg value="-u" />

			<arg value="-z" />

			<arg value="${resources-package-ospath}" />

			<arg value="-f" />

			<arg value="${intermediate-dex}" />

			<arg value="-rf" />

			<arg value="${src-dir-ospath}" />

		</exec>

	</target>

	<!--步骤 6. 签名APK文件 -->

	<target name="jarsigner" depends="debug">

		<echo> jarsigner ${out-signed-package-ospath}</echo>

		<exec executable="${jarsigner}" failοnerrοr="true">

			<arg value="-verbose" />

			<arg value="-storepass" />

			<arg value="${keypass}" />

			<arg value="-keystore" />

			<arg value="${keystore}" />

			<arg value="-signedjar" />

			<arg value="${out-signed-package-ospath}" />

			<arg value="${out-unsigned-package-ospath}" />

			<arg value="${key}" />

		</exec>

	</target>

	<!--zipalign优化android程序-->

	<target name="zipalign" depends="jarsigner">

		<echo> zipalign ${zipalign-package-ospath}</echo>

		<exec executable="${zipalign}" failοnerrοr="true">

			<arg value="-v" />

			<arg value="-f" />

			<arg value="4" />

			<arg value="${out-signed-package-ospath}" />

			<arg value="${zipalign-package-ospath}" />

		</exec>

	</target>

	<!-- 安装到默认的手机或模拟器-->

	<target name="install" depends="zipalign">

		<echo>Installing ${out-debug-package} onto default emulator...</echo>

		<exec executable="${adb}" failοnerrοr="true">

			<arg value="install" />

			<arg value="${out-signed-package}" />

		</exec>

	</target>

</project>


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

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值