Ant自动编译打包android项目

1.  背景：

    Eclipse用起来虽然方便，但是编译打包android项目还是比较慢，尤其当要将应用打包发布到各个渠道时，用Eclipse手动打包各种渠道包就有点不切实际了，这时候我们用到Ant帮我们自动编译打包了。

2.  Ant 安装：

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

         

      

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

      

3. 对已存在的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 项目，该怎么办呢? 请往下看:

4. 项目引用了其他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了。

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打包应用的时候加入签名信息以及自动打包渠道包。

6. 加入签名信息：

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

[html] view plain copy

 

1. #keystore的路径，必须使用正斜杠  
2. key.store=./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目录下

注意：这里的keystore路径使用的是相当路径，楼主在测试时使用了绝对路径，出现密码错误的情况，有类似情况（设置的密码明明是对的，但是还是报Keystore was tampered with, or password was incorrect: Password verification failed）可是尝试将绝对路径改为相对路径。

7. 自动打包渠道包：

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

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

注意：如果报错：

 Could not load definitions from resource net/sf/antcontrib/antcontrib.properties. It could not be found.

就是因为没有ant-contrib-1.0b3.jar包，（注意这里的包需要和custom_rules文件中的相同）

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

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

#keystore的路径，必须使用正斜杠key.store=./test3.key  #keystore的密码key.store.password=bihansheng#alias名key.alias=test3#alias密码key.alias.password=bihansheng#渠道市场列表  market_channels=bihansheng,baidu,91#版本号version=1.0.1 #包名app.name=test3#apk所在的文件名apk.dir=text3#下面的配置是区分正式打包和测试环境打包的参数#测试环境标识 给apk命名的时候用test.tag.name=test#生产环境标识 给apk命名的时候用release.tag.name=release#测试环境服务器配置test.server.url=192.168.1.10/bihanshengtest.server.image.url=192.168.1.9test.bihansheng.url=192.168.1.10#生产环境服务器配置rel.server.url=111.111.111.222/bihanshengrel.server.image.url=111.111.111.229rel.bihansheng.url=www.bihansheng.com

注意： 渠道名称用逗号分开，并且不允许出现违规的字符如斜杠，否则会打包失败，同样的文件名和文件路径也不能出现违规字符

(2)在我们项目中添加custom_rules.xml文件，内容如下:

<?xml version="1.0" encoding="UTF-8"?><project name="custom_rules" ><!-- 引用ant-contlib这个扩展包，声明一下 --><taskdef resource="net/sf/antcontrib/antcontrib.properties" ><classpath><pathelement location="${ant.ANT_HOME}/lib/ant-contrib-1.0b3.jar" /></classpath></taskdef><!-- 定义一个时间变量，打完包后跟渠道号一起命名apk --><tstamp><formatpattern="yyyyMMddhhmm"property="pktime"unit="hour" /></tstamp><!-- 创建apk存放目录 --><mkdir dir="${apk.dir}" ></mkdir><!-- 替换参数 然后打包APK --><target name="replace_parameter" ><!-- 替换服务器配置 --><replaceregexpbyline="false"encoding="UTF-8"flags="g" ><!-- 这个是正则表达式匹配hostconfig中bihansheng_server的值 --><regexp pattern="bihansheng_server>(.*)</bihansheng_server" /><substitution expression="bihansheng_server>${server_url}</bihansheng_server" /><filesetdir=""includes="res/xml/hostconfig.xml" /></replaceregexp><replaceregexpbyline="false"encoding="UTF-8"flags="g" ><!-- 这个是正则表达式匹配hostconfig中bihansheng_img_server的值 --><regexp pattern="bihansheng_img_server>(.*)</bihansheng_img_server" /><substitution expression="bihansheng_img_server>${server_image_url}</bihansheng_img_server" /><filesetdir=""includes="res/xml/hostconfig.xml" /></replaceregexp><replaceregexpbyline="false"encoding="UTF-8"flags="g" ><!-- 这个是正则表达式匹配hostconfig中bihansheng_url的值 --><regexp pattern="bihansheng_url>(.*)</bihansheng_url" /><substitution expression="bihansheng_url>${bihansheng_url}</bihansheng_url" /><filesetdir=""includes="res/xml/hostconfig.xml" /></replaceregexp></target><!-- 打包测试环境命令就用这个 --><target name="deploytest" ><!-- 传服务器配置参数到 replace_parameter这个打包target --><antcall target="replace_parameter" ><paramname="server_url"value="${test.server.url}" /><paramname="server_image_url"value="${test.server.image.url}" /><paramname="bihansheng_url"value="${test.bihansheng.url}" /></antcall><!-- 执行循环打包target foreach_replacechannel --><antcall target="foreach_replacechannel" ><!-- apk命名时候用到的参数 --><paramname="deploy_environment"value="${test.tag.name}" /></antcall></target><!-- 打包生产环境命令就用这个 --><target name="deployrel" ><!-- 传服务器配置参数到 replace_parameter这个打包target --><antcall target="replace_parameter" ><paramname="server_url"value="${rel.server.url}" /><paramname="server_image_url"value="${rel.server.image.url}" /><paramname="bihansheng_url"value="${rel.bihansheng.url}" /></antcall><!-- 执行循环打包target foreach_replacechannel --><antcall target="foreach_replacechannel" ><!-- apk命名时候用到的参数 --><paramname="deploy_environment"value="${release.tag.name}" /></antcall></target><!-- 循环打包的target --><target name="foreach_replacechannel" ><!-- 开始循环打包，从market_channels参数中取出一个渠道号用channel标识，然后通过正则修改manifest文件 --><foreachdelimiter=","list="${market_channels}"param="channel"target="modify_manifest" ></foreach></target><target name="modify_manifest" ><replaceregexpbyline="false"encoding="UTF-8"flags="g" ><!--这个是正则表达式匹配manifest中meta，我用的友盟的统计，我 AndroidManifest中的配置为：<meta-data android:value="360shichang" android:name="UMENG_CHANNEL"--><regexp pattern="android:value="(.*)" android:name="UMENG_CHANNEL"" /><substitution expression="android:value="${channel}" android:name="UMENG_CHANNEL"" /><filesetdir=""includes="AndroidManifest.xml" /></replaceregexp><!-- 这里设置最终生成包的存放目录以及apk的名称，注意这里是文件名称，所以变量中不允许出现违规字符，否则将无法生成最终的apk（会出现output is not valid 的错误） --><propertyname="out.final.file"location="${apk.dir}/${app.name}_${channel}_${deploy_environment}_${pktime}.apk" /><antcall target="clean" /><antcall target="release" /></target></project>

(3)custom_rules.xml文件中是用服务器ipizne配置文件hostconfig.xml文件，内容为： 

<?xml version="1.0" encoding="UTF-8"?><!-- Ϊ‹antղѼʱ۲ֽղƥƤìȫһҪٱʽۯكτݾ --><hostconfig><bihansheng_server>1111.1111.1111.1/bihansheng</bihansheng_server><bihansheng_img_server>1111.1111.1111.1</bihansheng_img_server><bihansheng_url>www.bihansheng.com</bihansheng_url></hostconfig>