把 Flex SDK 4 整合進 Flex Builder 3

Flex SDK 4 已經釋出，但對應的 IDE——Flex Builder 4——還沒上市。好消息是，不用乾等，把 Flex SDK 4 手動掛進現有的 Flex Builder 3，一樣可以用原本熟悉的視覺化開發環境繼續做事。以下是完整的整合步驟。

開始之前要準備什麼？

整合前需要準備兩樣東西：Flex SDK 4 的安裝檔，以及一台裝有 Flash Player 10 以上版本的電腦。

到 Adobe 開源社群下載 Flex SDK 4 的 ZIP 檔（約 82MB）：

opensource.adobe.com/wiki/display/flexsdk/Download+Flex+4

接著確認本機 Flash Player 版本。多數電腦預設裝的是 9，而 Flex 4 不吃這個版本，一定要升級到 10 以上。到 adobe.com/products/flash/about 就能看到目前安裝的版本號，記下類似「You have version 10,0,12,36 installed」這一行，確認數字開頭是 10。

怎麼把 Flex SDK 4 裝進 Flex Builder 3？

下載完成後解壓縮，資料夾依版本序號重新命名為 `4.0.0`，然後整個搬到：

```

C:\Program Files\Adobe\Flex Builder 3\sdks

```

這個資料夾裡原本就會有 `2.0.1`、`3.2.0` 兩個版本，`4.0.0` 是新加進去的第三個。

怎麼讓 Flex Builder 3 認得這個新 SDK？

搬完檔案還不夠，Flex Builder 3 要手動告訴它去哪裡找這個 SDK：

打開選單 `Project > Properties > Flex Compiler`。
點右上角的「Configure Flex SDKs」，這裡可以看到已經有的 Flex 2.0.1 Hotfix 3 和 Flex 3.2。
按下 Add，Flex SDK location 指向剛剛搬過去的路徑：`C:\Program Files\Adobe\Flex Builder 3\sdks\4.0.0`。
Flex SDK name 通常會自動帶出「Flex 4.0」，沒有的話手動輸入即可。
加入完成後，記得在 Flex 4.0 前面打勾，確認它是目前生效的 SDK。

專案要怎麼指定用 Flash Player 10 執行？

這一步很容易漏掉，卻是整合能不能跑起來的關鍵。Flex Builder 3 的專案通常放在「我的文件 > Flex Builder 3」底下，進入要用 Flex SDK 4 開發的專案資料夾，用記事本打開 `.actionScriptProperties` 檔案，找到 `htmlPlayerVersion` 這個欄位，把版本號從 `9.x.x` 改成 `10.0.12`。

這裡原本應該可以直接在 Builder 介面裡改，但實測下來改完存檔會失敗，只能退回用記事本手動編輯。

每次開新專案，或是舊專案要切換成 Flex SDK 4 建構，都得重新做一次這個步驟。 漏掉的話，Flex Builder 3 還是會呼叫預設的 Flash Player 9，跑出來的結果通常是 `Error #1046: Type Not Found: Matrix3d` 這類錯誤，可以參考 ShortFusion 這篇除錯紀錄對照。

整合完成後，語法上有哪些地方要跟著改？

Flex 4（開發代號 Gumbo）跟 Flex 3 的 XML 命名空間不一樣，既有的 MXML 檔案搬到新 SDK 下不會原封不動能跑，語法上要跟著調整：

`xmlns` 宣告要換成 Flex 4 的版本。
原本標籤前面的 `mx:` 前綴，在 Flex 4 的新元件裡大多不見了。

實際對照可以參考 FlexExamples 這篇 FXTextArea 文字對齊的範例，能看出新舊語法的差異。

還有哪些細節容易踩坑？

輸出的 SWF 檔案可以再瘦身：在 `Project > Properties > Flex Compiler` 裡，把編譯參數從 `-locale en_US` 改成 `-locale en_US -debug=false`，每個 SWF 大概能減少 100KB。代價是除錯訊息會被整個隱藏，正式上線前確認沒問題再改。
切到 Design Mode 會跳出警告：這是已知問題，當時 Flex 開發團隊還在處理，官方論壇上有對應討論串可以追蹤進度：Adobe 官方論壇討論。

常見問題

Q一定要用記事本改 `.actionScriptProperties` 嗎？

目前是的。在 Flex Builder 3 的專案設定介面裡直接改 Flash Player 版本號，實測會發生存不了檔的狀況，用文字編輯器直接改這個 XML 檔反而穩定。

Q忘記做 Flash Player 版本切換會怎樣？

專案還是會用預設的 Flash Player 9 去跑，Flex 4 的元件（例如 3D 相關 API）會直接丟出 `Error #1046: Type Not Found` 之類的錯誤，這是最常見的整合失敗原因。

參考資料

Adobe Flex SDK Wiki（SourceForge 存檔版），〈Download Flex 4〉，列出 Flex SDK 4 各里程碑版本的下載連結，存取日期：2026-08-27。https://sourceforge.net/adobe/flexsdk/wiki/Download%20Flex%204/?version=1

關於作者 {#author}

Claire Chang ｜企業 AI 導入與流程轉型顧問。專注於 AI Agent 架構設計、ERP 系統整合與企業 AI 治理。

首次發布：2009-07-22