Ant and ASDoc
by Ruben
After my personal little tragedy with ASDoc I started looking into some Ant scripts. After trying out a few yesterday (without any success) I decided I'd write my own.
At the hand of the Ant script made by Darron Schall and the one by Dave Williamson I put together my own.
If you're interested in using it, download it, and extract the two files in the zip to the bin folder of the project you'd like to generate documentation for.
Next, open the project. In the navigator, right click build.xml and select Run As » 1 Ant Build.
..and off you go, after the console (in the bottom of your Flex screen) says you're done, check out the asdoc folder (in bin).
However, before you go and try it out, please read through to the end of this post..
Note that if you've got your classes anywhere else than in (or below) com (as in com\rubenswieringa\MyClass.as) you should make a slight modification to the domainextensions property in the build.properties file.
Furthermore, in this file you can also customize the title of the documentation and the folder to which the docs will be outputted.
Also, apparently Ant support has to be enabled beforehand in a typical Flex installation, please read Peter Elst's post regarding this subject.
Please don't be shy and post a comment if you can't get it to work or got something else to ask/tell..
Comments (read older or show 2 trackbacks)
Trackbacks:
Hi, I have developed a desktop application using AIR. for generating AS Docs, i m using your code. but it gives me error as follows when i try to run it:
“Error: Unable to locate specified base class ‘mx.core.WindowedApplication’ for component class ‘testAIR’”
do i need to modify anything in build.xml to make it work for AIR app???
Waiting for your suggestions….
Thanks for the ant script.
I am using this, and am new, so may have made silly mistakes. The Ant is failing for mxml components that are extending other mxml components. The error indicates that it is unable to locate specified base class.
I know this is not an Ant issue but more of my configuration of asdoc.
[...] ANT and a build-file to generate the compiler options and launch ASDoc.exe. This post is worth reading for the ANT script. This post for instructions on how to install ANT in Flex [...]
i am not allowed to post the ant tags? so…
arg line=”-load-config ${FLEX_HOME}/frameworks/air-config.xml”
arg line=”-target-player 10.0.0″