For Jangaroo background information, please visit the Jangaroo Home Page.
To build the application yourself and play around with the code, you need to have installed the usual Jangaroo prerequisites
Note that you do not have to download and / or install Jangaroo itself!
Checkpoint: opening a command prompt and entering
mvn -v should output something like
Apache Maven 3.0.2 (r1056850; 2011-01-09 01:58:10+0100) Java version: 1.6.0_21, vendor: Sun Microsystems Inc. Java home: C:\Program Files\Java\jdk1.6.0_21\jre Default locale: de_DE, platform encoding: Cp1252 OS name: "windows 7", version: "6.1", arch: "amd64", family: "windows"
If you want to start your own Jangaroo Flash project from scratch, have a look at the Jangaroo Flash Application Template or, if you work with FlashDevelop (see below), the FlashDevelop Project Template for Jangaroo Flash Applications here on github.
Otherwise, download and unzip the "Jumper" project files (if you have
git installed, you can of course also clone the repository):
- Press the
Downloadsbutton at the top right of this page,
Download .zip, and
- unzip to a directory of your choice
Starting the Web Server
For technical reasons, most Jangaroo Flash applications, like most Web applications in general, cannot be run from the local file system (security issues). Fortunately, Maven also allows starting a local Web server serving your Web app in three simple steps:
- open a command prompt
cdinto your project root directory
A Jetty Web server is started, serving your Web application at
Now, you can open this URL in your favorite Web browser and try the game.
You can use several IDEs to work with AS3 source code. Currently, the best IDE for Jangaroo development is IntelliJ IDEA 10 Ultimate, but since you probably prefer a free IDE, the following "getting started" refers to FlashDevelop. FlashDevelop is Windows-only (I think there is an experimental Mac version).
So please start by downloading and installing the latest version of FlashDevelop.
Then, double-click the provided file
jumper.as3proj (located directly inside the unpacked zip), which should launch FlashDevelop, opening the project.
Now you can build the project using the
Build Project toolbar button. Maven is invoked and compiles and builds your Web application.
Then, your default browser opens your Jangaroo Jumper game!
Now you can edit source code, using FlashDevelop's nice code assist features, click
Build Project again, and watch the result in the browser window.
Note that for every turn-around, a new browser window is opened, so be sure to close the old one. If you do not want FlashDevelop to open a new browser window, click on the
Project Properties button, then on the
Build tab, and clear the
Post-Build Command Line. Then, the most convenient round-trip is to rebuild the project,
Alt-Tab to the existing browser window and hit
If code changes do not appear in the browser, try clearing the browser cache.