Eclipse用起來雖然方便,但是編譯打包android項目還是比較慢,尤其將應用打包發布到各個渠道時,用Eclipse手動打包各種渠道包就有點不切實際了,這時候我們用到Ant幫我們自動編譯打包了。
1 Ant自動編譯打包android項目
1.1 Ant安裝
ant的安裝比較簡單,下載ant壓縮包 http://ant.apache.org (最新的為1.9.3版本),下載之后將其解壓到某個目錄(本人解壓到E:\Program Files\apache-ant-1.9.3) ,然后配置環境變量(新建ANT_HOME環境變量,值為ant所在的目錄,然后將ANT_HOME/bin添加到path中),如圖:
打開命令行工具,輸入 ant -version ,如果出現如下結果,說明ant 安裝成功。
1.2 為Android項目生成Ant配置build.xml
打開命令行工具,切換路徑到項目所在的目錄;輸入命令
android update project --name <project_name> --target <target_ID>--path <path_to_your_project>
http://developer.android.com/tools/projects/projects-cmdline.html
項目根目錄下多了build.xml,以及local.properties兩個文件。
其中local.properties寫明了我們的android SDK的目錄(其實是環境變量ANDROID_HOME的值,所以如果環境變量中沒有這個的,請增加)。
build.xml則是ant構建的最重要腳本,打開一看,發現里面其實大部分都是寫注釋,有用的沒幾行,這是因為生成的這個build.xml引用了android SDK自帶的構建腳本,具體目錄是{sdk目錄}/tools/ant/build.xml 。
這樣,項目就支持ant編譯打包了,但是,有人可能會說了,我的項目有引用第三方的jar包,而且還引用了其他的android library 項目,該怎么辦呢?
1.3 android使用ant打包時,添加第三方jar包
1.3.1 libs 庫中的第三方jar包
如果項目只是引用了第三方jar包,只要將jar包放在libs文件夾下就ok了,ant會在編譯打包過程中會自動將第三方jar加進去的。但是當我們的android 項目參考了其他library項目,這時候我們最初在輸入android update 命令的時候應該多一個參數 --subprojects :
你發現報錯了,不要着急,這是因為那個library 還不支持ant自動編譯,我們需要先讓它也支持。
進入到library項目所在的目錄,輸入命令 android update lib-project -p ./ (注意是 lib-project);
再回到原項目,輸入命令” android update project --name MenudrawSample -p ./ --subprojects ",這下就OK了。
1.3.2 user library庫中第三方jar包
在Android開發中,除了通常在Eclipse中的編譯方法之外,有的時候為了進行持續集成,可能還需要用ant進行自動化編譯。Android SDK本身已經提供了默認的ant編譯腳本,就在每個工程下的build.xml中,其中引用了SDK的編譯腳本${sdk_dir}/tools/ant/build.xml 。
通常情況下,在工程根目錄下直接執行 ant debug 即可進行一次正常的build。默認的classpath會包括libs目錄下的所有jar文件。但是如果工程中使用了USER LIBRARY,或者引用了外部的jar文件,那么在編譯中就可能會遇到問題,因為USER LIBRARY等這些jar文件不會被自動包含在classpath中,這時就要擴展ant的path變量,把自己的jar文件加入到classpath中。
通過察看sdk提供的build.xml編譯腳本,可以發現javac使用的classpath定義如下:
<path id="project.javac.classpath"> <path refid="project.all.jars.path"></path> <path refid="tested.project.classpath"></path> </path> <javac encoding="${java.encoding}" source="${java.source}" target="${java.target}" debug="true" extdirs="" includeantruntime="false" destdir="${out.classes.absolute.dir}" bootclasspathref="project.target.class.path" verbose="${verbose}" classpathref="project.javac.classpath" fork="${need.javac.fork}"> <src path="${source.absolute.dir}"></src> <src path="${gen.absolute.dir}"></src> <compilerarg line="${java.compilerargs}"></compilerarg> </javac>
其中 project.all.jars.path 包含了所有的jar文件,我們可以通過在工程目錄下的build.xml中重新定義這個變量來引入其他的jar文件。
例如在我的工程中,引用了ormlite這個ORM庫,為了能夠在開發中使用“attach source”察看源碼,該jar文件不能放在libs目錄中,因為Eclipse不允許對libs目錄中的jar文件“attach source”。
因此我將此文件放到了libs/ormlite目錄中,為了能夠將這兩個jar文件加入到classpath中,就要重新定義 project.all.jars.path 這個元素。
基本思路是,重新定義 -pre-compile這個target,在其中重新定義 project.all.jars.path 的值。
這段代碼寫在哪里呢?在每個項目的build.xml中引用了當前目錄下的custom_rules.xml,那么我們就在項目根目錄下創建一個custom_rules.xml,內容如下:
<?xml version="1.0" encoding="UTF-8"?> <project name="custom_rules" default="release"> <target name="-pre-compile"> <echo message="JARPATH=${toString:project.all.jars.path}"></echo> <echo message="JARPATH=${jar.libs.dir}"></echo> <property name="ormlite.dir" value="${jar.libs.dir}/ormlite"> </property> <path id="ormlite.lib"> <path path="${toString:project.all.jars.path}"></path> <pathelement location="${ormlite.dir}/ormlite-android-4.41.jar"></pathelement> <pathelement location="${ormlite.dir}/ormlite-core-4.41.jar"></pathelement> </path> <path id="project.all.jars.path"> <path refid="ormlite.lib"></path> </path> <echo message="JARPATH=${toString:project.all.jars.path}"></echo> </target> </project>
1.4 編譯打包項目
ant debug: 生成一個測試版apk,默認使用 debug key 進行簽名,生成的apk(your_project_name-debug.apk)在bin目錄下。
ant release: 生成一個未簽名和未aligned的apk包, project_name-release-unsigned.ap和project_name-release-unaligned.apk 在bin目錄下。
2 簽名與渠道包
基於ant自動編譯打包現有的android項目,可以在ant打包應用的時候加入簽名信息以及自動打包渠道包。
2.1 加入簽名信息
在項目的根目錄下建一個ant.properties文件,輸入如下內容,其中keystore密碼和alias密碼可以不指定(防泄漏),那么在命令執行的過程中會要求你輸入。
#keystore的路徑,必須使用正斜杠
key.store= "E:/wp_android_sample/me.key"
#keystore的密碼
#key.store.password=*****
#alias名
key.alias=me
#alias密碼
#key.alias.password=******
在項目根目錄下運行 ant release 命令就會幫你生成一個經過簽名和aligned的apk,生成的apk(your_project_name-release.apk)在bin目錄下
2.2 自動打包渠道包
實現批量循環打包需要一個類似於for循環的功能,在Ant的核心包里沒有相關的For循環的Task,即不支持for循環,但是ant支持第三方擴展包,以支持更多的其他功能。
於是我們要下載相應的支持for循環的擴展包。可以使用開源的Ant-contrib包。下載地址:http://ant-contrib.sourceforge.net/ 。
下載后的解壓得到的jar文件放到ant的lib目錄。接下來我們就可以打包渠道包了,具體做法是:
(1) 首先在ant.properties文件中增加屬性 market_channels (渠道列表,以逗號分割),version(應用程序版本名)
#渠道市場列表
market_channels=91,360,wandoujia,baidu
#版本號
version=1.2.1
(2) 在我們項目的build.xml中加入如下代碼:
<!-- 渠道包打包腳本 ant deploy--> <taskdef resource="net/sf/antcontrib/antcontrib.properties"> <classpath> <pathelement location="lib/ant-contrib-1.0b3.jar"/> </classpath> </taskdef> <target name="deploy"> <foreach target="modify_manifest" list="${market_channels}" param="channel" delimiter=","> </foreach> </target> <target name="modify_manifest"> <replaceregexp flags="g" byline="false"> <!-- 匹配的內容是 android:value="*****" android:name="UMENG_CHANNEL" --> <regexp pattern='android:value="(.*)" android:name="UMENG_CHANNEL"' /> <!-- 匹配之后將其替換為 android:value="渠道名" android:name="UMENG_CHANNEL" --> <substitution expression='android:value="${channel}" android:name="UMENG_CHANNEL"' /> <!-- 正則表達式需要匹配的文件為AndroidManifest.xml --> <fileset dir="" includes="AndroidManifest.xml" /> </replaceregexp> <property name="out.release.file" location="${out.absolute.dir}/${ant.project.name}_${channel}.apk" /> <!--包 --> <antcall target="release" /> <!--輸出渠道包到bin/out目錄下 --> <copy tofile="${out.absolute.dir}/out/${ant.project.name}v${version}-${channel}.apk" file="bin/${ant.project.name}-release.apk"/> </target>
在項目根目錄下運行 ant deploy 命令就會幫你各個渠道的簽名包了(為了全程可以自動執行,ant.properties文件中的keystore的密碼可以指定,這樣在執行過程中就不需要手動輸入密碼了),在bin目錄的out目錄下。
參考:
http://my.oschina.net/yunfound/blog/169288
http://developer.android.com/tools/projects/projects-cmdline.html