使用 Ant 打包 Android 應用

一般咱們習慣用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">
02    <!-- ANT環境變量 -->
03    <propertyenvironment="env"/>
04    <!-- 應用名稱 -->
05    <propertyname="appName"value="${ant.project.name}"/>
06    <!-- SDK目錄(獲取操做系統環境變量ANDROID_SDK_HOME的值) -->
07    <propertyname="sdk-folder"value="${env.ANDROID_SDK_HOME}"/>
08    <!-- SDK指定平臺目錄 -->
09    <propertyname="sdk-platform-folder"value="${sdk-folder}/platforms/android-8"/>
10    <!-- SDK中tools目錄 -->
11    <propertyname="sdk-tools"value="${sdk-folder}/tools"/>
12    <!-- SDK指定平臺中tools目錄 -->
13    <propertyname="sdk-platform-tools"value="${sdk-platform-folder}/tools"/>
14
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"/>
21    
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"/>
25    
26    <!-- 編譯aidl文件所需的預處理框架文件framework.aidl -->
27    <propertyname="framework-aidl"value="${sdk-platform-folder}/framework.aidl"/>
28
29    <!-- 生成R文件的相對目錄 -->
30    <propertyname="outdir-gen"value="gen"/>
31    <!-- 編譯後的文件放置目錄 -->
32    <propertyname="outdir-bin"value="bin"/>
33    
34    <!-- 清單文件 -->
35    <propertyname="manifest-xml"value="AndroidManifest.xml"/>
36    <!-- 源文件目錄 -->
37    <propertyname="resource-dir"value="res"/>
38    <propertyname="asset-dir"value="assets"/>
39    <!-- java源文件目錄 -->
40    <propertyname="srcdir"value="src"/>
41    <propertyname="srcdir-ospath"value="${basedir}/${srcdir}"/>
42    <!-- 外部類庫所在目錄 -->
43    <propertyname="external-lib"value="lib"/>
44    <propertyname="external-lib-ospath"value="${basedir}/${external-lib}"/>
45
46    <!-- 生成class目錄 -->
47    <propertyname="outdir-classes"value="${outdir-bin}"/>
48    <propertyname="outdir-classes-ospath"value="${basedir}/${outdir-classes}"/>
49
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}"/>
54
55    <!-- 通過aapt生成的資源包文件 -->
56    <propertyname="resources-package"value="${outdir-bin}/resources.ap_"/>
57    <propertyname="resources-package-ospath"value="${basedir}/${resources-package}"/>
58    
59    <!-- 未認證apk包 -->
60    <propertyname="out-unsigned-package"value="${outdir-bin}/${appName}-unsigned.apk"/>
61    <propertyname="out-unsigned-package-ospath"value="${basedir}/${out-unsigned-package}"/>
62    
63    <!-- 證書文件 -->
64    <propertyname="keystore-file"value="${basedir}/release.keystore"/>
65    
66    <!-- 已認證apk包 -->
67    <propertyname="out-signed-package"value="${outdir-bin}/${appName}.apk"/>
68    <propertyname="out-signed-package-ospath"value="${basedir}/${out-signed-package}"/>
69        ...
70 </project>
而後,咱們分步驟來進行,首先是初始化:
1 <!-- 初始化工做 -->
2    <targetname="init">
3        <echo>Initializing all output directories...</echo>
4        <deletedir="${outdir-bin}"/>
5        <mkdirdir="${outdir-bin}"/>
6        <mkdirdir="${outdir-classes}"/>
7    </target>
其次是生成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">
05            <argvalue="package"/>
06            <argvalue="-f"/>
07            <argvalue="-m"/>
08            <argvalue="-J"/>
09            <argvalue="${outdir-gen}"/>
10            <argvalue="-S"/>
11            <argvalue="${resource-dir}"/>
12            <argvalue="-M"/>
13            <argvalue="${manifest-xml}"/>
14            <argvalue="-I"/>
15            <argvalue="${android-jar}"/>
16        </exec>
17    </target>
接着是aidl生成java源文件:
01 <!-- 編譯aidl文件 -->
02    <targetname="aidl"depends="gen-R">
03        <echo>Compiling .aidl into java files...</echo>
04        <applyexecutable="${aidl}"failonerror="true">
05            <!-- 指定預處理文件 -->
06            <argvalue="-p${framework-aidl}"/>
07            <!-- aidl聲明的目錄 -->
08            <argvalue="-I${srcdir}"/>
09            <!-- 目標文件目錄 -->
10            <argvalue="-o${outdir-gen}"/>
11            <!-- 指定哪些文件須要編譯 -->
12            <filesetdir="${srcdir}">
13                <includename="**/*.aidl"/>
14            </fileset>
15        </apply>
16    </target>
咱們指定了一個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}">
05            <classpath>
06                <filesetdir="${external-lib}"includes="*.jar"/>
07                <filelist>
08                    <filename="${android-maps-jar}"/>
09                </filelist>
10            </classpath>
11        </javac>
12    </target>
若是使用到了第三方類庫,咱們能夠在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">
05            <argvalue="--dex"/>
06            <!-- 輸出文件 -->
07            <argvalue="--output=${dex-ospath}"/>
08            <!-- 要生成.dex文件的源classes和libraries -->
09            <argvalue="${outdir-classes-ospath}"/>
10            <argvalue="${external-lib-ospath}"/>
11        </exec>
12    </target>
就像上面的代碼同樣,若是使用到第三方類庫,能夠在最後一參數的形式追加進去。

