安装或设置(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 文件。