2009年4月27日星期一

解決用asdoc建立Adobe AIR說明文件的問題

當開始寫Adobe AIR應用程式後,會發覺照著Adobe Flex3 Help所記述的asdoc參數及步驟,是無法為源碼建立說明文件的,會出現一大堆的錯誤訊息,如"Error: Call to a possibly undefined method"、"Error: Definition flash.filesystem:File could not be found"之類,主要原因是asdoc並不知道AIR專屬的程式庫的所在位置,要是找Google的話,前幾名的網頁都會指向同一個方法 - 加入參數 -library-path+=..\frameworks\libs\air

參考:

但以上方法有個明顯的缺撼,就是必須知道Flex SDK所安裝的路徑,這通常都是依開發者的喜好來決定,而許多開發者都喜歡把創建說明文件的指令及其參數寫進script檔內,方便日後更新,但基於參數隨安裝目錄不同而有所改變,要多費幾個步驟。

其實有個更簡單的方法解決,就是使用 +configname=air 參數,asdoc就會自動加入AIR的程式庫,例子:
asdoc +configname=air -source-path src -doc-sources src -library-path+=lib --output html

沒有留言:

Creative Commons License
本網誌Ben Lau製作,以共享創意署名-非商業性-相同方式共享 3.0 香港 授權條款釋出。