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"‘ />         <!-- Regex需要匹配的檔案為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://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

 分類: Android

Ant自動編譯打包android項目（轉載）