我正在使用 ASDoc 创建 Flex 项目的文档,但在可绑定元标记方面遇到了一些问题。
-
ASDoc 没有记录
public Bindable
值,除非可绑定标记具有与其关联的事件名称。
例如:
//This is documented correctly
[Bindable("someEvent")]
/*
* public bindable with event name
* */
public var test1:String;
//This is not documented at all
[Bindable]
/*
* public bindable without event name
* */
public var test2:String;
-
ASDoc 在名称前添加随机字符串
protected Bindable
如果可绑定标记没有与其关联的事件名称,则为值。
例如:
//This is documented correctly as test3
[Bindable("someEvent")]
/*
* protected bindable with event name
* */
protected var test3:String;
//But this is documented as _110251490test4
[Bindable]
/*
* protected bindable without event name
* */
protected var test4:String;
总而言之,ASDoc 不满意Bindable
没有事件名称的标签。看来,简单的解决方案是每当将某些内容声明为“可绑定”时指定一个事件名称。但Flex 文档说 http://livedocs.adobe.com/flex/3/html/help.html?content=databinding_8.html#194574如果您使用 Bindable 标记指定事件名称,则“您负责生成和分派该事件”。我的项目即将完成,并且我在很多地方都依赖于绑定(没有事件名称),这使得返回并更改所有内容是不切实际的 - 它需要付出很多努力;再加上搞乱创建文档的工作代码的想法对我来说听起来很可怕。
全部更换[Bindable]
实例与[Bindable("blah")]
在生成 asdoc 之前然后将它们更改回来是我能想到的唯一解决方法。但我觉得应该有更好的办法。
Adobe 错误跟踪器 http://bugs.adobe.com/jira/browse/SDK-1011声称公共变量的问题已在最新版本中修复,因此我下载了最新的 flex sdk (3.4) 并尝试使用它附带的 ASDoc - 但它给了我相同的结果。
谁能解释一下这个问题?
Also, Adobe 博客说 http://blogs.adobe.com/flexdoc/2008/11/building_flex_asdoc_for_mxml_f.htmlASDoc 现在也支持 mxml,但是当我尝试使用最新的(flex 3.4)ASDoc 时,我的 mxml asdoc 注释(嵌入在 中)没有出现在生成的 html 页面中。有谁知道最新的 asdoc 是否可以单独下载?