您的位置:首页 > 其它

在flex4中使用asdoc生成api文档

2013-04-19 11:42 363 查看
_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"
内容来自用户分享和网络整理,不保证内容的准确性,如有侵权内容,可联系管理员处理 点击这里给我发消息
标签: