Flex文档API生成工具AsDoc

 ASDoc是adobe官方提供的ActionScript的API文档生成工具，现在已经集成在FlexBuilder中，使用方法如下；

1、首先配置一个生成文档需要的环境asdocapi，按照下面步骤

Run ->  External Tools -> External Tools Configurations

说明：

 1)、Location: 填asDoc.exe所在的路径 D:\Adobe\Adobe Flash Builder 4 Plug-in\sdks\4.1.0\bin\asdoc.exe

           （sdk3.5是不能用的，不知道为什么）Error: '' is not a directory

 2)、Working Directory: 填工程中，代码所在的目录 ${workspace_loc:/flexdoc/src} 
 3)、Arguments: AsDoc的编译参数 -source-path=. -doc-sources=${workspace_loc:/flexdoc/src}  -output="../FlexDoc"

        -external-library-path="D:\workspace\flexdoc\libs/framework.swc" 

下边两个都可以：

-source-path=. -doc-sources=${workspace_loc:/flexdoc/src}  -output="../../FlexDoc"

-source-path . -doc-sources=${workspace_loc:/flexdoc/src}  -output FlexDoc
--------------------  参数说明  ---------------------- 
    -source-path：代码所在的目录（不能用中文目录） 
    -doc-sources：文件所在的目录（不能用中文目录） 
    -output：         输出文档的目录（不能用中文目录） 
    -external-library-path：扩展的Lib路径（外部的swc的路径）（不能用中文目录）

2、为了AsDoc输出的文档支持中文的注释。
      切换到Common选项卡，Console Encoding分组项目 -> 选择Other -> 选择UTF-8 

3、Run ->  External Tools -> asdocapi

可能会报出一下的错误：

[Fatal Error] toplevel.xml:25186:244: The value of attribute "defaultValue" must not contain the '<' character.

Error: Could not create toplevel.xml: The value of attribute "defaultValue" must not contain the '<' character.

是因为你的注释某些地方文法有问题，比如标签有没有闭合，是不是用了一些特殊字符，比如><@等等。 SDK4.x本身没有错误，只是容错性比较差，出错提示也很烂，但是只要按规则写，就可以通过。