Difference between revisions of "How to setup Eclipse/RAP"

From NetXMS Wiki
Jump to navigation Jump to search
m (Text replacement - "^" to "{{deprecated}}")
 
(25 intermediate revisions by 5 users not shown)
Line 1: Line 1:
= Eclipse and Target Platform setup =
{{deprecated}}= Eclipse and Target Platform setup =


* Download Eclipse 4.2 SR2 from http://www.eclipse.org/downloads/packages/eclipse-ide-java-developers/junosr2
* Download Eclipse 4.15 (2020-03) for RCP and RAP Developers from https://www.eclipse.org/downloads/eclipse-packages/
* Unpack and run
* Unpack and run
* Help -> Install New Software -> add new source "RAP 2.1 Tooling" - http://download.eclipse.org/rt/rap/tools/2.1
* Install "Remote Application Platform (RAP)" from that source
* Create directory somewhere on file system (I'll use /Users/alk/Documents/RAP)
* Copy com.ibm.icu_4.4.2.v20110823.jar from Eclipse runtime to /Users/alk/Documents/RAP
* Go to Window -> Preferences -> Plugin-in Development -> Target Platform, click "Add", initialize target definition with "Nothing"
* Go to Window -> Preferences -> Plugin-in Development -> Target Platform, click "Add", initialize target definition with "Nothing"
* Change name to something like 'RAP 2.1"
* Change name to something like 'RAP 3.12"
* (still in target content editor) Add software site http://download.eclipse.org/releases/juno, '''uncheck''' "Include Required Software" and install "EMF - Eclipse Modeling Framework SDK" (from Modeling)
* (still in target content editor) Add software site http://download.eclipse.org/releases/2019-06, '''uncheck''' "Include Required Software" and install "EMF - Eclipse Modeling Framework SDK" (from Modeling) and "BIRT Framework" (from Business Intelligence, Reporting and Charting)
* Add software site http://download.eclipse.org/releases/indigo, '''uncheck''' "Include Required Software" and install "BIRT Framework" (from Business Intelligence, Reporting and Charting)
* Add software site http://download.eclipse.org/rt/rap/3.12, '''uncheck''' "Include Required Software" and install everything
* Add software site http://download.eclipse.org/rt/rap/2.1, '''uncheck''' "Include Required Software" and install everything
* Add software site http://www.netxms.org/eclipse/zest-rap/, '''uncheck''' "Include Required Software" and install everything
* Add software site http://download.eclipse.org/rt/rap/incubator/nightly, '''uncheck''' "Include Required Software" and install "RAP ClientScripting", "RAP File Upload Support", and "RAP GEF Port".
* Add software site http://download.eclipse.org/tools/orbit/downloads/drops/R20170919201930/repository, '''uncheck''' "Include Required Software" and install "ICU4J" and "Apache Commons Codec 1.9.0"
* Add software site http://download.eclipse.org/technology/babel/update-site/R0.11.0/indigo, '''uncheck''' "Include Required Software" and install "Babel Language Pack for eclipse" and "Babel Language Pack for rt.rap" (Chinese Simplified, Czech, German, Russian, Spanish).
* Add software site http://download.eclipse.org/technology/babel/update-site/R0.17.1/2019-12/, '''uncheck''' "Include Required Software" and install "Babel Language Pack for eclipse" and "Babel Language Pack for modeling.emf" (Arabic, Czech, French, German, Portuguese, Portuguese (Brazilian), Russian, Spanish)
* Add directory /Users/alk/Documents/RAP


Is should be like this:
Is should be like this:


[[File:rap_2_1_m1_target_platform.png]]
[[File:RAP 3.12 Target Platform.png|724px]]


* Install Apache maven from http://maven.apache.org/download.html
* Import existing project from src/java-common into workspace


* In trunk/src/java, run package.sh (or package.cmd on Windows)
* Import existing project from src/client/java into workspace


* Import existing projects from trunk/webui/webapp into workspace, it should build fine.
* Import existing projects from webui/webapp into workspace


= Run Configuration =
= Run Configuration =
Line 34: Line 29:
* Filter for "http.jetty" and select "org.eclipse.equinox.http.jetty"
* Filter for "http.jetty" and select "org.eclipse.equinox.http.jetty"
* Filter for "console" and select "org.eclipse.equinox.console"
* Filter for "console" and select "org.eclipse.equinox.console"
* Filter for "felix*shell" and select orf.apache.felix.gogo.shell
* Filter for "felix*shell" and select org.apache.felix.gogo.shell
* Clear filter field and click "Add Required Bundles"
* Clear filter field and click "Add Required Bundles"
* Uncheck "com.ibm.icu.base" - only "com.ibm.icu" must be selected
* Uncheck "com.ibm.icu.base" - only "com.ibm.icu" must be selected
Line 43: Line 38:


= WAR export =
= WAR export =
* From http://download.eclipsesource.com/~hstaudacher/warproducts/3.7/ software site install "WAR Products (Incubator)"
 
* Open "nxmc.warproduct" and click on "Export"
Use Apache Maven:
 
# updates versions in pom files
mvn -f webui/webapp/pom.xml -Dtycho.mode=maven org.eclipse.tycho:tycho-versions-plugin:update-pom -Pweb
# build console
mvn -f webui/webapp/pom.xml clean package -Pweb -Dtycho.disableP2Mirrors=true
 
Build will be in webui/webapp/Product/target
 


= Possible fixes if Eclipse acting weird =
= Possible fixes if Eclipse acting weird =

Latest revision as of 18:13, 13 September 2022

This Wiki is deprecated and we are are currrently migrating remaining pages into product documentation (Admin Guide, NXSL Guide)

= Eclipse and Target Platform setup =

Is should be like this:

Error creating thumbnail: Unable to save thumbnail to destination
  • Import existing project from src/java-common into workspace
  • Import existing project from src/client/java into workspace
  • Import existing projects from webui/webapp into workspace

Run Configuration

  • Create new Run Configuration (of type "RAP Application")
  • Enter "/nxmc" as servlet path
  • Switch to "Bundles" tab, click on "Deselect All"
  • Add working set -> add your workspace with all WebUI projects
  • Filter for "http.jetty" and select "org.eclipse.equinox.http.jetty"
  • Filter for "console" and select "org.eclipse.equinox.console"
  • Filter for "felix*shell" and select org.apache.felix.gogo.shell
  • Clear filter field and click "Add Required Bundles"
  • Uncheck "com.ibm.icu.base" - only "com.ibm.icu" must be selected
  • Click on Validate
  • Apply and Run

If browser complains about too many redirects (seen that on Mac) - just refresh page.

WAR export

Use Apache Maven: 

# updates versions in pom files
mvn -f webui/webapp/pom.xml -Dtycho.mode=maven org.eclipse.tycho:tycho-versions-plugin:update-pom -Pweb
# build console
mvn -f webui/webapp/pom.xml clean package -Pweb -Dtycho.disableP2Mirrors=true

Build will be in webui/webapp/Product/target


Possible fixes if Eclipse acting weird

  • Refresh sources
  • Clean and rebuild all
  • Repeat refresh / clean once more
  • Refresh platform (Preferences -> Target Platform -> (select it) -> Reload
  • Go to "Edit platform", select each Update site's URL and click on "Update"
Retrieved from "https://wiki.netxms.org/index.php?title=How_to_setup_Eclipse/RAP&oldid=1816"