Phing build.xml文件简介
默认情况下,Phing将在build.xml运行该文件的当前工作目录中查找文件。该文档告诉Phing在构建过程中将要做什么。您可以通过使用phing的-f或-buildfile属性并将生成文件作为参数来更改此设置。以下代码使phing查找名为wibble.xml的构建文件。
phing-fwibble.xml
假设项目名为myProject,则最小的构建文件如下所示:
当然,这实际上根本不做任何事情,因此完全没有用。
每个构建文件都应在一个根项目级别由一个或多个目标组成。目标充当功能,它们会将您的代码复制到另一个目录,创建zip文件,创建文档或执行您希望构建执行的任何操作。您可以使用depends属性,一个接一个地运行多个目标。以下构建文件将在运行主目标之前运行第一个目标。
运行时,将输出以下内容:
C:\myProject>phing Buildfile: C:\myProject\build.xml myProject > first: myProject > main: BUILD FINISHED Total time: 0.2197 seconds
您可以随心所欲地调用目标,但最好用它们的功能名称来调用它们。您也可以通过使用相关目标的参数运行phing来运行单个目标。例如,如果只想运行第一个目标,则可以使用以下命令。
phingfirst
目标还支持description属性,该属性允许您添加目标的简短描述。从维护的角度来看,这是有用的,但从文档的角度来看,这也是有用的。
您可以使用类似的projecthelp标志来获取phing以打印出目标列表及其描述。
phing -projecthelp
这将打印出以下内容。
C:\myProject>phing -projecthelp Buildfile: C:\myProject\build.xml Default target: ------------------------------------------------------------------------------- main The main and final target Main targets: ------------------------------------------------------------------------------- first The first target main The main and final target
要在目标中实际执行任何操作,您需要添加其他xml标记。作为一个简单的示例,您可以使用echo标签将文本回显到屏幕上。以下构建文件在运行时将在屏幕上显示一条消息。
Have I built anything yet?
使用Phing进行自动构建