2

我正在使用 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 是否可以单独下载?

4

2 回答 2

1

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

于 2009-10-13T10:34:37.177 回答
0

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

MXML 的 ASDoc 更改仅在 Flex 4 (IIRC) 中,我会检查绑定错误是否相同。

于 2009-08-31T12:40:59.210 回答