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

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>

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

<!-- 渠道包打包腳本  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目錄下。

 

在Eclipse中運行ant批量打包工具出錯，日誌信息以下:
D:\Android\android-sdk-windows\tools\ant\build.xml:601: The following error occurred while executing this line:
D:\Android\android-sdk-windows\tools\ant\build.xml:720: The following error occurred while executing this line:
D:\Android\android-sdk-windows\tools\ant\build.xml:734: Unable to find a javac compiler;
com.sun.tools.javac.Main is not on the classpath.
Perhaps JAVA_HOME does not point to the JDK.
It is currently set to 「D:\Program Files\Java\jre7″

解決方案：

 

1: Eclipse菜單 – Window – Preferences – Java – Installed JREs – 選中欄目表格中的jre項 – Edit – Add External JARs – 選擇jdk目錄/lib/tools.jar - 確認其加入JRE system libraries– Finish – OK

2: ant clean

3: ant release