而後是將資源文件打包:

01 <!-- 將資源文件放進輸出目錄 -->
02    <targetname="package-res-and-assets">
03        <echo>Packaging resources and assets...</echo>
04        <execexecutable="${aapt}"failonerror="true">
05            <argvalue="package"/>
06            <argvalue="-f"/>
07            <argvalue="-M"/>
08            <argvalue="${manifest-xml}"/>
09            <argvalue="-S"/>
10            <argvalue="${resource-dir}"/>
11            <argvalue="-A"/>
12            <argvalue="${asset-dir}"/>
13            <argvalue="-I"/>
14            <argvalue="${android-jar}"/>
15            <argvalue="-F"/>
16            <argvalue="${resources-package}"/>
17        </exec>
18    </target>
接着是打包成未簽證的apk包:
01 <!-- 打包成未簽證的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}"/>
06            <argvalue="-u"/>
07            <argvalue="-z"/>
08            <argvalue="${resources-package-ospath}"/>
09            <argvalue="-f"/>
10            <argvalue="${dex-ospath}"/>
11            <argvalue="-rf"/>
12            <argvalue="${srcdir-ospath}"/>
13        </exec>
14        <echo>It will need to be signed with jarsigner before being published.</echo>
15    </target>
而後是對apk簽證:
01 <!-- 對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"/>
08            <argvalue="123456"/>
09            <argvalue="-keypass"/>
10            <argvalue="123456"/>
11            <argvalue="-signedjar"/>
12            <argvalue="${out-signed-package-ospath}"/>
13            <argvalue="${out-unsigned-package-ospath}"/>
14            <!-- 不要忘了證書的別名 -->
15            <argvalue="release"/>
16        </exec>
17    </target>
最後發佈:
1 <!-- 發佈 -->
2    <targetname="release"depends="jarsigner">
3        <!-- 刪除未簽證apk -->
4        <deletefile="${out-unsigned-package-ospath}"/>
5        <echo>APK is released. path:${out-signed-package-ospath}</echo>
6    </target>

這樣就完成了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));
4 String line =null;
5 while((line = br.readLine()) !=null) {
6    System.out.println(line);
7 }
8 System.out.println("SUCCESS.");

全文完!

相關文章
相關標籤/搜索