Comments on: ASDoc integration with build scripts

By: Rob

Rob — Thu, 21 Oct 2010 19:45:56 +0000

I see that my last comment didn’t render properly in terms of the xml that I posted. Here it is w/out the angle brackets:

taskdef resource=”flexTasks.tasks” classpath=”${flexTasksJar}”

By: Rob

Rob — Thu, 21 Oct 2010 18:23:36 +0000

Thanks, Gaurav. Very helpful. I had the same problem Ian did – asdoc task name not recognized. What fixed it was adding this line (which is in your fuller build.xml file):

The classpath essentially needed to be updated with flexTasksJar var.
Now I’m trying to figure out how to exclude entire classes vs. just one .as file. For example we use hurlant and I don’t want to doc that stuff.

By: Ian

Ian — Sat, 15 Aug 2009 13:39:53 +0000

I think I finally worked it out. Gumbo seems like a great upcoming release. Thanks for the information and keep up the great work!

By: Gaurav

Gaurav — Fri, 14 Aug 2009 15:15:52 +0000

You should pass in sdk.dir and point that to the sdk root folder. For example

ant asdocgen -Dsdk.dir=/Users/Ian/Flex_SDK

Also take a look at build.xml which is present under the asdoc folder of Flex SDK.

By: Ian

Ian — Fri, 14 Aug 2009 10:49:22 +0000

Hi Gaurav,

This looks brilliant, unfortunately I got stuck trying to run your script. I would feel incredibly thankful if you could share your complete build.xml and build.properties files. I just downloaded FB4 and it looks amazing, I am sure that it uses the most recent SDK. For some reason it throws an error saying:

asdocgen:

BUILD FAILED
/Users/Ian/Documents/Flex Builder 3/InteractiveWorks [iFramework]/ant/build.xml:15: The following error occurred while executing this line:
/Users/Ian/Documents/Flex Builder 3/InteractiveWorks [iFramework]/ant/build.xml:33: Problem: failed to create task or type asdoc
Cause: The name is undefined.
Action: Check the spelling.
Action: Check that any custom tasks/types have been declared.
Action: Check that any / declarations have taken place.

It looks like it can’t find that specific asdoc task. :S

I would love to learn how to make your script work so its not dependent on platform and can exclude unnecessary files (such as include files).

Thanks in advance!