安裝或設定(Apache Flex)

有兩種方法可以設定 Apache Flex SDK。你可以使用提供的 Apache Flex SDK 安裝程式,這是一個自動執行該過程的 Adobe AIR 應用程式(在 Windows 或 OS X / macOS 上)。或者你可以手動安裝它,這顯然需要你的平臺更加舒適,但在安裝細節方面提供了更大的靈活性。

使用 Apache Flex 安裝程式安裝 Apache Flex SDK

  1. 下載適用於你的作業系統的安裝程式二進位制檔案(Window,Mac 或 Linux)。
  2. 執行安裝程式
  3. 選擇要下載的 SDK 版本。Apache Flex 專案建議你下載最新發布的版本。
  4. 選擇 Flash Player 版本。Flex 專案建議你將其保留為預設值。單擊下一步
  5. 選擇要安裝 SDK 的目錄。單擊下一步
  6. 檢查所有許可協議。單擊安裝
  7. 等待安裝程式下載並安裝 Apache Flex SDK。

手動安裝 Apache Flex SDK

注意:這可能是一個冗長且涉及的過程。

準備你的系統

  1. 下載並安裝最新的 Java JDK
  2. 下載並安裝最新版本的 Ant
  3. 下載並安裝最新版本的 Git
  4. 下載並安裝最新的 JUnit

設定資料夾結構

  1. 在計算機上為 Flex SDK 建立以下目錄結構,通常儲存在根目錄或 Documents 目錄中。
/ApacheFlex
/ApacheFlex/dependencies
/ApacheFlex/source

下載原始碼

  1. 開啟終端並將目錄更改為:
/ApacheFlex/source
  1. 執行以下 git 命令以下載 Flex SDK 源:
git clone https://git-wip-us.apache.org/repos/asf/flex-sdk.git flex-sdk
  1. 執行以下 git 命令下載 TLF 源:
git clone https://git-wip-us.apache.org/repos/asf/flex-tlf.git flex-tlf
  1. 切換到 flex-sdk 目錄:
/ApacheFlex/source/flex-sdk
  1. 切換到’develop’分支(可選):
git checkout develop

編輯環境屬性

要使構建指令碼起作用,你需要設定環境變數。環境屬性檔案包含環境變數,這些變數指向將在整個過程中使用的依賴項的位置。各種構建指令碼使用它們來執行和編譯 SDK。你將在本教程的其餘部分中新增其他環境變數。稍後執行構建指令碼時,指令碼將驗證提供的路徑,並在它們不正確時發出警告。

  1. 建立環境屬性檔案:

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
  1. 接下來新增 TLF 目錄的路徑:
env.TLF_HOME=/ApacheFlex/source/flex-tlf

新增必需的依賴項

Adobe AIR SDK

  1. 下載 Air SDK Flex Edition( 請務必下載專為 Flex 製作的版本 )。
  2. 解壓到:
/ApacheFlex/dependencies/AIRSDK/4.0

最終目錄名稱是指你下載的 AIR SDK 的版本。

  1. AIR_HOME 環境變數設定為你在上一步中選擇的 AIR SDK 路徑。例如,
env.ANT_HOME=/ApacheFlex/dependencies/AIRSDK/4.0

Adobe Flash Player 投影儀

  1. 下載 Flash Player 投影儀
  2. 執行安裝程式。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
  1. 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

  1. 下載 playerglobal.swc - 這與你剛剛下載的內容偵錯程式位於同一頁面上。
  2. 將其複製到:
/ApacheFlex/dependencies/PlayerGlobal/player/12.0

數字對應於你下載的版本。

  1. 將複製的檔案重新命名為’playerglobal.swc'
  2. PLAYERGLOBAL_HOME 環境變數設定為:
env.PLAYERGLOBAL_HOME=/ApacheFlex/Dependencies/PlayerGlobal/player

Adobe Pixel Bender 工具包

  1. 下載適用於 WindowsMac 的 Pixel Bender
  2. 安裝 Pixel Bender。安裝程式時,它為你提供了選擇安裝位置的選項。在安裝之前複製此位置。
  3. PIXELBENDER_HOME 環境變數設定為安裝目錄。

準備系統

對於測試,Adobe Flash Player 的 mm.cfg 檔案必須具有適當的屬性集,並且 FlashPlayerTrust 檔案必須允許本地 SWF 訪問本地檔案。

  1. 在編輯器中開啟 mm.cfg 檔案。mm.cfg 檔案的位置取決於你的作業系統。見本頁
  2. 如果它不存在,請手動啟動 Adobe Flash Player 投影儀內容除錯程式,它應該在那時建立 mm.cfg
  3. 新增或驗證檔案中包含以下條目:
ErrorReportingEnable=1
TraceOutputFileEnable=1
  1. 與 mm.cfg 檔案在同一目錄中的是 FlashPlayerTrust 目錄。
  2. 開啟該目錄並建立一個名為 ApacheFlex.cfg 的新文字檔案。
  3. 在該檔案中新增 Apache Flex SDK 的父目錄。例如:
#Path to Apache Flex Source
/ApacheFlex/source
  1. 儲存檔案。

設定構建屬性

  1. 在 flex-sdk 目錄中是構建屬性檔案。它包含你下載的軟體的版本號。
  2. 開啟此檔案並將以下值設定為你正在使用的 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 檔案。