Jangaroo Flash Application Project Template for FlashDevelop

For Jangaroo background information, please visit the Jangaroo Home Page.

You need to have installed the usual Jangaroo prerequisites

1. Java 6 and
2. Maven 3.

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"

Now, install FlashDevelop.

To set up the Jangaroo Flash Project template for FlashDevelop

1. Download this project as a ZIP,
2. unzip the subfolder 190 ActionScript 3 - Jangaroo Flash Project contained in the archive into the Projects directory of your FlashDevelop installation. (You may have to unzip to a temporary directory and copy over to the program directory to be asked for admin rights.)

Then, you can create Jangaroo HTML5 Flash Applications from FlashDevelop using

1. Project | New Project...

2. Select Jangaroo Flash Project from the list.

3. Fill in desired Name, Location and Package of your new project.

   Please do not leave the Package field empty, or jooflash.html will not point to the correct Main class!

   You usually want to check Create directory for 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 application. Now you can edit source code, click Build Project again, and watch the result in the browser window. If changes do not appear, try clearing the browser cache.

For debugging, please have a look at the Jangaroo debugging tutorial.

Optional Setup

Loading the application from the local filesystem has some disadvantages. IE keeps on asking whether you want local scripts to execute. Debugging is not as nice, as Firebug's Network tab stays empty. Ajax requests (which jooflash uses for [Embed(...)] of text files) do not work.

To improve the situation, Maven allows starting a local Web server serving your Web app in three simple steps:

1. In FlashDevelop, open the file pom.xml by double-clicking it in the Project window.
2. By clicking the Command Prompt button, a command window opens. The current path should be your project root directory, otherwise cd into it.
3. Enter mvn jetty:run. A Jetty Web server is started, serving your Web application at http://localhost:8080/.

To let FlashDevelop open this page in firefox after build, change Project Properties | Build | Post-Build Command Line to

cmd /C "start http://localhost:8080"

or, to invoke the debuggable version, use

cmd /C "start http://localhost:8080/jooflash.html#joo.debug"