Ant自動編譯打包&發布 android項目

08-03

　　Eclipse用起來雖然方便，但是編譯打包android項目還是比較慢，尤其將應用打包發布到各個渠道時，用Eclipse手動打包各種渠道包就有點不切實際了，這時候我們用到Ant幫我們自動編譯打包了。

1 Ant自動編譯打包android項目 1.1 Ant安裝

　　ant的安裝比較簡單，下載ant壓縮包 http://ant.apache.org (最新的為1.9.3版本)，下載之後將其解壓到某個目錄(本人解壓到E:Program Filesapache-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定義如下：

　　其中 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>

　　http://my.oschina.net/yunfound/blog/169288

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中加入如下代碼:

<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">  <regexp pattern="android:value="(.*)" android:name="UMENG_CHANNEL"" />  <substitution expression="android:value="${channel}" android:name="UMENG_CHANNEL"" />  <fileset dir="" includes="AndroidManifest.xml" /> </replaceregexp> <property name="out.release.file" location="${out.absolute.dir}/${ant.project.name}_${channel}.apk" />  <antcall target="release" />  <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://blog.csdn.net/likebamboo/article/details/17888563

　　http://blog.csdn.net/likebamboo/article/details/17953259

　　http://my.oschina.net/yunfound/blog/169288

　　http://developer.android.com/tools/projects/projects-cmdline.html