3 | | [http://ant.apache.org Apache Ant] is a Java-based build tool. In theory, it is kind of like ''make'', without ''make'' 's wrinkles. |
| 3 | [http://ant.apache.org Apache Ant] is a Java-based build tool. In theory, it is kind of like ''make'', without its wrinkles. Ant uses an XML file called, by convention, {{{build.xml}}} to control the build process. The basic use of Ant is to run the following command in a shell in the root of the fusion directory structure: |
| 4 | |
| 5 | {{{ant [target]}}} |
| 6 | |
| 7 | The optional ''target'' specifies one of the build targets, described below. |
| 8 | |
| 9 | == Fusion Build Targets == |
| 10 | |
| 11 | '''prepare''': |
| 12 | The "prepare" target is used to create the "build" destination directory, and copy the static contents of your web application to it. Normally, this task is executed indirectly when needed. |
| 13 | |
| 14 | '''docs''': |
| 15 | The "docs" target runs NaturalDocs on the code base to create API documentation. |
| 16 | |
| 17 | '''compress''': |
| 18 | The compress target combines various javascript source files into a single file and runs the {{{jsmin}}} tool on it to create a minimized file for use in production applications. |
| 19 | |
| 20 | '''deploy''': |
| 21 | The "deploy" target synchronizes the build directory with an external directory. This can be used to move a fusion build into a web accessible location for instance. |
| 22 | |
| 23 | '''dist''': |
| 24 | The "dist" target creates a binary distribution of your application in a directory structure ready to be archived in a tar.gz or zip file. |
| 25 | |
| 26 | '''clean''': |
| 27 | The "clean" target removes previous build and dist directories to ensure that a newly built version of Fusion doesn't contain extra stuff. |
| 28 | |
| 29 | '''clean-all''': |
| 30 | The "clean-all" target runs the "clean" target and removes anything from the deployment location. |
| 31 | |
| 32 | == Customizing the Build Process == |
| 33 | |
| 34 | You can customize the build process. ''coming soon''. |
| 35 | |
| 36 | |