Flex AsDoc 文檔API生成工具 可以生成和Adobe的ActionScript3幫助一樣的文檔

 

ASDoc是adobe官方提供的ActionScript的API文檔生成工具，現在已經集成在FlexBuilder3中；
使用ASDoc工具可以生成和Adobe的ActionScript3幫助一樣的文檔，使用的方法如下：

==========  本人操作成功的過程如下...火舞天涯http://blog.csdn.net/cjy37

Run ->  External Tools -> Open External Tools Dialog ....

1、New 一個項目，並命名！
2、主要是設置Main選項卡：
    1)、Location: 填asDoc.exe所在的路徑 C:/Program Files/Adobe/Flex Builder 3/sdks/3.2.0/bin/asdoc.exe
    2)、Working Directory: 填工程中，代碼所在的目錄 ${workspace_loc:/HTFlexLib/src}
    3)、Arguments: 最重要的就是這裏了，這裏填的是AsDoc的編譯參數 -source-path=. -doc-sources=${workspace_loc:/HTFlexLib/src}  -output="../../FlexDoc" -external-library-path="D:/work/flexWordFolders/flex3/libs/gearWheel.swc"
--------------------  參數說明  ----------------------
    -source-path：代碼所在的目錄（不能用中文目錄）
    -doc-sources：文件所在的目錄（不能用中文目錄）
    -output：         輸出文檔的目錄（不能用中文目錄）
    -external-library-path：擴展的Lib路徑（外部的swc的路徑）（不能用中文目錄）
3、爲了AsDoc輸出的文檔支持中文的註釋。
      切換到Common選項卡，Console Encoding分組項目 -> 選擇Other -> 選擇UTF-8

...火舞天涯  http://blog.csdn.net/cjy37===============

好，OK了，接着點Run～！ 文檔就生成了，趕快去看看吧～！

 

參考的文章：http://www.flashas.net/html/FLASHfuzhuruanjian/20090106/3877.html

 

注：在MXML文件中如果有類似以下引用圖標資源文件者，會報錯：

  [Bindable] [Embed(source='assets/icon_alert.png')] private var alert_icon:Class;

解決的辦法是創建一個資源類*.as類型的，專門保存一些圖標等資源。如：

[Bindable] public class HtAssets { [Embed(source='assets/icon_alert.png')] public var alert_icon:Class; [Embed(source='assets/card.gif')] public var card_icon:Class; [Embed(source='assets/document.png')] public var document_icon:Class; public function HtAssets() { } static public function iconClass(s:String):Class { var tmpAssets:HtAssets=new HtAssets(); return tmpAssets[s]; } }

引用辦法：

[Bindable] public var card_icon:Class=HtAssets.iconClass("card_icon");