Ant構建Java項目，ant構建java

Ant構建Java項目，ant構建java
Ant構建Java項目

我們建立HelloWorld項目，將源檔案.java發到src中，編譯後位元組碼.class放到bin中，對應的jar包放到exe目錄中。
首先使用命令列來構建項目：
1.建立src目錄
      md src
2.在src目錄中存放源檔案HelloWorld.java，類HelloWorld的包名為com.tghz.test
    那麼建立包名路徑，cd src,md com,cd com,md tghz,cd tghz,md test,然後存放HelloWorld.java到目前的目錄中

//HelloWorld.java   public class HelloWorld{      public static void main(String[] args){     System.out.println("Hello World");  }   }

3.建立bin目錄，並將編譯後產生的位元組碼HelloWorld.class存放到該目錄中
    md bin
    切換到項目目錄下，
    javac -sourcepath src\com\tghz\test -d bin src\com\tghz\test\HelloWorld.java    （命令格式java -sourcepath 源檔案目錄 -d 目的檔案存放目錄 源檔案.java）
    可以自動在bin目錄下根據HelloWorld.java的包名產生相應的目錄
4.產生jar包，並將其存放到exe目錄中。
    切換到位元組碼.class目錄中，即bin目錄下。
    首先我們要建立jar包的設定檔，該檔案中描述了要執行的主類，格式為Main-Class:空格 包名.主類名 enter換行，該檔案與包檔案在同一級目錄下。
    jar包設定檔：mainconfig.txt
    Main-Class: com.tghz.test.HelloWorld
   
    執行jar -cvfm HelloWorld.jar(產生的jar檔案名稱) mainconfig.txt（jar包設定檔） com.tghz.test（包名）
    這樣就產生了jar檔案。
    如果有多個.class檔案，那個需要我們建立資訊清單檔mymanifest，使用資訊清單檔，將bin目錄下的所有檔案歸檔到classes.jar中。即jar cvfm classes.jar mymanifest -C bin . 
    執行成功後，會產生jar包，並且jar內的META-INF檔案夾中MANIFEST.MF中可以看到前面進行的jar包配置。
   
下面我們來使用Ant來構建Java項目
Ant的構建指令檔build file是使用XML語言寫的，預設為build.xml。build.xml中包含一個根節點project，表示一個工程。每個build檔案只允許包含一個project節點元素。
project節點中定義一個或多個target，表示不同的模組。而target又有一些task的集合，每一個task是一段可執行檔代碼。
使用ant來構建一個簡單的Java項目包含三部分：
      1.clean  刪除之前產生的位元組碼.class檔案和jar檔案，這樣我們在產生新的檔案時不會衝突
      2.編譯源檔案來產生.class檔案
      3.打包產生jar檔案
      4.運行java項目
在我們的構建檔案build.xml的project下有四個target模組：clean,compile,jar,run。
下面來詳細分析一下build.xml檔案：

<?xml version="1.0" encoding="UTF-8"?><project name="HelloWorld" default="run" basedir=".">    <!-- property一般是後面要用到的變數 -->    <property name="src.dir" value="src"/><property name="bin.dir" value="bin"/><property name="jar.dir" value="exe"/><property name="main-class" value="HelloWorld"/><!-- "clean"用於清除之前產生的位元組碼和jar檔案，這樣產生新的時不會重複 --><target name="clean">    <delete dir ="${bin.dir}"/><delete dir ="${jar.dir}"/><echo message = "clean the bin and exe"/></target><!-- "compile"用來編譯源.java檔案 --><target name="compile" depends="clean">    <mkdir dir ="${bin.dir}"/><javac srcdir="${src.dir}" destdir="${bin.dir}"/><echo message="compile done!"/></target><!-- "jar"用來打包產生jar--><target name="jar" depends="compile">    <mkdir dir="${jar.dir}"/><jar destfile ="${jar.dir}/HelloWorld.jar" basedir="${bin.dir}">    <!-- 使用manifest節點來配置jar包 -->    <manifest>    <attribute name="Main-Class" Value="${main-class}"/></manifest></jar><echo message ="created jar file"/></target><!-- "run"要完成的有：編譯，打包產生jar，運行jar--><target name="run" depends="jar">    <java classname ="com.tghz.test.HelloWorld" classpath="${jar.dir}/HelloWorld.jar"/></target></project>

