royale-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject [] branch master updated: Changed description to use launch configurations.
Date Thu, 16 Nov 2017 13:43:22 GMT
This is an automated email from the ASF dual-hosted git repository.

pent pushed a commit to branch master
in repository

The following commit(s) were added to refs/heads/master by this push:
     new 2beca8e  Changed description to use launch configurations.
2beca8e is described below

commit 2beca8eaef9550ffac747f694484b689fadf2f24
Author: Peter Ent <>
AuthorDate: Thu Nov 16 08:43:20 2017 -0500

    Changed description to use launch configurations.
--- | 33 ++++++++++++++++++++++++++++-----
 1 file changed, 28 insertions(+), 5 deletions(-)

diff --git a/ b/
index d15f2e3..f4f8ae8 100644
--- a/
+++ b/
@@ -35,6 +35,19 @@ Start Flash Builder and open its preferences. Navigate to the "Flash Builder"
 As an option, you can select it from the list and make it the default SDK if you plan on
creating mostly Royale applications.
+## Import Launch Configurations
+In Flash Builder, "launch configurations" provide scripts that perform useful tasks. The
Royale package comes with a set of launch configurations to do things like build a JavaScript
version of your application. Follow these steps to bring the Royale launch configurations
into Flash Builder:
+1. In Flash Builder, select the "File" menu and "Import".
+1. Find the "Run/Debug" section and expand it. 
+1. Pick "Launch Configurations", then "Next".
+1. In the dialog that appears, browse to the "ide/flashbuilder" sub-directory in the Royale
SDK directory.
+1. Select "flashbuilder" in the left pane or pick the check box next to it, selecting all
of the launch configurations.
+1. Pick Finish.
+The launch configurations will be imported and appear in the "Run" - "External Tools" menu.
 ## 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.
@@ -44,10 +57,15 @@ Go to the "File" menu and pick "New Flex Project". In the dialog that
appears, e
 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="" layout="absolute"min_size>

+        <application xmlns:fx="" layout="absolute"min_size>

-Delete this code and replace it with:
+You can convert this initial file into a working Royale application as follows:
+1. Select the project's name in the Package Explorer.
+1. From the "Run" menu, pick "External Tools" and then "Convert New Flex Project to Royale
+After a few moments the file's contents will be replaced with:
     <js:Application xmlns:fx=""
                    xmlns:js="library://" >
@@ -59,12 +77,17 @@ Delete this code and replace it with:
         	<js:Label text="Hello World!" />
-    </js:Application>
+    </js:Application> 
-Save this file and run it as a Web Application. 
+Now you can 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.
\ No newline at end of file
+Flash Builder normally builds applications to run in the Flash Player. But Royale is designed
to also run as JavaScript/HTML natively in the browser. To do this, your Royale ActionScript
and MXML files need to be cross-compiled (or "transpiled") into JavaScript. Flash Builder
can do this a launch configuration tool.
+1. Select either your project in the Package Explorer or select the main application MXML
+1. From the "Run" menu, pick "External Tools" and "ASJSC (Debug Build)"
+Flash Builder will launch the compiler to convert your application into JavaScript. The result
be in the bin/js-debug directory. In that directory will be an index.html file you can open
from your browser.
\ No newline at end of file

To stop receiving notification emails like this one, please contact
['"" <>'].

View raw message