ASDoc を使用してフレックス プロジェクトのドキュメントを作成していますが、バインド可能なメタタグに問題があります。
- Bindable タグにイベント名が関連付けられていない限り、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;
Bindable
要約すると、ASDoc はイベント名のないタグには満足していません。簡単な解決策は、何かを Bindable として宣言するたびにイベント名を指定することです。しかし、flex のドキュメントでは、Bindable タグでイベント名を指定すると、「イベントの生成とディスパッチはあなたの責任です」と書かれています。私のプロジェクトはほぼ完成しており、多くの場所でバインディング (イベント名なし) に依存しているため、戻ってすべてを変更することは現実的ではありません。多くの労力が必要になります。さらに、ドキュメントを作成するために作業コードを台無しにするという考えは、私には恐ろしいように思えます。
asdocを生成する前にすべての[Bindable]
インスタンスを置き換えてから元に戻すことが、私が考えることができる唯一の回避策です。[Bindable("blah")]
しかし、私はもっと良い方法があるべきだと感じています。
Adobeバグ トラッカーは、パブリック変数の問題が最新のビルドで修正されたと主張しているため、最新の flex SDK (3.4) をダウンロードし、付属の ASDoc で試してみましたが、同じ結果が得られました。
誰でもこの問題に光を当てることができますか?
また、アドビのブログによると、 ASDoc は mxml もサポートするようになりましたが、最新の (flex 3.4) ASDoc を試したところ、mxml asdoc コメント (に埋め込まれています) が、生成された html ページに表示されませんでした。最新の asdoc を個別にダウンロードできるかどうかは誰にもわかりませんか?