使用 Flex 庫項目---打包swc

標籤：

來源：http://help.adobe.com/zh_CN/flashbuilder/using/WSe4e4b720da9dedb5-1a92eab212e75b9d8b2-7ffe.html

為應用程式配置庫 建立 Flex 庫項目 建立 AIR 庫項目 將組件添加到庫項目中 選擇要包括在 SWC 檔案中的庫項目元素 構建庫項目 在項目中使用 SWC 檔案 將 SWC 檔案添加到庫路徑 編譯時間將 SWC 檔案合并到應用程式 SWF 檔案中 將 SWC 檔案設定為外部庫檔案 將 SWC 檔案用作 RSL 使用庫項目可以構建可在應用程式之間共用或分發給其他開發人員的自訂程式碼程式庫。庫項目會產生 SWC 檔案，該檔案是 Flex 組件和其它資源的歸檔檔案。例如，SWC 檔案中包含 Flex 架構。 當您建立 Flex 項目時，系統會將 Flex 架構 SWC 檔案添加到該項目的庫路徑中。將庫添加到項目後，即可在應用程式中使用那些組件，並且可以為那些組件啟用代碼提示。 您可以通過訪問項目的構建路徑屬性頁面來查看和編輯庫路徑。對於 Flex 項目，請選擇“項目”>“屬性”>“Flex 構建路徑”。 除了提供一種打包和分發組件的便捷方式以外，SWC 庫還用作主題，即 Flex 中構建的應用程式的可視外觀。SWC 主題檔案包含一個 CSS 檔案和所有相關圖形資源。有關建立和使用主題的更多資訊，請參閱關於主題。 為應用程式配置庫 可以通過以下方式在項目中使用 SWC 庫： 合并到應用程式中   在將 SWC 檔案添加到項目的庫路徑後，即可在應用程式中使用庫中包含的組件。構建應用程式時，只有實際使用的庫組件才會編譯成應用程式 SWF 檔案。換句話說，所有應用程式代碼都將合并到一個 SWF 檔案中。這是使用庫組件的最常見且最直接的方式。   位於應用程式的外部   可以將庫組件與已編譯的 SWF 檔案分開，以避免將這些組件合并到該檔案中。編譯器將解析應用程式使用的庫中包含的所有代碼，但不會將這些代碼合并到應用程式 SWF 檔案中。此方法的優點是可以使應用程式 SWF 檔案變得更小。在運行時，系統將根據需要檢索 SWC 檔案中包含的組件，並將其載入到記憶體中。   運行時共用庫   在且只在 Flex 項目中，還可以將 SWC 檔案用作運行時共用庫 (RSL)，該庫類似於其它平台上的動態連結程式庫。如果您具有由多個應用程式使用的組件的集合，則可將 SWC 檔案用作 RSL。  使用 RSL 在多個應用程式之間共用組件具有多個優點。首先，庫在記憶體中載入一次，即進行緩衝，之後使用那些組件的所有應用程式都可以使用該庫。其次，庫中包含的組件僅在需要時才會載入，這樣可以減少應用程式的啟動時間，因為每個應用程式的大小都較小。此方法的潛在問題是會將整個 RSL 載入到記憶體中，而不是載入應用程式所使用的各個組件。有關何時將 SWC 檔案用作 RSL 的更多資訊，請參閱運行時共用庫。   建立 Flex 庫項目 建立庫項目時，“建立 Flex 庫項目”嚮導會指導您完成相關步驟，提示您提供項目的名稱、位置和構建路徑資訊。 在 Flash Builder 中建立 SWC 檔案的第一步是建立一個 Flex 庫項目。建立庫項目之後，添加組件，指定要包括在 SWC 檔案中的庫項目元素，然後構建項目以產生 SWC 檔案。 選擇“檔案”>“建立”>“Flex 庫項目”。 輸入項目名稱，然後指定以下內容： 項目位置   預設位置為當前的工作空間。在 Windows 平台上，預設工作空間位置為 C:\Documents and Settings\username\Adobe Flash Builder\。在 Macintosh 平台上，預設工作空間位置為 /Users/username/Adobe Flash Builder/。取消選擇“使用預設位置”選項後，可以選擇其它項目位置。   配置   可以指定 Flex 庫項目是使用通用庫還是使用行動裝置庫。通用庫適用於 Web、案頭和行動裝置項目。 也可以指定 Flex 庫項目是否必須與 Flash Catalyst 相容。在這種情況下，請使用通用庫。對於與 Flash Catalyst 相容的項目，不支援行動裝置庫。   Flex SDK 版本   選擇“預設”或“特定”。還可以單擊“配置 SDK”連結，在“首選參數”首頁面上添加、編輯或刪除 SDK。   包括 Adobe AIR 庫   如果您的庫必須使用 AIR 功能（例如訪問 AIR API），請選擇此選項。然後，Flash Builder 會更改該新 Flex 庫項目的庫路徑，使該路徑包括 airglobal.swc 和 airframework.swc。基於 Web 的 Flex 項目不能使用該庫。 如果要編寫的通用庫僅用於基於 Web 的應用程式或者用於基於 Web 或 AIR 的應用程式，請不要選擇此選項。   單擊“下一步”。 （可選）設定構建路徑資訊。例如，可以將檔案夾添加到包含要包括在 SWC 檔案中的組件的項目源路徑中。還可以添加要包括在庫項目中的其它項目、檔案夾或庫 SWC 檔案。請參閱在項目中使用 SWC 檔案。 輸入完項目設定後，單擊“完成”。  有關建立 Flex 庫的最佳實務，請參閱由 Adobe Flex 社區專家 Xavi Beumala 撰寫的文章 Three points to remember when creating a library。 建立 AIR 庫項目 要為多個 Adobe AIR 項目建立 AIR 程式碼程式庫，請使用標準的 Flex 庫項目嚮導建立 Adobe AIR 庫項目。 選擇“檔案”>“建立”>“Flex 庫項目”。 指定項目名稱。 選擇“包括 Adobe AIR 庫”，然後單擊“下一步”。 根據需要修改構建路徑，然後單擊“完成”。有關建立庫項目的更多資訊，請參閱“Flash Builder 協助”中的“關於庫項目”。 將組件添加到庫項目中 可以通過以下方式將組件添加到庫項目中： 將新的或現有的自訂群組件、ActionScript 類和其它資源添加到項目中。 連結到工作空間內的其它項目中的現有組件。（請參閱連結到項目工作空間外部的資源。） 將包含組件的已連結檔案夾添加到庫項目的源路徑。（請參閱將外部資源檔夾添加到源路徑。） 註： 庫項目中包括的所有組件都必須與庫項目相關聯（直接關聯或作為連結資源關聯）。選擇要包括在 SWC 檔案中的庫項目元素 要選擇準備包括在 SWC 中的元素（組件和資源），請執行以下步驟： 選擇“項目”>“屬性”>“Flex 庫構建路徑”。 此時，添加到項目中的組件（直接添加或通過連結到這些組件來添加）會顯示在“類”選項卡中。 選擇要包括在 SWC 檔案中的組件類。 （可選）選擇“資源”選項卡，然後選擇要包括在 SWC 檔案中的資源。 進行選擇之後，單擊“確定”。 構建庫項目 如果選擇了“自動構建”選項，則選擇了要包括在 SWC 檔案中的元素之後，系統將立即對該檔案進行編譯，並將結果檔案產生到項目的輸出檔案夾中。如果您手動構建項目，則可以在需要時通過選擇“項目”>“構建項目”或“全部構建”來構建庫項目。 構建庫項目會產生一個 SWC 檔案，您可以與其它應用程式或使用者共用該檔案。 SWC 檔案是一個歸檔檔案，可以使用任何歸檔公用程式（如 WinZip）開啟 SWC 檔案。SWC 檔案中包括 library.swf 和 catalog.xml 檔案。此外，還包括屬性檔案和其它嵌入式資源。 可以將庫匯出為開放目錄而非 SWC 檔案。通常，如果計劃將 SWC 檔案中的 library.swf 檔案用作 RSL，則需要將庫匯出為開放目錄。 通過設定 directory 和 output 編譯器選項可以完成此工作。將 output 選項設定為要建立的目錄的名稱，並將 directory 選項設定為 true，說明您在構建庫時需要開放目錄而非 SWC 檔案。要編輯這些編譯器選項，請選擇“項目”>“屬性”>“Flex 庫編譯器”，並在“附加的編譯器參數”欄位中添加這些選項；例如： -directory=true -output=myOpenDir Flash Builder 將在項目中建立一個名為 myOpenDir 的目錄，並將 SWC 檔案的內容儲存到該目錄中。 在項目中使用 SWC 檔案 要在 Flex 項目中使用 SWC 檔案，需要將這些檔案添加到項目的庫路徑中。SWC 檔案可以位於項目中、Flex 庫項目中、工作空間內的共用資料夾或已連結到項目（例如，使用已添加到項目的源路徑的共用資料夾）的任何其它位置中。 在應用程式中使用 SWC 檔案時，可以通過配置選項來確定是將這些檔案靜態或動態連結到應用程式、合并到應用程式 SWF 檔案中還是放置在應用程式外部並在運行時單獨訪問。 將 SWC 檔案添加到庫路徑 在包資源管理員中選擇一個項目，然後選擇“項目”>“屬性”>“Flex 構建路徑”。 單擊“庫路徑”選項卡。 選擇下列任意選項以添加 SWC 檔案： 添加項目   添加 Flex 庫項目。   添加 SWC 檔案夾   添加包含 SWC 檔案的檔案夾。   添加 SWC   添加已編譯的 SWC 檔案。   添加 Flex SDK   添加其它 Flex SDK。如果項目的庫路徑中已包含 Flex SDK，則系統會禁用此按鈕。如果從庫路徑中刪除了現有 Flex SDK，則系統會啟用此按鈕。單擊此按鈕後，系統將添加一個 Flex SDK 節點，但不會提示您添加的是哪個節點。要控制將使用哪個 Flex SDK，請選擇“項目”>“屬性”>“Flex 編譯器”。   輸入或瀏覽並選擇 SWC 檔案、項目或檔案夾的位置。單擊“確定”。 此時，SWC 檔案、庫項目或檔案夾將添加到庫路徑中。 編譯時間將 SWC 檔案合并到應用程式 SWF 檔案中 在包資源管理員中選擇一個項目，然後選擇“項目”>“屬性”>“Flex 構建路徑”。 單擊“庫路徑”選項卡，然後選擇並展開 SWC 檔案條目以顯示 SWC 選項。 雙擊“連結類型”選項。此時，將顯示“庫路徑項選項”對話方塊。 選擇“合并到代碼中”選項，然後單擊“確定”。 此過程等效於使用 library-path 編譯器選項。 將 SWC 檔案設定為外部庫檔案 在包資源管理員中選擇一個項目，然後選擇“項目”>“屬性”>“Flex 構建路徑”。 選擇“庫路徑”選項卡，然後選擇並展開 SWC 檔案條目以顯示 SWC 選項。 雙擊“連結類型”選項。此時，將顯示“庫路徑項選項”對話方塊。 選擇“外部”選項，然後單擊“確定”。 此過程等效於使用 external-library-path 編譯器選項。 將 SWC 檔案用作 RSL 可以將應用程式的 SWF 檔案中的共用資源外部化到獨立檔案中。這些獨立檔案可以在用戶端上單獨進行下載和緩衝。共用資源只可傳送並載入到用戶端一次，但任意多個應用程式在運行時都可以使用這些共用資源。這些共用檔案稱為運行時共用庫（即 RSL）。 在包資源管理員中選擇一個項目，然後選擇“項目”>“屬性”>“Flex 構建路徑”。 選擇“庫路徑”選項卡，然後選擇並展開 SWC 檔案條目以顯示 SWC 選項。 雙擊“連結類型”選項，或者單擊“編輯”。此時，將顯示“庫路徑項選項”對話方塊。 將“運行時共用庫 (RSL)”選為連結類型。 您可以添加 URL 以指定部署應用程式時駐留 SWC 庫的位置。如有必要，也可以編輯現有 URL。 選擇“強制載入 RSL”以在編譯時間強制載入未使用的 RSL。 您可以指定應用程式定義域，在該域中必須載入跨域 RSL。 將 SWC 檔案用作 RSL 可簡化手動使用 RSL 的過程。為此，可以從 SWC 檔案中提取 SWF 檔案，然後設定 runtime-shared-library-path 編譯器選項的值。 有關將 SWC 檔案用作 RSL 的更多資訊，請參閱《使用 Adobe Flex》中的“運行時共用庫”。

使用 Flex 庫項目---打包swc