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

From NetXMS Wiki
Jump to navigation Jump to search
Line 1: Line 1:
= Eclipse and Target Platform setup =
= Eclipse and Target Platform setup =


* Download Eclipse 4.7 (Oxygen) for RCP and RAP Developers from https://www.eclipse.org/downloads/eclipse-packages/
* 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 3.4 Tooling" - http://download.eclipse.org/rt/rap/tools/3.4
* Install "Remote Application Platform (RAP)" from that source
* 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 3.4"
* Change name to something like 'RAP 3.12"
* (still in target content editor) Add software site http://download.eclipse.org/releases/oxygen, '''uncheck''' "Include Required Software" and install "EMF - Eclipse Modeling Framework SDK" (from Modeling) and "BIRT Framework" (from Business Intelligence, Reporting and Charting)
* (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.4, '''uncheck''' "Include Required Software" and install everything
* 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://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"
* 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.15.0/oxygen/, '''uncheck''' "Include Required Software" and install "Babel Language Pack for eclipse" (Chinese Simplified, Czech, French, German, Portuguese, Russian, Spanish)
* Add software site http://download.eclipse.org/technology/babel/update-site/R0.11.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:
Is should be like this:


[[File:RAP 3.4 Target Platform.png]]
[[File:RAP 3.12 Target Platform.png]]


* Import existing project from src/libnxjava/java/base into workspace
* Import existing project from src/java-common into workspace


* Import existing project from src/client/java into workspace
* Import existing project from src/client/java into workspace
Line 40: Line 38:


= WAR export =
= WAR export =
* From http://download.eclipse.org/libra/releases 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 =

Revision as of 19:45, 7 April 2020

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=1733"