使用ASDoc与Bindable metatag和mxml

Question

我正在使用ASDoc创建我的flex项目的文档，并且与可绑定的元数据库有一些问题。

• ASDoc不记录 public Bindable 值，除非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标记。简单的解决方案似乎是，当您声明某件事情为Bindable时，应该指定一个事件名。但是如果您用Bindable标记指定一个事件名，那么“您负责生成和分派事件”。我的项目几乎完成了，而且我在很多地方都依赖于绑定(没有事件名称)，因此回到过去改变一切是不切实际的--这需要付出很大的努力；另外，把创建文档的工作代码搞砸的想法对我来说听起来很可怕。

在生成asdoc之前将所有[Bindable]实例替换为[Bindable("blah")]，然后将它们更改回是我能想到的唯一解决办法。但我觉得应该有更好的办法。

Adobe声称公共变量的问题已经在最新的构建中解决了，所以我下载了最新的flex (3.4)，并尝试了它附带的虫追踪器 --但是它给了我同样的结果。

有人能说明一下这个问题吗？

而且，Adobe博客说 ASDoc现在也支持mxml，但是当我尝试使用最新的(flex 3.4) ASDoc时，我的mxml asdoc注释(嵌入在其中)并没有出现在生成的html页面中。有人知道最新的asdoc是否可以单独下载吗？

Answer 1

虽然我无法帮助您解决问题，但问题是Bindable会围绕属性生成包装代码(我相信是单独的属性)。这段代码显然是在搅乱asdoc。

Answer 2

你没有提供任何吉拉号码来核实，但是.

MXML的ASDoc更改仅在Flex 4 (IIRC)中进行，我会检查绑定错误是不一样的。