Android利用ant手動打包
首先我們要給自己的IDE eclispe配置ant,默認的eclipse是集成了ant構建工具的,但是google提供的Android集成開發工具ADT,里面封裝了Eclipse,但是很奇怪的是竟然沒有Ant插件在里面標准的Eclipse一般都是內置集成了Ant的。然后我們到eclipse的plugins目錄下查看了,其實是有安裝ant插件的,但是沒有在界面體現出來。要讓Eclipse在界面顯示Ant的相關配置,可在命令行下作如下操作:
$ cd <your eclipse install folder> $ eclipse -application org.eclipse.equinox.p2.director -repository http://download.eclipse.org/releases/juno -installIU org.eclipse.ant.ui Installing org.eclipse.ant.ui 3.5.400.v20130514-1341.
然后重啟一下你的eclipse就可以看到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:
首先我們需要定義大量的變量屬性,用來表示使用到的路徑、目錄等,如下:
<project name="ant" default="release"> <!-- ANT環境變量 --> <property environment="env" /> <!-- 應用名稱 --> <property name="appName" value="${ant.project.name}"/> <!-- SDK目錄(獲取操作系統環境變量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" /> <!-- 使用到的命令(當前系統為windows,如果系統為linux,可將.bat文件替換成相對應的命令) --> <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; 如果項目使用到地圖服務則需要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文件所需的預處理框架文件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相關變量 --> <property name="dex-file" value="classes.dex" /> <property name="dex-path" value="${outdir-bin}/${dex-file}" /> <property name="dex-ospath" value="${basedir}/${dex-path}" /> <!-- 經過aapt生成的資源包文件 --> <property name="resources-package" value="${outdir-bin}/resources.ap_" /> <property name="resources-package-ospath" value="${basedir}/${resources-package}" /> <!-- 未認證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" /> <!-- 已認證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文件:
<!-- 根據工程中的資源文件生成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"> <!-- 指定預處理文件 --> <arg value="-p${framework-aidl}"/> <!-- aidl聲明的目錄 --> <arg value="-I${srcdir}"/> <!-- 目標文件目錄 --> <arg value="-o${outdir-gen}"/> <!-- 指定哪些文件需要編譯 --> <fileset dir="${srcdir}"> <include name="**/*.aidl"/> </fileset> </apply> </target>
我們指定了一個framework.aidl,里面定義了很多android內置對象,然后我們指定了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標簽下配置。接着是將class文件轉換成classes.dex:
<!-- 將.class文件轉化成.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>
就像上面的代碼一樣,如果使用到第三方類庫,可以在最后一參數的形式追加進去。然后是將資源文件打包:
<!-- 將資源文件放進輸出目錄 --> <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>
最后發布:
<!-- 發布 --> <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中直接運行,也可以在代碼中調用。首先我們需要下載ANT,然后配置相應的環境變量信息,最后我們這樣調用:
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.");
用ant去給android進行打包時,發現apkbuilder找不到了,sdk更新3.0以后貌似apkbuilder已經被刪除了,並且一些命令的目錄也換了。下面就說一下怎么在沒有apkbuilder的情況下生成apk文件,其實apkbuilder是一個批處理文件,打開里面就能發現,其實他內部執行的是sdklib.jar里面的一個class,所以就知道怎么做了,很簡單,我們自己直接去調用java去執行這個類,如下:
<java classpath="${android.tools}/lib/sdklib.jar" classname="com.android.sdklib.build.ApkBuilderMain"> <arg value="${path.build.main}/bin/unsigned.apk" /> <arg value="-u" /> <arg value="-z" /> <arg value="${path.build.main}/bin/res.zip" /> <arg value="-f" /> <arg value="${path.build.main}/bin/classes.dex" /> <arg value="-rf" /> <arg value="${path.build.main}/src" /> <arg value="-rj"/> <arg value="${path.build.main}/libs"/> <arg value="-nf"/> <arg value="${path.build.native}"/> </java>
其實以前的apkbuilder.bat內部也是執行的
com.android.sdklib.build.ApkBuilderMain
//這個類,我們在這里自己直接執行了,其實一樣的!
解決Android項目Dex中方法超出65536個方法異常
當我們的項目代碼過大時,編譯運行時會報Unable to execute dex: method ID not in[0, 0xffff]: 65536)錯誤。當出現這個錯誤時說明你本身自己的工程代碼中含有的太多的方法,或者你的工程lib文件夾下引用的第
三方插件jar包有太多的方法,這兩者的方法加起來已經超過了65536這個數目。而谷歌規定單個dex文件中的方法不能超過65536的限制。那么這個時候,我們就需要分包處理解決。一般情況下的解決方案就是把整個項目工程包括jar,區分開來分解成兩個dex文件。網上很多這些解決方案,有的把項目代碼中比較獨立的模塊打包成jar文件,然后利用dx工具將打包的jar文件轉成dex文件的jar,然后將其放到SD卡中去動態加載。這種方案是不符合我們的需求的。那么問題來了,該如何更好的去拆分Dex文件,繞過谷歌規定的65536呢?其實,網上已經有些牛人幫我們提出了很多方案了,尤其是在github上。特別是mmin18提出的方案,githut地址如下:
https://github.com/mmin18/Dex65536
該解決方案的原理差不多是這樣:
1.在工程目錄下創建custom_rules.xml文件,修改編譯策略。將工程lib的文件中含有的第三方插件jar包全部打包成libs.apk,然后將其作為編譯運行時的第二個dex文件。
2.最后通過ant命令執行操作,運行整個工程或簽名加密打包整個工程。
看起來很簡單,如果要真正的去了解整個原理,還是很有難度,首先你得對custom_rules.xml文件的相關配置和android工程的編譯策略非常熟悉。不過,這里我們不用管它,既
然牛人已經幫我們寫好了,那我們只要知道怎么去用到我們的項目中就行了。接下來就是怎么去用到我們的項目代碼中了(當然,感興趣的同志可以去研究研究它的實現原理)。
一.配置和運行工程步驟如下:
1. 竟然要用到ant,首先就要先下載ant和配置ant環境,下載鏈接地址為:http://ant.apache.org/bindownload.cgi。下載好apache-ant-1.9.4-bin.zip包后,解壓到指定目錄。然后配置環境變量,創建變量名為
ANT_HOME,值為ant文件對應的路徑,比如我的是ANT_HOME = E:\apache-ant-1.9.4-bin\apache-ant-1.9.4。然后在Path變量的值中追加%ANT_HOME%/bin;%ANT_HOME%/lib。這樣ant環境變量就配置好了。
2. 接下來就是拷貝文件custom_rules.xml和pathtool.jar到我們項目的根目錄下。
3. 然后就在我們的項目運行之前添加代碼執行去加載第二個dex文件,下面的dexTool方法就是執行加載第二個dex文件的功能代碼,直接copy到我們的自定義application類中就行了,代碼如下:
@SuppressLint("NewApi")
private void dexTool() {
File dexDir = new File(getFilesDir(), "dlibs");
dexDir.mkdir();
File dexFile = new File(dexDir, "libs.apk");
File dexOpt = getCacheDir();
try {
InputStream ins = getAssets().open("libs.apk");
if (dexFile.length() != ins.available()) {
FileOutputStream fos = new FileOutputStream(dexFile);
byte[] buf = new byte[4096];
int l;
while ((l = ins.read(buf)) != -1) {
fos.write(buf, 0, l);
}
fos.close();
}
ins.close();
} catch (Exception e) {
throw new RuntimeException(e);
}
ClassLoader cl = getClassLoader();
ApplicationInfo ai = getApplicationInfo();
String nativeLibraryDir = null;
if (Build.VERSION.SDK_INT > 8) {
nativeLibraryDir = ai.nativeLibraryDir;
} else {
nativeLibraryDir = "/data/data/" + ai.packageName + "/lib/";
}
DexClassLoader dcl = new DexClassLoader(dexFile.getAbsolutePath(),
dexOpt.getAbsolutePath(), nativeLibraryDir, cl.getParent());
try {
Field f = ClassLoader.class.getDeclaredField("parent");
f.setAccessible(true);
f.set(cl, dcl);
} catch (Exception e) {
throw new RuntimeException(e);
}
}
接着在自定義application類的onCreate方法中調用dexTool。
4. 自動生成build.xml文件。打開命令窗口,進入到工程的根目錄下,輸入如下命令android update project -p . (.代表當前目錄)在輸入該命令之前,要確保你配置的sdk/tools目錄和sdk/tools/lib文件夾中有android.bat和find_java.bat文件。
5. 然后就是運行該工程了。輸入命令ant clean debug install run,在輸入該命令之前要確保你的ant環境配置沒有問題。
二.簽名混淆代碼:
上面的運行apk並沒有通過代碼混淆和簽名,一般情況下我們需要生成一個經過代碼混淆和簽名的apk,那么ant環境下怎么去配置才能生成代碼混淆和簽名的apk呢。接下來將進行說明。
1. 在剛剛已經配置好的工程根目錄下創建ant.properties文件,該文件在創建工程時是不會自動生成的,需要我們自己去創建。這個文件會在build.xml文件中聲明。
2. 然后在創建好的ant.properties中添加相關信息,比如我添加的信息如下

第一行內容為配置關聯相關的加密信息文件(也可能為proguard.config = proguard.cfg)
第二行內容為指定簽名文件所在路徑,./keystore.eking,說明該簽名文件在工程根目錄下(拷貝簽名文件到工程根目錄)
第三行內容為簽名文件的alias值為eking
第四、第五行分別為簽名文件對應的store、alias密碼。
3.接着在工程目錄下執行如下命令antrelease, 執行完后會自動在工程的bin目錄下生成appname-release.apk文件,這個就是簽名后生成的apk。
