ant 命令行编译 java 文件 ant 编译软件包

1. ant的安装比较简单，下载ant压缩包(最新的为1.9.3版本)，下载之后将其解压到某个目录(本人解压到E:\Program Files\apache-ant-1.9.3) ，然后配置环境变量(新建ANT_HOME环境变量，值为ant所在的目录，然后将ANT_HOME/bin添加到path中)，如图：

     打开命令行工具，输入 ant  -version ,如果出现如下结果，说明ant 安装成功。

2. 对已存在的Android项目提供Ant支持：

   打开命令行工具，切换路径到项目所在的目录（比如我在E:\GitHub\likebamboo\android-menudrawer\menudrawer-samples下有一个android项目），输入命令" android update project --name MenudrawSample -p ./ " 如下图：(其中 --name 参数是指定项目名称，可自己根据需要替换)。

     这时候我们可以看到在我们的项目根目录下多了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 项目，该怎么办呢? 请往下看:

3. 项目引用了其他library项目：

      如果项目只是引用了第三方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了。 

比如更新project，生成 build.xml，local.properties文件：

android update lib-project -p . --target android-21

android update project -p . --name vod  --target android-21 --subprojects

其中

--name     为项目名称

-t              android编译版本

-p             项目路径

上述命令将会在项目中自动创建相应所需的build.xml等。

若在更新时候出现如下问题：

Error: Target id '16' is not valid. Use 'android.bat list targets' to get the target ids.

则先输入如下代码来查询目前所支持的android编译版本：

android.bat list targets

4.添加第三方jar包

USER LIBRARY等这些jar文件不会被自动包含在classpath中，这时就要扩展ant的path变量，把自己的jar文件加入到classpath中。

通过察看sdk提供的build.xml编译脚本，可以发现javac使用的classpath定义如下：

<span style="font-size:18px;"><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></span>

其中 project.all.jars.path 包含了所有的jar文件，我们可以通过在工程目录下的buildxml中重新定义这个变量来引入其他的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，内容如下：

<span style="font-size:18px;"><?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>

    <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></span>

5. 编译打包项目:

       ant debug : 生成一个测试版apk，默认使用 debug key 进行签名，生成的apk（your_project_name-debug.apk）在bin目录下。

       ant release : 生成一个未签名和未aligned的apk包，生成的apk（your_project_name-release-unsigned.apk和your_project_name-release-unaligned.apk）在bin目录下

ant clean清除上次编译资源

6. 加入签名信息：

在项目的根目录下建一个ant.properties文件，输入如下内容，其中keystore密码和alias密码可以不指定（防泄漏），那么在命令执行的过程中会要求你输入。

1. #keystore的路径，必须使用正斜杠  
2. key.store=E:/wp_android_sample/me.key  
3. #keystore的密码  
4. #key.store.password=*****  
5. #alias名  
6. key.alias=me  
7. #alias密码  
8. #key.alias.password=******

在项目根目录下运行 ant release 命令就会帮你生成一个经过签名和aligned的apk，生成的apk（your_project_name-release.apk）在bin目录下

7. 自动打包渠道包：

 实现批量循环打包需要一个类似于for循环的功能，在Ant的核心包里没有相关的For循环的Task，即不支持for循环，但是ant支持第三方扩展包，以支持更多的其他功能。

于是我们要下载相应的支持for循环的扩展包。可以使用开源的Ant-contrib包。下载地址：http://ant-contrib.sourceforge.net/  。

下载后的解压得到的jar文件放到ant的lib目录。接下来我们就可以打包渠道包了，具体做法是：

(1)首先在ant.properties文件中增加属性 market_channels (渠道列表,以逗号分割),version(应用程序版本名)

1. #渠道市场列表  
2. market_channels=91,360,wandoujia,baidu  
3. #版本号  
4. version=1.2.1

(2)在我们项目的build.xml中加入如下代码:

1. <!-- 渠道包打包脚本  ant deploy-->  
2.   
3. <taskdef resource="net/sf/antcontrib/antcontrib.properties">  
4. <classpath>  
5. <pathelement location="lib/ant-contrib-1.0b3.jar"/>  
6. </classpath>  
7. </taskdef>  
8.   
9. <target name="deploy">  
10. <foreach target="modify_manifest" list="${market_channels}" param="channel" delimiter=",">  
11. </foreach>  
12. </target>  
13.   
14. <target name="modify_manifest">  
15. <replaceregexp flags="g" byline="false">  
16. <!-- 匹配的内容是 android:value="*****" android:name="UMENG_CHANNEL" -->  
17. <regexp pattern='android:value="(.*)" android:name="UMENG_CHANNEL"' />  
18. <!-- 匹配之后将其替换为 android:value="渠道名" android:name="UMENG_CHANNEL" -->  
19. <substitution expression='android:value="${channel}" android:name="UMENG_CHANNEL"' />    
20. <!-- 正则表达式需要匹配的文件为AndroidManifest.xml -->  
21. <fileset dir="" includes="AndroidManifest.xml" />  
22. </replaceregexp>  
23. <property name="out.release.file" location="${out.absolute.dir}/${ant.project.name}_${channel}.apk" />  
24. <!--包 -->  
25. <antcall target="release" />  
26. <!--输出渠道包到bin/out目录下 -->  
27. <copy tofile="${out.absolute.dir}/out/${ant.project.name}v${version}-${channel}.apk" file="bin/${ant.project.name}-release.apk"/>  
28. </target>

在项目根目录下运行 ant deploy 命令就会帮你各个渠道的签名包了(为了全程可以自动执行，ant.properties文件中的keystore的密码可以指定，这样在执行过程中就不需要手动输入密码了)，在bin目录的out目录下。     

参考：

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