This is an automated email from the ASF dual-hosted git repository.
carlosrovira pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/royale-asjs.wiki.git
The following commit(s) were added to refs/heads/master by this push:
new ae23f51 Updated Build Apache Royale with Maven (markdown)
ae23f51 is described below
commit ae23f51c9be89c30f0e513074b8424efbabaa456
Author: Carlos Rovira <carlosrov...@apache.org>
AuthorDate: Fri Nov 17 20:22:01 2017 +0100
Updated Build Apache Royale with Maven (markdown)
---
Build-Apache-Royale-with-Maven.md | 79 +++++++++++++++++++++------------------
1 file changed, 43 insertions(+), 36 deletions(-)
diff --git a/Build-Apache-Royale-with-Maven.md
b/Build-Apache-Royale-with-Maven.md
index 12536f7..eb285bc 100644
--- a/Build-Apache-Royale-with-Maven.md
+++ b/Build-Apache-Royale-with-Maven.md
@@ -6,69 +6,76 @@ Apache Royale can be built with maven. Royale consists of
three parts: The _comp
In addition to building the framework libraries, the framework module also
assembles the binary distribution of the Royale SDK.
-It also has a feature of **assembling a fully functional FlexJS distribution**
in a directory of choice, by setting an additional environment variable:
_distributionTargetFolder_. If you set this to the path of a directory, the
build will create a distribution there. This can then be used directly in your
IDE of choice.
+It also has a feature of **assembling a fully functional Royale distribution**
in a directory of choice, by setting an additional environment variable:
_distributionTargetFolder_. If you set this to the path of a directory, the
build will create a distribution there. This can then be used directly in your
IDE of choice.
## Steps
1. Install Java from:
http://www.oracle.com/technetwork/java/javase/downloads/index.html
-2. Install Maven 3.3.1 or greater from: http://maven.apache.org/download.cgi
(I used 3.3.9)
+2. Install Maven 3.3.1 or greater from: http://maven.apache.org/download.cgi
(I'm using 3.5.0)
1. Download the archive
2. Unpack the archive
3. Set your systems PATH to the bin directory (I usually define a
MAVEN_HOME to the unpacked directory and then add $MAVEN_HOME/bin to the PATH)
3. Download the "Flash Player projector content debugger" for your system
from: https://www.adobe.com/support/flashplayer/debug_downloads.html (The
Browser plugin or ActiveX component will not work)
1. Set an environment variable called FLASHPLAYER_DEBUGGER and set it to
the path of the Flash Debug Player executable (On windows and Linux machined
this is trivial as you simply provide the full path (including the executable
name), on Mac's this will look something like this: {Place the Player is
installed to}/Flash Player.app/Contents/MacOS/Flash Player Debugger)
+
Example for Windows:
-`FLASHPLAYER_DEBUGGER=C:\Program Files\Adobe\Flash\flashplayer_22_sa_debug.exe`
+ `FLASHPLAYER_DEBUGGER=C:\Program
Files\Adobe\Flash\flashplayer_22_sa_debug.exe`
Example for Linux:
-`FLASHPLAYER_DEBUGGER=/opt/adobe/flash/flashplayer_11_sa_debug.i386/flashplayerdebugger`
+
`FLASHPLAYER_DEBUGGER=/opt/adobe/flash/flashplayer_11_sa_debug.i386/flashplayerdebugger`
Example for Mac:
-`FLASHPLAYER_DEBUGGER=/Applications/Adobe/Flash/22.0/Flash
Player.app/Contents/MacOS/Flash Player Debugger`
+ `FLASHPLAYER_DEBUGGER=/Applications/Adobe/Flash/22.0/Flash
Player.app/Contents/MacOS/Flash Player Debugger`
-4. Build Compiler (flex-falcon)
+4. Build Compiler (royale-compiler)
1. Clone:
-`git clone https://github.com/apache/royale-compiler.git royale-compiler`
+ `git clone https://github.com/apache/royale-compiler.git royale-compiler`
2. Go into the new directory:
-`cd royale-compiler
-git checkout develop'
+ `cd royale-compiler
+ git checkout develop'
+
+ 3. Build the compiler:
+ `mvn -s settings-template.xml clean install`
+
+ This will execute all unit-tests and integration-tests. You can however
run the build without any tests:
+ `mvn -s settings-template.xml -DskipTests clean install`
+
+ And if you just want to run the unit-tests and skip the
integration-tests:
+ `mvn -s settings-template.xml -DskipITs clean install`
+
+ Note: we are fixing the text due to the migration, so you need to add
-DskipTests to the line above to get a successful build. We'll remove this
line when we fix all the test.
-Build the compiler:
-`mvn -s settings-template.xml clean install`
-This will execute all unit-tests and integration-tests. You can however run
the build without any tests:
-`mvn -s settings-template.xml -DskipTests clean install`
+5. Build Typedefs (royale-typedefs)
-And if you just want to run the unit-tests and skip the integration-tests:
-`mvn -s settings-template.xml -DskipITs clean install`
+ 1. Clone:
+ `git clone https://github.com/apache/royale-typedefs.git royale-typedefs
-Note: we are fixing the text due to the migration, so you need to add
-DskipTests to the line above to get a successful build. We'll remove this line
when we fix all the test.
+ 2. Go into the new directory:
+ `cd royale-typedefs
+ git checkout develop`
+ 3. Build the typedefs:
+ `mvn -s settings-template.xml clean install`
-Build Typedefs (flex-typedefs)
-Clone:
-git clone https://github.com/apache/royale-typedefs.git royale-typedefs
+6. Build the Framework (royale-asjs)
-Go into the new directory:
-cd royale-typedefs
-git checkout develop
+ 1. Clone:
+ `git clone https://git-wip-us.apache.org/repos/asf/royale-asjs.git
royale-asjs`
+
+ 2. Go into the new directory:
+ `cd royale-asjs
+ git checkout develop`
-Build the typedefs:
-mvn -s settings-template.xml clean install
+ 3. Build the framework libs:
+ `mvn -s settings-template.xml clean install`
-Build the Framework (royale-asjs)
-Clone:
-git clone https://git-wip-us.apache.org/repos/asf/royale-asjs.git royale-asjs
+ optionally you can also build the distribution binaries:
+ `mvn -s settings-template.xml -P build-distribution clean install`
-Go into the new directory:
-cd royale-asjs
-git checkout develop
+ optionally you can also build the distribution binaries and a local
distribution (including dependencies for Flash, AIR) in a local directory:
+ `mvn -s settings-template.xml
-DdistributionTargetFolder={pathToDistributionDirectory} -P build-distribution
clean install`
-Build the framework libs:
-mvn -s settings-template.xml clean install
-optionally you can also build the distribution binaries:
-mvn -s settings-template.xml -P build-distribution clean install
-optionally you can also build the distribution binaries and a local
distribution (including dependencies for Flash, AIR) in a local directory:
-mvn -s settings-template.xml
-DdistributionTargetFolder={pathToDistributionDirectory} -P build-distribution
clean install
\ No newline at end of file
+The reason for specifying the "-s settings-template.xml" is that we currently
are using unreleased artifacts for the mavenizer. If we don't explicitly tell
maven to also look in the Apache Snapshot Repo, it will not find these. This
option will no longer be needed as soon as we have released the Mavenizer for a
first time.
\ No newline at end of file
--
To stop receiving notification emails like this one, please contact
['"commits@royale.apache.org" <commits@royale.apache.org>'].
