将 ASDoc 与 Bindable 元标记和 mxml 一起使用答案

【问题标题】：Using ASDoc with Bindable metatag and mxml将 ASDoc 与 Bindable 元标记和 mxml 一起使用
【发布时间】：2009-08-31 09:47:52
【问题描述】：

我正在使用 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，就指定一个事件名称。但是flex docs say that 如果您使用 Bindable 标签指定事件名称，那么“您负责生成和调度事件”。我的项目几乎完成了，而且我在很多地方都依赖于绑定（没有事件名称），这使得回去改变一切变得不切实际——这需要很多努力；加上为了创建文档而弄乱工作代码的想法对我来说听起来很可怕。

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

Adobe bug tracker 声称公共变量的问题已在最新版本中得到修复，因此我下载了最新的 flex sdk (3.4) 并尝试使用随附的 ASDoc - 但它给了我相同的结果。

谁能解释一下这个问题？

另外，Adobe blog says ASDoc 现在也支持 mxml，但是当我尝试使用最新的 (flex 3.4) ASDoc 时，我的 mxml asdoc cmets（嵌入）没有出现在生成的 html 页面中。有谁知道最新的asdoc是否可以单独下载？

【问题讨论】：

标签： apache-flex mxml asdoc bindable

【解决方案1】：

虽然我无法帮助您解决问题，但问题是 [Bindable]（无事件名称）会围绕属性生成包装代码（我相信是一个单独的属性）。这段代码显然与 asdoc 混淆了。

【讨论】：

【解决方案2】：

您没有提供任何要检查的 Jira 编号，但是...

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

【讨论】：