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目錄下。

 

參考:

  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


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM