Running iDempiere within VSCode

Status: This is Work is in Progress, but it may be useful as it is.

This guide explains how to run iDempiere within the VSCode, NOT AS A REPLACEMENT for Eclipse, but just as an alternative for developers that prefer this editor.

Another great possibility that this brings up is the possibility to use modern remote workspaces features like Code Server or Eclipse Theia instead of using remote desktop software with graphical environments.

Configuring VSCode

1 - Prepare a working workspace for iDempiere development you can try the with some simple steps. 2 - Install VSCode according to your operating system following the instructions 3 - Install the required extensions Java Extension Pack, Eclipse PDE support and OSGi for Visual Studio Code. From a command line execute:

code --install-extension vscjava.vscode-java-pack
code --install-extension yaozheng.vscode-pde
code --install-extension lgdd.vscode-osgi

4 - Optionally install the Eclipse Keymap extension

code --install-extension alphabotsec.vscode-eclipse-keybindings

5 - Open the vscode editor and the open your $IDEMPIERE_REPOSITORY folder and wait 6 - After the VSCode loading is done, some errors will appear and you will need to reload the Target Platform to resolve. For that right click on the file org.idempiere.p2.targetplatform -> org.idempiere.p2.targetplatform.target and select the Reload Target Platform option. Wait until the task is done.

7 - Configure you server details doing a Right Click on the org.adempiere.install -> install.app.lauch file and select the Debug PDE application option

8 - Now run/debug your iDempiere server doing a Right Click on the org.adempiere.server-feature -> server.product.launch file and select the Debug PDE application option

This tutorial is brought to you by muriloht from devCoffee. Feel free to improve directly or suggest using the Discussion tab.