Setup Development Environment
At this stage, you will need to install the following software:
-
Eclipse IDE (we recommend the modeling version): http://www.eclipse.org/downloads/packages/eclipse-modeling-tools/lunar. You should save it under
D:\Java - Web Tool Platform (WTP): http://download.eclipse.org/webtools/downloads/ choose the link for "Tool Developers". After you download the archive, you should copy-paste it in eclipse's folder (the 2 folders in the archive, features and plugins, should be placed directly in eclipse's root folder). The most recent version of WTP at this moment (15.07.2014) is 3.6.0
-
m2e Maven to Eclipse: should be installed through Eclipse's update sites (as explained here ). For Website Location URL, you should use [this] (https://www.eclipse.org/m2e/download/), the recommend link/latest release. Make sure that "Contact all update ..." is marked (it should be marked by default)
Download:
- Apache Flex Installer helper from here. Next, select version 4.12.1 of SDK and 11.2 Flash Player version. You should download it in
C:\Program Files\Adobe\Flash Builder\ sdks\in a new folder (e.g. 4.12.1-fp11.2).
Note: if you put the SDK in a subdir of Program Files (as in the example above), you may need to run the Flex Installer Util as admin (after you have installed the Flex Installed Util).
For compiling you can use either the command prompt, or your preferred IDE. The following is an example of configuration settings in Flash Builder.
Configurations:
- in Eclipse: Windows -> Preferences -> General -> Workspace -> "Refresh Using native..." (make sure it is marked; by default it is NOT marked);
- Windows -> Preferences -> Flash Builder -> Installed Flash SDKs -> Add (you should navigate to the folder where you saved your sdk; in our example that is:
C:\Program Files\Adobe\Adobe Flash Builder 4.7 (64 Bit)\sdks\4.12.1-fp11.2s); then we mark it as the default sdk.
To clone a Git repository and Import a project, you should follow the next steps:
- switch to Git Repository perspective;
- clone the following git HTTPS clone link: https://github.com/flower-platform/flower-platform-4.git (we recommend you to clone it under D:\data\git)
- right-click "Add existing repositories" -> D:\data\git\flower-platform-4; then, right-click on the repository, "Import projects". You should mark for import the following projects: inside flex, you should mark for import all the project that start with "org.flowerplatform.flex...". Inside Eclipse, you should import everything.
To run Flower Platform, you should simply press the "Run" button in the toolbar above the workspace (small green triangle/arrow icon) Note: if you changed the configuration of any of the plugins under org.flowerplatform.product -> flowerplatform.product, then you should run the application using the top-right green arrow, NOT the one described above. This will allow you to run using the changes.
First of all, in Eclipse, you should change the target platform, the platform (Eclipse version and plugins) that you want to use while running the application. You can do this from Package Explorer -> org.flowerplatform.product -> double click on flowerplatform.product, eclipse4.3.2target -> Set as Target Platform (this step might take a while to perform). More details about target platforms here.
Flower Platform's entry point is the project org.flowerplatform.host.web_app (web-project). To run it (like for any other Eclipse web-application) you should right-click on the project and choose "Run as -> web application". If this is your first time running it, you might have to configure a new instance of a server (in our case, a new Tomcat instance), and the to right-click on that instance ( Server(Tomcat v7.0 Server at localhost) in our case) -> Add and Remove -> and you should move the project from the left side (available projects), to the right side (configure), in order for the server to know what to run.