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