在flex4中使用asdoc生成api文档

_levelTxt.text = flatUserInfo._gameLevel;

 

配置很简单：

运行-->外部工具-->外部工具配置

位置(L):-->浏览文件系统-->找到FLEX安装目录asdoc.exe，例如：C:\Program Files\Adobe\Adobe Flash Builder 4\sdks\4.0.0\bin\asdoc.exe

工作目录(D):-->浏览工作空间-->选中项目根目录

自变量(A):

-doc-sources src

如果有swc，添加一条变量即可，例如：

-doc-sources src

-external-library-path F:\lish\resource\book\ASDebugger.swc

运行(R)-->问题来了

列: 24 错误: 找不到定义

找到错误描述的类，发现找不到定义的类在错误的类中并没有引用，仅仅是import进来也会报错，去除import后重新运行，不再报错.

列: 34 错误: int 类型值的隐式强制指令的目标是非相关类型 String

_levelTxt.text = flatUserInfo._gameLevel;

_gameLeve定义的int类型，l编译器有时不能检查到这种错误，asdoc发现了！，修改成

_levelTxt.text = String(flatUserInfo._gameLevel);问题解决

利用asdoc报错的机制，我们可以排查冗余代码。

 

 使用sdks-4.0，发现总是报标签有问题，但又不详细说明，排查起来非常困难。

[Fatal Error] toplevel.xml:11644:2: 元素的内容必须由格式正确的字符数据或标记组成。
错误: 无法创建 toplevel.xml: 元素的内容必须由格式正确的字符数据或标记组成。

sdks-4.6明显强大的多，会明确指出那里的标签有问题，例如：

错误: Unexpected symbol : (author:) found in com.hydrotik.utils:SoundManager.

不过4.6经常会报错找不到基类，查询资料后，解决办法：

自变量：

-doc-sources src
-external-library-path F:\lish\resource\book\ASDebugger.swc

-external-library-path "C:\Program Files\Adobe\Adobe Flash Builder 4\sdks\4.6.0\frameworks\libs"

-external-library-path "C:\Program Files\Adobe\Adobe Flash Builder 4\sdks\4.6.0\frameworks\libs\air"

-external-library-path "C:\Program Files\Adobe\Adobe Flash Builder 4\sdks\4.6.0\frameworks\libs\automation"

-external-library-path "C:\Program Files\Adobe\Adobe Flash Builder 4\sdks\4.6.0\frameworks\libs\mobile"

-external-library-path "C:\Program Files\Adobe\Adobe Flash Builder 4\sdks\4.6.0\frameworks\libs\mx"

-external-library-path "C:\Program Files\Adobe\Adobe Flash Builder 4\sdks\4.6.0\frameworks\libs\player\11.1"

 

 

 

 

 

 

转载于:https://www.cnblogs.com/finalfantast/archive/2013/04/19/3030353.html