Apache Royale OS X development environment in five minutes

Five Steps

This is a step by step guide on how to install build a development environment on macOS. The tool used in this guide for building Apache Royale is Maven.

1. Download and Install Xcode from Apple macOS App Store, since this will be required in the next step.

2. Install Homebrew. This will software make very easy to install/uninstall the rest of required software pieces.

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Note: this step will download and install latest Xcode Command Line Tools

3. Install Java. At the time of this writing, the latest Java version is 21. You can install latest version with the following command:

brew cask install openjdk

Or a previous version (Royale needs Java 8 or later). For example, to install Java 8, you can run this command:

brew cask install openjdk@8

4. Install Maven (latest at the time I write this is 3.5.4)

brew install maven

5. Install Git (latest at the time I write this is 2.18.0)

brew install git

From this point you can start cloning Apache Royale repositories. You need at least royale-compiler, royale-typedefs and royale-asjs, and they should be built in that order. You can go to step 4 in this url:

https://github.com/apache/royale-asjs/wiki/Build-Apache-Royale-with-Maven

Optional

Following steps are not required but will make your life easier:

6. Install Jenv (http://www.jenv.be). This tool make easy to manage different Java versions

brew install jenv

7. Check Java versions

jenv versions

In my case: 

• system (set by /Users//.jenv/version) (installed on /Library/Java/JavaVirtualMachines/jdk1.8.0_181.jdk) If you install more java versions the list is populated with all versions and the one in use will show * to the left.

8. Check $JAVA_HOME

jenv exec bash

echo $JAVA_HOME

this outputs: /Users//.jenv/versions/system