大家好,今天来分享一下如何使用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:
首先我们需要定义大量的变量属性,用来表示使用到的路径、目录等,如下:
然后,我们分步骤来进行,首先是初始化:
其次是生成R.java文件:
接着是aidl生成java源文件:
我们指定了一个framework.aidl,里面定义了很多android内置对象,然后我们指定了aidl所在目录和输出目录,组后指定编译后缀为aidl的文件。
接下来是将源文件编译成class文件:
如果使用到了第三方类库,我们可以在classpath标签下配置。
接着是将class文件转换成classes.dex:
就像上面的代码一样,如果使用到第三方类库,可以在最后一参数的形式追加进去。
然后是将资源文件打包:
接着是打包成未签证的apk包:
然后是对apk签证:
最后发布:
这样就完成了build.xml的编辑,eclipse继承了ANT,所以我们可以在eclipse中直接运行,也可以在代码中调用。
首先我们需要下载ANT,然后配置相应的环境变量信息,最后我们这样调用:
<?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>
就先讲到这里吧,谢谢大家。