我正在使用 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
没有事件名称的标签不满意。似乎最简单的解决方案是,只要您将某些东西声明为可绑定的,就指定一个事件名称。但是flex 文档说,如果您使用 Bindable 标签指定事件名称,那么“您负责生成和调度事件”。我的项目几乎完成了,而且我在很多地方都依赖于绑定(没有事件名称),这使得回去改变一切变得不切实际——这需要很多努力;加上弄乱用于创建文档的工作代码的想法对我来说听起来很可怕。
在生成 asdoc 之前替换所有[Bindable]
实例,[Bindable("blah")]
然后将它们改回来是我能想到的唯一解决方法。但我觉得应该有更好的方法。
Adobe错误跟踪器声称公共变量的问题已在最新版本中得到修复,因此我下载了最新的 flex sdk (3.4) 并尝试使用它附带的 ASDoc - 但它给了我相同的结果。
任何人都可以对这个问题有所了解吗?
此外,Adobe 博客说ASDoc 现在也支持 mxml,但是当我尝试使用最新的 (flex 3.4) ASDoc 时,我的 mxml asdoc 注释(嵌入在 中)没有出现在生成的 html 页面中。有谁知道最新的 asdoc 是否可以单独下载?