Flex的官方文件

感覺Flex的文件有好幾個,搞不清楚到底應該怎麼看,以這篇文章來自我釐清一下脈絡。


Livedocs Using Flex (位於livedocs裡, 網址裡面已經說明只有Flex3的內容)

這份文件很棒,以口語化的內容向開發者介紹Flex各個環節, 文中並嵌入 source code和範例,就像是一本寫得很好的書。想要了解某個機制的設計和概念時,可以先從這邊開始閱讀。user可以針對每篇內容做討論。

Help Using Flex (位於Help裡)

與Livedocs的內容幾乎一模一樣,但網址裡面沒有限定某一個版本,所以內容包含Spark的介紹也合理。一樣的內容,但Index書目跟Livedocs卻不一樣,但稍微比對一下發現只是章節編排的位置不同。比如Deployment的章節,在Help裡位於最後一章,但在Livedocs卻是位於中間介紹完Development的地方。Help裡面經常會附帶有Builder的操作步驟。跟Livedocs一樣,user可以針對每篇內容做討論,Help裡面也有這個機制,但可能比較新的關係,Help的討論幾乎沒有,在Livedocs中的討論比較多。

不一樣的地方來了,(1) 對於Flex Builder的介紹方面,Livedocs是針對比較舊的Flex Builder 3做介紹,新的Flash Builder 4以上所具有的功能當然就沒有,這很合理。至於內容上,又是否有什麼不一樣呢? [TODO] 實際找一個需要了解 topic的內容,兩邊都看過再來比較。然後,Help裡面會包含,但LiveDocs裡面不會有。(2) 有包含AIR的介紹。不一樣的地方,沒有包含AIR的介紹。(3) Help文件有中文翻譯,只要把"en_US"的路徑,改為"zh_TW"就可以看到中文版,如果沒有繁體中文版會被導到英文版中,這時也可以"zh_CH"試試簡體中文版。不曉得為何不直接在UI上提供語言切換,又是一個謎。(4) 有行動應用方面的資訊,由此可見Help應該是比較新的資料。


結論:
Help應該是比較新的資料,而且Help把Flash Platform的資料都集成一起,如最基礎的AS3學習AIR和進階的行動開發,但是其實Livedocs的編排我比較喜歡。對於Flex的機制,目前還不明朗的情況下,我想還是兩邊都要參考,但Help優先,免得漏掉重要的內容。

Help API Reference

留言

這個網誌中的熱門文章

3dmax的biped如何使用CMU的免費motion capture資源

如何在AS3 project中使用Flex的mx.utils類別庫?

如何把3dmax的physique轉成skin