安裝或設定(Apache Flex)
有兩種方法可以設定 Apache Flex SDK。你可以使用提供的 Apache Flex SDK 安裝程式,這是一個自動執行該過程的 Adobe AIR 應用程式(在 Windows 或 OS X / macOS 上)。或者你可以手動安裝它,這顯然需要你的平臺更加舒適,但在安裝細節方面提供了更大的靈活性。
使用 Apache Flex 安裝程式安裝 Apache Flex SDK
- 下載適用於你的作業系統的安裝程式二進位制檔案(Window,Mac 或 Linux)。
- 執行安裝程式
- 選擇要下載的 SDK 版本。Apache Flex 專案建議你下載最新發布的版本。
- 選擇 Flash Player 版本。Flex 專案建議你將其保留為預設值。單擊下一步。
- 選擇要安裝 SDK 的目錄。單擊下一步。
- 檢查所有許可協議。單擊安裝。
- 等待安裝程式下載並安裝 Apache Flex SDK。
手動安裝 Apache Flex SDK
注意:這可能是一個冗長且涉及的過程。
準備你的系統
- 下載並安裝最新的 Java JDK
- 下載並安裝最新版本的 Ant
- 下載並安裝最新版本的 Git
- 下載並安裝最新的 JUnit
設定資料夾結構
- 在計算機上為 Flex SDK 建立以下目錄結構,通常儲存在根目錄或 Documents 目錄中。
/ApacheFlex
/ApacheFlex/dependencies
/ApacheFlex/source
下載原始碼
- 開啟終端並將目錄更改為:
/ApacheFlex/source
- 執行以下 git 命令以下載 Flex SDK 源:
git clone https://git-wip-us.apache.org/repos/asf/flex-sdk.git flex-sdk
- 執行以下 git 命令下載 TLF 源:
git clone https://git-wip-us.apache.org/repos/asf/flex-tlf.git flex-tlf
- 切換到 flex-sdk 目錄:
/ApacheFlex/source/flex-sdk
- 切換到’develop’分支(可選):
git checkout develop
編輯環境屬性
要使構建指令碼起作用,你需要設定環境變數。環境屬性檔案包含環境變數,這些變數指向將在整個過程中使用的依賴項的位置。各種構建指令碼使用它們來執行和編譯 SDK。你將在本教程的其餘部分中新增其他環境變數。稍後執行構建指令碼時,指令碼將驗證提供的路徑,並在它們不正確時發出警告。
- 建立環境屬性檔案:
在 flex-sdk
目錄中建立 env-template.properties
檔案的副本並將其命名為 env.properties
。
由於你已經安裝了 Java 和 Ant,因此通過在 env.properties
檔案的末尾附加以下內容來設定它們的路徑:
env.JAVA_HOME=/System/Library/Frameworks/JavaVM.framework/Versions/Current/Commands/java
env.ANT_HOME=/Applications/Ant/bin
- 接下來新增 TLF 目錄的路徑:
env.TLF_HOME=/ApacheFlex/source/flex-tlf
新增必需的依賴項
Adobe AIR SDK
- 下載 Air SDK Flex Edition( 請務必下載專為 Flex 製作的版本 )。
- 解壓到:
/ApacheFlex/dependencies/AIRSDK/4.0
最終目錄名稱是指你下載的 AIR SDK 的版本。
- 將
AIR_HOME
環境變數設定為你在上一步中選擇的 AIR SDK 路徑。例如,
env.ANT_HOME=/ApacheFlex/dependencies/AIRSDK/4.0
Adobe Flash Player 投影儀
- 下載 Flash Player 投影儀
- 執行安裝程式。Projector Content Debugger 安裝程式不會安裝到任何地方(至少對我而言)。執行安裝程式後,必須將其複製到所需的位置。在這種情況下,將其複製到
/ApacheFlex/dependencies/player
目錄。注意:在 OSX 上,將“.app / Contents / MacOS / Flash Player Debugger”附加到 Flash Player 的路徑。
/ApacheFlex/dependencies/player/Flash Player.app/Contents/MacOS/Flash Player Debugger
- 將
FLASHPLAYER_DEBUGGER
環境變數設定為投影儀的安裝路徑。
env.FLASHPLAYER_DEBUGGER=/ApacheFlex/dependencies/player/Flash Player.app/Contents/MacOS/Flash Player Debugger
你也可以使用 Flash Player 外掛。它通常位於:/ Library / Internet Plug-ins / Flash Player /完整路徑為:/ Library / Internet Plug-ins / Flash Player.app/Contents/MacOS/Flash Player Debugger
Adobe Flash Player playerglobal.swc
- 下載 playerglobal.swc - 這與你剛剛下載的內容偵錯程式位於同一頁面上。
- 將其複製到:
/ApacheFlex/dependencies/PlayerGlobal/player/12.0
數字對應於你下載的版本。
- 將複製的檔案重新命名為’playerglobal.swc'
- 將
PLAYERGLOBAL_HOME
環境變數設定為:
env.PLAYERGLOBAL_HOME=/ApacheFlex/Dependencies/PlayerGlobal/player
Adobe Pixel Bender 工具包
- 下載適用於 Windows 或 Mac 的 Pixel Bender
- 安裝 Pixel Bender。安裝程式時,它為你提供了選擇安裝位置的選項。在安裝之前複製此位置。
- 將
PIXELBENDER_HOME
環境變數設定為安裝目錄。
準備系統
對於測試,Adobe Flash Player 的 mm.cfg
檔案必須具有適當的屬性集,並且 FlashPlayerTrust
檔案必須允許本地 SWF 訪問本地檔案。
- 在編輯器中開啟
mm.cfg
檔案。mm.cfg
檔案的位置取決於你的作業系統。見本頁 。 - 如果它不存在,請手動啟動 Adobe Flash Player 投影儀內容除錯程式,它應該在那時建立
mm.cfg
。 - 新增或驗證檔案中包含以下條目:
ErrorReportingEnable=1
TraceOutputFileEnable=1
- 與 mm.cfg 檔案在同一目錄中的是 FlashPlayerTrust 目錄。
- 開啟該目錄並建立一個名為 ApacheFlex.cfg 的新文字檔案。
- 在該檔案中新增 Apache Flex SDK 的父目錄。例如:
#Path to Apache Flex Source
/ApacheFlex/source
- 儲存檔案。
設定構建屬性
- 在 flex-sdk 目錄中是構建屬性檔案。它包含你下載的軟體的版本號。
- 開啟此檔案並將以下值設定為你正在使用的 Flash Player 和 AIR SDK 的版本:
# Flash player version for which player global swc to use
playerglobal.version = 12.0
# AIR version number
air.version = 4.0
這些值用於構建 SDK 的路徑。因此,如果你將 playerglobal.swc 儲存到以下目錄:/ApacheFlex/dependencies/PlayerGlobal/player/12.0,則 playerglobal.version 的值將為 12.0。
注意:由於此值構建路徑,請確保使用完整值 12.0,而不是 12,如果路徑包含它。
注意:如果你使用的是正在使用的 Flex SDK 版本中尚未提及的新版 Flash Player,則可能會收到以下訊息:錯誤:配置變數’swf-version’值包含未知令牌’playerglobal .swfversion’你需要使用更新的版本檢查程式碼更新
/ApacheFlex/source/flex-sdk/frameworks/build.xml
檔案。