一般咱們習慣用eclipse來開發Android程序,它會自動幫咱們打包當前的應用程序。若是在Navigator視圖下,咱們能夠看到如下幾個文件: java
在上圖中,com包放置的是咱們的class文件,classes.dex是class文件通過轉換後的能夠在dalvik上跑的精簡類文件,resources.ap_是通過打包的資源文件,ant.apk就是最終的打包文件。 linux
使用ANT來對應用打包,通常會通過如下幾個步驟: android
1.用aapt命令生成R.java文件 windows
2.用aidl命令生成相應java文件 api
3.用javac命令編譯java源文件生成class文件 app
4.用dx.bat將class文件轉換成classes.dex文件 框架
5.用aapt命令生成資源包文件resources.ap_ eclipse
6.用apkbuilder.bat打包資源和classes.dex文件,生成unsigned.apk ui
7.用jarsinger命令對apk認證,生成signed.apk google
爲了便於理解和記憶,下面來用一張流程圖來講明以上的幾個過程:
以上就是總體的流程,下面咱們就對其每一個部分進行作出詳細講解,把每個步驟都弄清楚了。
咱們須要先熟悉一下每個步驟所使用到的命令:
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:
首先咱們須要定義大量的變量屬性,用來表示使用到的路徑、目錄等,以下:
01 |
<projectname="ant"default="release"> |
03 |
<propertyenvironment="env"/> |
05 |
<propertyname="appName"value="${ant.project.name}"/> |
06 |
<!-- SDK目錄(獲取操做系統環境變量ANDROID_SDK_HOME的值) --> |
07 |
<propertyname="sdk-folder"value="${env.ANDROID_SDK_HOME}"/> |
09 |
<propertyname="sdk-platform-folder"value="${sdk-folder}/platforms/android-8"/> |
11 |
<propertyname="sdk-tools"value="${sdk-folder}/tools"/> |
12 |
<!-- SDK指定平臺中tools目錄 --> |
13 |
<propertyname="sdk-platform-tools"value="${sdk-platform-folder}/tools"/> |
15 |
<!-- 使用到的命令(當前系統爲windows,若是系統爲linux,可將.bat文件替換成相對應的命令) --> |
16 |
<propertyname="aapt"value="${sdk-platform-tools}/aapt"/> |
17 |
<propertyname="aidl"value="${sdk-platform-tools}/aidl"/> |
18 |
<propertyname="dx"value="${sdk-platform-tools}/dx.bat"/> |
19 |
<propertyname="apkbuilder"value="${sdk-tools}/apkbuilder.bat"/> |
20 |
<propertyname="jarsigner"value="${env.JAVA_HOME}/bin/jarsigner"/> |
22 |
<!-- 編譯須要的jar; 若是項目使用到地圖服務則須要maps.jar --> |
23 |
<propertyname="android-jar"value="${sdk-platform-folder}/android.jar"/> |
24 |
<propertyname="android-maps-jar"value="${sdk-folder}/add-ons/addon_google_apis_google_inc_8/libs/maps.jar"/> |
26 |
<!-- 編譯aidl文件所需的預處理框架文件framework.aidl --> |
27 |
<propertyname="framework-aidl"value="${sdk-platform-folder}/framework.aidl"/> |
30 |
<propertyname="outdir-gen"value="gen"/> |
32 |
<propertyname="outdir-bin"value="bin"/> |
35 |
<propertyname="manifest-xml"value="AndroidManifest.xml"/> |
37 |
<propertyname="resource-dir"value="res"/> |
38 |
<propertyname="asset-dir"value="assets"/> |
40 |
<propertyname="srcdir"value="src"/> |
41 |
<propertyname="srcdir-ospath"value="${basedir}/${srcdir}"/> |
43 |
<propertyname="external-lib"value="lib"/> |
44 |
<propertyname="external-lib-ospath"value="${basedir}/${external-lib}"/> |
47 |
<propertyname="outdir-classes"value="${outdir-bin}"/> |
48 |
<propertyname="outdir-classes-ospath"value="${basedir}/${outdir-classes}"/> |
50 |
<!-- classes.dex相關變量 --> |
51 |
<propertyname="dex-file"value="classes.dex"/> |
52 |
<propertyname="dex-path"value="${outdir-bin}/${dex-file}"/> |
53 |
<propertyname="dex-ospath"value="${basedir}/${dex-path}"/> |
55 |
<!-- 通過aapt生成的資源包文件 --> |
56 |
<propertyname="resources-package"value="${outdir-bin}/resources.ap_"/> |
57 |
<propertyname="resources-package-ospath"value="${basedir}/${resources-package}"/> |
60 |
<propertyname="out-unsigned-package"value="${outdir-bin}/${appName}-unsigned.apk"/> |
61 |
<propertyname="out-unsigned-package-ospath"value="${basedir}/${out-unsigned-package}"/> |
64 |
<propertyname="keystore-file"value="${basedir}/release.keystore"/> |
67 |
<propertyname="out-signed-package"value="${outdir-bin}/${appName}.apk"/> |
68 |
<propertyname="out-signed-package-ospath"value="${basedir}/${out-signed-package}"/> |
而後,咱們分步驟來進行,首先是初始化:
3 |
<echo>Initializing all output directories...</echo> |
4 |
<deletedir="${outdir-bin}"/> |
5 |
<mkdirdir="${outdir-bin}"/> |
6 |
<mkdirdir="${outdir-classes}"/> |
其次是生成R.java文件:
01 |
<!-- 根據工程中的資源文件生成R.java文件 --> |
02 |
<targetname="gen-R"depends="init"> |
03 |
<echo>Generating R.java from the resources...</echo> |
04 |
<execexecutable="${aapt}"failonerror="true"> |
09 |
<argvalue="${outdir-gen}"/> |
11 |
<argvalue="${resource-dir}"/> |
13 |
<argvalue="${manifest-xml}"/> |
15 |
<argvalue="${android-jar}"/> |
接着是aidl生成java源文件:
02 |
<targetname="aidl"depends="gen-R"> |
03 |
<echo>Compiling .aidl into java files...</echo> |
04 |
<applyexecutable="${aidl}"failonerror="true"> |
06 |
<argvalue="-p${framework-aidl}"/> |
08 |
<argvalue="-I${srcdir}"/> |
10 |
<argvalue="-o${outdir-gen}"/> |
12 |
<filesetdir="${srcdir}"> |
13 |
<includename="**/*.aidl"/> |
咱們指定了一個framework.aidl,裏面定義了不少android內置對象,而後咱們指定了aidl所在目錄和輸出目錄,組後指定編譯後綴爲aidl的文件。
接下來是將源文件編譯成class文件:
01 |
<!-- 將工程中的java源文件編譯成class文件 --> |
02 |
<targetname="compile"depends="aidl"> |
03 |
<echo>Compiling java source code...</echo> |
04 |
<javacencoding="utf-8"target="1.5"srcdir="."destdir="${outdir-classes}"bootclasspath="${android-jar}"> |
06 |
<filesetdir="${external-lib}"includes="*.jar"/> |
08 |
<filename="${android-maps-jar}"/> |
若是使用到了第三方類庫,咱們能夠在classpath標籤下配置。
接着是將class文件轉換成classes.dex:
01 |
<!-- 將.class文件轉化成.dex文件 --> |
02 |
<targetname="dex"depends="compile"> |
03 |
<echo>Converting compiled files and external libraries into a .dex file...</echo> |
04 |
<execexecutable="${dx}"failonerror="true"> |
07 |
<argvalue="--output=${dex-ospath}"/> |
08 |
<!-- 要生成.dex文件的源classes和libraries --> |
09 |
<argvalue="${outdir-classes-ospath}"/> |
10 |
<argvalue="${external-lib-ospath}"/> |
就像上面的代碼同樣,若是使用到第三方類庫,能夠在最後一參數的形式追加進去。
而後是將資源文件打包:
02 |
<targetname="package-res-and-assets"> |
03 |
<echo>Packaging resources and assets...</echo> |
04 |
<execexecutable="${aapt}"failonerror="true"> |
08 |
<argvalue="${manifest-xml}"/> |
10 |
<argvalue="${resource-dir}"/> |
12 |
<argvalue="${asset-dir}"/> |
14 |
<argvalue="${android-jar}"/> |
16 |
<argvalue="${resources-package}"/> |
接着是打包成未簽證的apk包:
02 |
<targetname="package"depends="dex, package-res-and-assets"> |
03 |
<echo>Packaging unsigned apk for release...</echo> |
04 |
<execexecutable="${apkbuilder}"failonerror="true"> |
05 |
<argvalue="${out-unsigned-package-ospath}"/> |
08 |
<argvalue="${resources-package-ospath}"/> |
10 |
<argvalue="${dex-ospath}"/> |
12 |
<argvalue="${srcdir-ospath}"/> |
14 |
<echo>It will need to be signed with jarsigner before being published.</echo> |
而後是對apk簽證:
02 |
<targetname="jarsigner"depends="package"> |
03 |
<echo>Packaging signed apk for release...</echo> |
04 |
<execexecutable="${jarsigner}"failonerror="true"> |
05 |
<argvalue="-keystore"/> |
06 |
<argvalue="${keystore-file}"/> |
07 |
<argvalue="-storepass"/> |
09 |
<argvalue="-keypass"/> |
11 |
<argvalue="-signedjar"/> |
12 |
<argvalue="${out-signed-package-ospath}"/> |
13 |
<argvalue="${out-unsigned-package-ospath}"/> |
最後發佈:
2 |
<targetname="release"depends="jarsigner"> |
4 |
<deletefile="${out-unsigned-package-ospath}"/> |
5 |
<echo>APK is released. path:${out-signed-package-ospath}</echo> |
這樣就完成了build.xml的編輯,eclipse繼承了ANT,因此咱們能夠在eclipse中直接運行,也能夠在代碼中調用。
首先咱們須要下載ANT,而後配置相應的環境變量信息,最後咱們這樣調用:
1 |
Process p = Runtime.getRuntime().exec("ant.bat -buildfile d:/workspace/ant/build.xml"); |
2 |
InputStream is = p.getInputStream(); |
3 |
BufferedReader br =newBufferedReader(newInputStreamReader(is)); |
5 |
while((line = br.readLine()) !=null) { |
6 |
System.out.println(line); |
8 |
System.out.println("SUCCESS."); |
全文完!