第 12 章 创建/修改项目的Ant Builder
正如前面
builder一章所介绍的,您需要提供一个构建文件,ant使用该文件来构建您的项目。
该构建文件是一个普通的Ant构建文件。在您的构建文件执行前,Luntbuild将会预先定义以下属性:
- buildVersion(构建版本号)
该属性值就是构建的当前版本号。
- buildDate(构建日期)
该属性值就是构建的时间/日期。
- artifactsDir(制品输出目录)
这些属性不只是写Ant的构建文件时有效,当您运行应用程序的时候也有用。
例如,如果您需要在应用程序的About(关于...)对话框中显示构建的版本号,那么您应该将这些属性写入一个文件,
该文件和您的应用一起打包发布(发布的应用程序在显示构建的版本号的时候就从该文件中读取相应的信息)。
您可以在Ant构建文件的"package"目标下面添加以下几行配置信息:
<propertyfile file="stage/buildInfo.properties">
<entry key="buildVersion" value="${buildVersion}"/>
<entry key="buildDate" value="${buildDate}"/>
</propertyfile>
尽管在Luntbuild调用ant前已经预定义这些属性,但是我们鼓励所有用户在您的构建文件的开始就指定这些属性的默认值,这样即使
不依赖于Luntbuild,您的构建文件也可以正确的执行。如:
<property name="buildVersion" value="luntbuild-1.0"/>
<property name="artifactsDir" value="distribute"/>
<property name="buildDate" value=""/>
注意
ant构建文件的任何输出信息和错误信息都不需要您手工重定向到您的日志文件,
这些事情留给ant去做,让ant将这些信息分别输出到stdout和stderr。
Luntbuild能够捕获他们并将他们写到预先准备的日志文件里面,然后将日志文件发布到制品输出目录(artifactsDir)下。