在對src中的源檔案進行編譯時間，會根據代碼中的包名自動產生com/tghz/test/HelloWorld.class在bin目錄中。javac srcdir="${src.dir}" （源檔案目錄） destdir="${bin.dir}"（目的檔案目錄）
在打包產生jar時，使用manifest節點來配置jar包，指明主類的名稱。每個jar都包含一個資訊清單檔，來指定jar的屬性。
jar destfile ="${jar.dir}/HelloWorld.jar" （產生的jar檔案的名稱及相對路徑）  basedir="${bin.dir}"（指明當前的基路徑）
建立一個名為destfile的jar檔案，並將basedir目錄下的所有檔案添加到其中。在運行指定的jar檔案時，要指名完整的類名路徑和jar包名和路徑java classname ="com.tghz.test.HelloWorld"（類名） classpath="${jar.dir}/HelloWorld.jar"（jar包名）
我們從命令列下進入build.xml檔案所在的目錄，執行ant，會預設尋找並執行build.xml檔案。有時使用具有其他名稱的組建檔案更方便，在那樣的情況下，您需要對 Ant 使用 -buildfile <file> 參數（-f <file> 是其簡寫形式）。我們還可以指定執行project下的某些模組，而不用全部執行。如ant compile，這樣就不會執行run了。


Eclipse對ant的支援
開源項目Eclipse提供了對Ant的大量支援，核心是Eclipse的Ant編輯器。我們可以將build.xml檔案以Ant Editor的方式開啟，並直接執行，那麼就會執行xml中指令碼了。


Ant自動編譯打包android項目

       對已經存在的Android項目提供Ant支援

      

        進入sdk/tools目錄下，執行android update project --name AntTest(項目名) --path F:\workspace2\AntTest1(項目路徑)，這樣在該android項目會產生build.xml和local.properties。其中local.properties中寫明了我們的android SDK的目錄。

build.xml是ant構建的最重要的指令碼。開啟會發現其實裡面有用的沒幾行，那是因為產生的build.xml指令碼中引用了android sdk內部內建的構建指令碼，<import file="${sdk.dir}/tools/ant/build.xml" />，具體的目錄在{sdk目錄}/tools/ant/build.xml。
這樣我們的項目就支援ant編譯打包了。
        進入我們的項目目錄下，執行ant debug，會生一個測試版的apk，預設使用debug key進行簽名，產生的apk放在bin目錄中。
        執行ant release，會產生一個未簽名的apk（your_prject_name-release-unsigned.apk）。


      項目中引用了其他library項目:

        如果在項目中只是引用了第三方的jar包，那麼只要將jar放到libs檔案夾下即可了，ant編譯打包的過程中會自動將第三方的jar添加進來。但是如果我們的android項目參考了其他的library項目，這時候我們最初在執行android update命令的時候應該多一個參數 ：subprojects

        我們首先要做的是使我們參考的library項目也支援ant編譯打包，執行android update lib-project --path (項目路徑)，注意此時的參數是lib-project。
        然後再回到原項目,輸入命令” android update project --name 項目名 -path 項目路徑 --subprojects "，這下就OK了。


       user library庫中第三方jar包
         通常情況下，在工程根目錄下直接執行 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>

簽名與渠道包
    基於ant自動編譯打包現有的android項目，可以在ant打包應用的時候加入簽名資訊以及自動打包渠道包。
    加入簽名資訊
　　在項目的根目錄下建一個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目錄下.

     自動打包渠道包
      實現批量迴圈打包需要一個類似於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目錄下。