How to setup Eclipse/RAP

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

= Eclipse and Target Platform setup =

• Download Eclipse 4.15 (2020-03) for RCP and RAP Developers from https://www.eclipse.org/downloads/eclipse-packages/
• Unpack and run
• Go to Window -> Preferences -> Plugin-in Development -> Target Platform, click "Add", initialize target definition with "Nothing"
• Change name to something like 'RAP 3.12"
• (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/rt/rap/3.12, 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/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.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)

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"