Wow, this was really challenging! But now, finally, I found out how to use AsDoc on my Mac.There must be another solution out there, but I simply want to document this workaround hoping that this also works on your Mac.
What you need is a Flex SDK 2.0.1 which comes with Flex Builder or as a free download from Adobe and the knowledge how to use ANT (I use eclipse).
I tried this tutorial several times but it never worked for me. I don't know why.But after hours of testing I hopefully found a proper solution which works find with Flex SDK 2.0.1. The main idea simply is separating the AsDoc functionality from the normal Flex Builder environment. Basically the only thing you have to do is avoiding whitespaces from your directory names. However I tried to use Flex Builder for this and Flex Builder installs into the directory "Flex Builder 3".So this is what I did and you might try:
- Create a new directory within the applications folder (don't use whitespace!) "Applications/Adobe_AsDoc"
- Copy the Flex SDK 2.0.1 into that "Adobe_AsDoc" directory
- Rename the Flex SDK directory to "FlexSDK_201" (which might not be necessary, but I tried to avoid any special characters within the directory names)
Great. So all you have to do now is download and use this ANT build.xml (download):
-
?>?>?>
-
-
<project default="asdoc" name="Documentation">
-
<property environment="env"></property><!--
-
Markus Raab - derRaab.com / superclass.de
-
This ANT build.xml works on a Mac with a FLEX SDK 2.0.1 in the following location:
-
/Applications/Adobe_AsDoc/FlexSDK_201
-
For more informations see: http://blog.derraab.com/2007/11/23/running-adobe-asdoc-on-my-mac-using-ant/
-
ATTENTION: Use relative paths (according to this build.xml)
-
-->
-
-
<!--
-
ActionScript directory location in source-path and doc-sources (both are needed?)
-
-->
-
-
<property value="../src/as/" name="source-path"></property>
-
<property value="../src/as/" name="doc-sources"></property><!--
-
List with all your used library SWC files (using a directory causes asdoc not to write any documentation files?)
-
-->
-
-
<property value="../src/as/mdm.swc ../src/as/layout.swc" name="library-path"></property><!--
-
Documentation output directory
-
-->
-
-
<property value="./classes" name="output"></property><!--
-
SDK Location (without whitespace!)
-
-->
-
-
<property value="/Applications/Adobe_AsDoc/FlexSDK_201" name="flex-sdk"></property><!--
-
Location of the asdoc templates
-
-->
-
-
<property value="${flex-sdk}/asdoc/templates" name="templates-path"></property><!--
-
run
-
-->
-
<target name="asdoc">
-
<exec executable="${flex-sdk}/bin/asdoc">
-
<arg value="-source-path ${source-path}"></arg>
-
<arg value="-doc-sources ${doc-sources}"></arg>
-
<arg value="-library-path ${library-path}"></arg>
-
<arg value="-output ${output}"></arg>
-
<arg value="-templates-path ${templates-path}"></arg>
-
</exec>
-
</target>
