Flash Builder 4.7

THIS PAGE IS STILL UNDER CONSTRUCTION <

Follow these instructions to use Flash Builder 4.7 for developing Royale applications. These instructions will guide you through building the Royale SDK and making modifications to your Flash Builder 4.7 installation so that it recognizes Royale.

Modify Flash Builder 4.7 Installation

You need to upgrade Flash Builder to run with Java 7 or Java 8. This link will take you to those instructions: http://blogs.adobe.com/flashplayer/2016/09/running-adobe-flash-builder-on-mac-with-java-78.html

Build Royale SDK

As of this writing, a special installer is not yet working for Royale, so these instructions use the Github Royale repository. There are also special launch configuration tools that can help you use Flash Builder with Royale, but they are not yet working as of this writing.

Clone the royale-asjs repository for Royale SDK from Github. Once that has done, build it in its entirety:

% ant

This will build Royale ASJS, downloading third-party software as needed (you will need to answer some questions along the way).

Once the build has completed, you need to turn this into an SDK that Flash Builder 4.7 will recognize.

% ant -f InstallAdobeSDKs.xml

The InstallAdobeSDKs.xml ANT script requires additional items to be downloaded. The script will not download them for you, but will give you instructions and pause so you can download them yourself. Once each piece is downloaded, press any key to move to the next until all parts have been downloaded.

The script then finishes on its own and the royale-asjs repository is now ready for you to use with Flash Builder 4.7

Configure Flash Builder 4.7

Add the Royale SDK

Start Flash Builder and open its preferences. Navigate to the "Flash Builder" section and "Installed Flex SDKs". In the dialog that is presented, use the "Browse" button to locate the directory you just built and configured with ANT. Pick "OK" to install it.

As an option, you can select it from the list and make it the default SDK if you plan on creating mostly Royale applications.

Creating a Royale Project

As a test, create a sample Royale application. Keep in mind that Flash Builder will refer to these as Flex projects.

Go to the "File" menu and pick "New Flex Project". In the dialog that appears, enter the name for your sample (e.g., "Hello World") and select the Royale SDK you have just installed. Pick "Finish".

Flash Builder will create a sample application, but it will not have the correct Royale code in it:

<?xml version="1.0" encoding="utf-8"?>
<application xmlns:fx="http://ns.adobe.com/mxml/2009" layout="absolute"min_size>	
</application>

Delete this code and replace it with:

<js:Application xmlns:fx="http://ns.adobe.com/mxml/2009"
               xmlns:js="library://ns.apache.org/royale/basic" >
    <js:valuesImpl>
        <js:SimpleCSSValuesImpl />
    </js:valuesImpl>
    <js:initialView>
        <js:View>
    	<js:Label text="Hello World!" />
        </js:View>
    </js:initialView>
</js:Application>

Save this file and run it as a Web Application.

At this point you can create, run, and debug Royale applications from Flash Builder. The applications will use the Flash Player.

Building Applications for the Browser

The special launch configuration tools (not yet available) will be able to compile your Royale code into JavaScript and run the application directly in a browser. Please stay tuned.