使用ANT打包Android應用

yangxi_001發表於2014-03-18

大家好,今天來分享一下如何使用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 plaincopy
  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 plaincopy
  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 plaincopy
  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 plaincopy
  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 plaincopy
  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 plaincopy
  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 plaincopy
  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 plaincopy
  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 plaincopy
  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 plaincopy
  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 plaincopy
  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.");  

就先講到這裡吧,謝謝大家。

相關文章