Ant打包

一般咱們習慣用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.");