This is the setup for developers working with the source code. If you only want to build applications with the Falcon and FalconJX compilers, see: Getting Started with the Falcon and FalconJX Compilers.
First you will need the following prerequisites:
A. Java SE JDK 1.6 or later
Some computers come with Java installed, but not only do you need a Java runtime (JRE) you need a Java Development Kit (JDK). To find out if you have a JDK installed run
javac -version |
The Java Compiler (javac) should print out its version if its already installed. If not, download and install a JDK from http://www.oracle.com/technetwork/java/javase/downloads/index.html. Then:
B. Apache Ant
C. Adobe AIR SDK
D. Adobe Flash Player playerglobal.swc
E. Adobe Flash Player Projector Content Debugger
"/Users/myusername/adobe/flashplayer/18.0/Flash Player Debugger.app/Contents/MacOS/Flash Player Debugger" (without quotes) and on Windows, if you store the Debugger in c:\adobe\flashplayer\18.0\flashplayer_18_sa_debug.exe, you would set the environment variable to c:\adobe\flashplayer\18.0\flashplayer_18_sa_debug.exe.
F. Git
Git is a source code management application. Some computers come with Git installed. To find out if you have Git installed run
git --version |
Git should print out its version if it is already installed. If not, install Git for your platform from here: http://git-scm.com/downloads. Many folks prefer GUI versions of Git, which is fine as long as there is a command-line version as well. Add Git to your PATH environment variable.
Downloading and Building the Source
Get the source code from Apache Git via
git clone https: //git-wip-us.apache.org/repos/asf/flex-asjs flex-asjs cd flex-falcon git checkout develop |
Get the Flex SDK code from Apache Git at
git clone https: //git-wip-us.apache.org/repos/asf/flex-sdk.git flex-sdk cd flex-sdk git checkout develop |
Get the TLF code from Apache Git at
Using Eclipse
We are using Eclipse Helios for Java 1.6 compatibility because at least one of the jars (flex-oem-compiler) needs to be 1.6 compatible to work with Flash Builder. There are eclipse project files in the flex-falcon repo. The run/debug configuration for building a FlexJS SWF in Eclipse needs the following settings (Assuming the path to the flex-asjs repo is /Users/myusername/git/apache/flex/flex-asjs):
Program Arguments:
+flexlib= "/Users/myusername/git/apache/flex/flex-asjs/frameworks" -debug /Users/myusername/git/apache/flex/flex-asjs/examples/flexjs/DataBindingExample/src/DataBindingExample.mxml |
VM Arguments:
-Xmx384m -Dsun.io.useCanonCaches= false -Dflexcompiler= "/Users/myusername/git/apache/flex/flex-falcon/compiler" -Dflexlib= "/Users/myusername/git/apache/flex/flex-asjs/frameworks" |
And the environment variables:
PLAYERGLOBAL_HOME points to the folder containing versions of playerglobal.swc as specified above. Thus, if you followed the instructions above on a Mac, you would set the variable to: /Users/myusername/adobe/flashplayer
For cross-compiling with FalconJX the Program Arguments are:
+flexlib= "/Users/myusername/git/apache/flex/flex-asjs/frameworks" -debug /Users/myusername/git/apache/flex/flex-asjs/examples/flexjs/DataBindingExample/src/DataBindingExample.mxml -js-output-type=FLEXJS
|