使用ANT打包Android应用
大家好,今天來分享一下如何使用ANT打包Android應(yīng)用。
通常我們習(xí)慣用eclipse來開發(fā)Android程序,它會自動幫我們打包當(dāng)前的應(yīng)用程序。如果在Navigator視圖下,我們可以看到以下幾個文件:
在上圖中,com包放置的是我們的class文件,classes.dex是class文件經(jīng)過轉(zhuǎn)換后的可以在dalvik上跑的精簡類文件,resources.ap_是經(jīng)過打包的資源文件,ant.apk就是最終的打包文件。
使用ANT來對應(yīng)用打包,一般會經(jīng)過以下幾個步驟:
1.用aapt命令生成R.java文件
2.用aidl命令生成相應(yīng)java文件
3.用javac命令編譯java源文件生成class文件
4.用dx.bat將class文件轉(zhuǎn)換成classes.dex文件
5.用aapt命令生成資源包文件resources.ap_
6.用apkbuilder.bat打包資源和classes.dex文件,生成unsigned.apk
7.用jarsinger命令對apk認(rèn)證,生成signed.apk
為了便于理解和記憶,下面來用一張流程圖來說明以上的幾個過程:
以上就是整體的流程,下面我們就對其每個部分進行做出詳細(xì)講解,把每一個步驟都弄清楚了。
我們需要先熟悉一下每一個步驟所使用到的命令:
1.aapt(Android Asset Packaging Tool)命令,根據(jù)資源文件生成R.java文件
參數(shù)說明:
-f ?強制覆蓋已存在的文件。
-m ?在-J指定的位置下自動生成相應(yīng)的包的目錄。
-J ?指定R.java文件生成的目錄。
-S ?指定資源目錄。
-M ?指定清單文件。
-I ?引入類庫。
注意,我們當(dāng)前所在的位置是ant項目根目錄,所以必要時需要輸入很多關(guān)于命令的路徑,以下示例也是一樣。
2.aidl(Android Interface Definition Language)命令,根據(jù).aidl定義文件生成java文件
上面的示例所在位置為com/scott/ant下,根據(jù)包中的Person.aidl文件,在gen對應(yīng)的目錄中生成Person.java文件,示例中只是處理單一文件,下文中會講述如何處理目錄中的多個aidl文件。
3.javac(Java Compiler)命令,根據(jù)源文件生成對應(yīng)的class文件
參數(shù)說明:
-d <目錄> ? ? ?指定存放生成的類文件的位置
-bootclasspath <路徑> ? ? 覆蓋引導(dǎo)類文件的位置
示例中并沒有考慮到引用類路徑下面的類庫,復(fù)雜的情況會在稍后遇到的。
4.dx命令,將class文件轉(zhuǎn)換成.dex文件
以上示例是將bin目錄下的class文件轉(zhuǎn)換成classes.dex文件,輸出到bin目錄,我們也許會用到第三方類庫,等一會就會看到。
5.aapt將資源文件打包
參數(shù)說明:
-f 強制覆蓋
-M 指定Manifest文件
-S 指定資源目錄
-A 指定資產(chǎn)目錄
-I 指定引入的類庫
-F 指定要生成的包
6.apkbuilder命令,根據(jù)classes.dex文件和resources.ap_生成為簽證的apk包
參數(shù)說明:
-rf 參照源文件的目錄的結(jié)構(gòu)
7.jarsigner命令,對上面生成的apk包進行簽證
在簽證的過程中,需要使用到證書文件,需要注意的是最后的release是證書的別名,關(guān)于如何創(chuàng)建證書,請看下圖:
當(dāng)然也可以在eclipse里使用ADT提供的圖形界面完成以上步驟,選中項目,點擊右鍵,“Android Tools=>Export Signed Application Package”,然后再其中的Keystore selection環(huán)節(jié)選擇“Create new keystore”,然后按照提示填寫信息就可以了。
以上是我們使用到的命令,接下來我們就該來分析一下ANT所必須的build.xml:
首先我們需要定義大量的變量屬性,用來表示使用到的路徑、目錄等,如下:
<project name="ant" default="release"><!-- ANT環(huán)境變量 --><property environment="env" /><!-- 應(yīng)用名稱 --><property name="appName" value="${ant.project.name}"/><!-- SDK目錄(獲取操作系統(tǒng)環(huán)境變量ANDROID_SDK_HOME的值) --><property name="sdk-folder" value="${env.ANDROID_SDK_HOME}" /><!-- SDK指定平臺目錄 --><property name="sdk-platform-folder" value="${sdk-folder}/platforms/android-8"/><!-- SDK中tools目錄 --><property name="sdk-tools" value="${sdk-folder}/tools" /><!-- SDK指定平臺中tools目錄 --><property name="sdk-platform-tools" value="${sdk-platform-folder}/tools" /><!-- 使用到的命令(當(dāng)前系統(tǒng)為windows,如果系統(tǒng)為linux,可將.bat文件替換成相對應(yīng)的命令) --><property name="aapt" value="${sdk-platform-tools}/aapt" /><property name="aidl" value="${sdk-platform-tools}/aidl" /><property name="dx" value="${sdk-platform-tools}/dx.bat" /><property name="apkbuilder" value="${sdk-tools}/apkbuilder.bat" /><property name="jarsigner" value="${env.JAVA_HOME}/bin/jarsigner" /><!-- 編譯需要的jar; 如果項目使用到地圖服務(wù)則需要maps.jar --><property name="android-jar" value="${sdk-platform-folder}/android.jar" /><property name="android-maps-jar" value="${sdk-folder}/add-ons/addon_google_apis_google_inc_8/libs/maps.jar"/><!-- 編譯aidl文件所需的預(yù)處理框架文件framework.aidl --><property name="framework-aidl" value="${sdk-platform-folder}/framework.aidl" /><!-- 生成R文件的相對目錄 --><property name="outdir-gen" value="gen" /><!-- 編譯后的文件放置目錄 --><property name="outdir-bin" value="bin" /><!-- 清單文件 --><property name="manifest-xml" value="AndroidManifest.xml" /><!-- 源文件目錄 --><property name="resource-dir" value="res" /><property name="asset-dir" value="assets" /><!-- java源文件目錄 --><property name="srcdir" value="src" /><property name="srcdir-ospath" value="${basedir}/${srcdir}" /><!-- 外部類庫所在目錄 --><property name="external-lib" value="lib" /><property name="external-lib-ospath" value="${basedir}/${external-lib}" /><!-- 生成class目錄 --><property name="outdir-classes" value="${outdir-bin}" /><property name="outdir-classes-ospath" value="${basedir}/${outdir-classes}" /><!-- classes.dex相關(guān)變量 --><property name="dex-file" value="classes.dex" /><property name="dex-path" value="${outdir-bin}/${dex-file}" /><property name="dex-ospath" value="${basedir}/${dex-path}" /><!-- 經(jīng)過aapt生成的資源包文件 --><property name="resources-package" value="${outdir-bin}/resources.ap_" /><property name="resources-package-ospath" value="${basedir}/${resources-package}" /><!-- 未認(rèn)證apk包 --><property name="out-unsigned-package" value="${outdir-bin}/${appName}-unsigned.apk" /><property name="out-unsigned-package-ospath" value="${basedir}/${out-unsigned-package}" /><!-- 證書文件 --><property name="keystore-file" value="${basedir}/release.keystore" /><!-- 已認(rèn)證apk包 --><property name="out-signed-package" value="${outdir-bin}/${appName}.apk" /><property name="out-signed-package-ospath" value="${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文件:
<!-- 根據(jù)工程中的資源文件生成R.java文件 --><target name="gen-R" depends="init"><echo>Generating R.java from the resources...</echo><exec executable="${aapt}" failonerror="true"><arg value="package" /><arg value="-f" /><arg value="-m" /><arg value="-J" /><arg value="${outdir-gen}" /><arg value="-S" /><arg value="${resource-dir}" /><arg value="-M" /><arg value="${manifest-xml}" /><arg value="-I" /><arg value="${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"><!-- 指定預(yù)處理文件 --><arg value="-p${framework-aidl}"/><!-- aidl聲明的目錄 --><arg value="-I${srcdir}"/><!-- 目標(biāo)文件目錄 --><arg value="-o${outdir-gen}"/><!-- 指定哪些文件需要編譯 --><fileset dir="${srcdir}"><include name="**/*.aidl"/></fileset></apply></target>我們指定了一個framework.aidl,里面定義了很多android內(nèi)置對象,然后我們指定了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標(biāo)簽下配置。
接著是將class文件轉(zhuǎn)換成classes.dex:
<!-- 將.class文件轉(zhuǎn)化成.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="--dex" /><!-- 輸出文件 --><arg value="--output=${dex-ospath}" /><!-- 要生成.dex文件的源classes和libraries --><arg value="${outdir-classes-ospath}" /><arg value="${external-lib-ospath}"/></exec></target>?
就像上面的代碼一樣,如果使用到第三方類庫,可以在最后一參數(shù)的形式追加進去。
然后是將資源文件打包:
<!-- 將資源文件放進輸出目錄 --><target name="package-res-and-assets"><echo>Packaging resources and assets...</echo><exec executable="${aapt}" failonerror="true"><arg value="package" /><arg value="-f" /><arg value="-M" /><arg value="${manifest-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>接著是打包成未簽證的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="${out-unsigned-package-ospath}" /><arg value="-u" /><arg value="-z" /><arg value="${resources-package-ospath}" /><arg value="-f" /><arg value="${dex-ospath}" /><arg value="-rf" /><arg value="${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="-keystore" /><arg value="${keystore-file}" /><arg value="-storepass" /><arg value="123456" /><arg value="-keypass" /><arg value="123456" /><arg value="-signedjar" /><arg value="${out-signed-package-ospath}" /><arg value="${out-unsigned-package-ospath}"/><!-- 不要忘了證書的別名 --><arg value="release"/></exec></target>最后發(fā)布:
<!-- 發(fā)布 --><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中直接運行,也可以在代碼中調(diào)用。
首先我們需要下載ANT,然后配置相應(yīng)的環(huán)境變量信息,最后我們這樣調(diào)用:
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.");?
?
轉(zhuǎn)自:http://blog.csdn.net/liuhe688/article/details/6679879
總結(jié)
以上是生活随笔為你收集整理的使用ANT打包Android应用的全部內(nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: Autodesk 首届中国开发者训练营将
- 下一篇: 华为JAVA编程规范