In some companies, App Defender/AppLocker makes the entire Windows OS practically unusable. EXEs are blocked, and the virus scan slows any build to a crawl. Nevertheless, we still need to work, and WSL is often the only feasible solution. But how can we start, for example, Eclipse or any other application in WSL that requires a screen?

Solution

We might wither build on x11 (steps 4 and 5) or use the build in WSLg which should run out of the box:

1. Install eclipse or STS in Linux
2. Export the DISPLAY env variable export DISPLAY=:0
3. Run eclipse or any other application in Linux
4. (optional) Install x11 in Linux sudo apt install x11-xserver-utils
5. (optional) Install VcXsrv on windows

Install eclipse or Spring STS in Linux

We might either install eclipse with sudo apt install eclipse or as many other of us choose to install a different IDE here an example for spring sts (update the URL as needed to the current version):

wget https://cdn.spring.io/spring-tools/release/STS4/4.25.0.RELEASE/dist/e4.33/spring-tool-suite-4-4.25.0.RELEASE-e4.33.0-linux.gtk.x86_64.tar.gz
tar -xvf spring-tool-suite-4-4.25.0.RELEASE-e4.33.0-linux.gtk.x86_64.tar.gz
rm -rf spring-tool*
ln -s sts-4.25.0.RELEASE/SpringToolSuite4 sts

Export the DISPLAY env variable

In order to find our windows screen we have to define the DISPLAY destination with the same named environment variable. The simplest way is to extend the .profile that it is automatically exported on each shell start (or .zprofile if zsh is used).

export DISPLAY=:0

Run eclipse or any other application

Now we can either start eclipse using ./eclipse or the spring STS using ./sts.

In case of any issues the x11 app might help you e.g. using xeyes:

sudo apt install x11-apps
xeyes

Install x11 in Linux

x11 tools on Linux are responsible to send the screen information from our Linux system to windows and on the other hand receive mouse and keyboard commands. In ubuntu the tools can be installed by using:

sudo apt install x11-xserver-utils

This step is not need anymore on a newer WSL as by default windows support UI apps in the WSL using WSLg.

If x11 is used the DISPLAY variable has to be adjusted to point to the Windows Host machine.

Install VcXsrv on windows

In order to receive the screen information from Linux in Windows and to display the application started in Linux we need an x11 client here too. First we have to install VcXsrv and start it using XLaunch which will prompt us of the settings:

1. Multiple windows in the display settings, which allows us to start more than one app
2. Start no client which of course requires us to start the app in Linux manually later on

Everything else may stay in the default settings.

This step is not need anymore on a newer WSL as by default windows support UI apps in the WSL using WSLg.

Alternatives

• https://github.com/microsoft/wslg

• Java:
  • https://adoptium.net/
  • https://www.graalvm.org/downloads/
  • https://jdk.java.net/
• Visual Studio Code:https://code.visualstudio.com/
  • Plugins
    • GitLens
    • Angular Language Service
    • Docker
    • Kubernetes
    • ESLint
• Java Eclipse STS: https://spring.io/tools
  • PlantUML: https://marketplace.eclipse.org/content/plantuml-plugin
• Git: https://git-scm.com/

Tools

• Docker Desktop: https://www.docker.com/products/docker-desktop
• Insomnia: https://insomnia.rest/

Tools for Linux / MAC

• Java SDK Management: https://sdkman.io/sdks
• Node version management: https://github.com/nvm-sh/nvm

Tools for Windows

• Command Line: http://cmder.net/
• Text Editor: https://notepad-plus-plus.org/

Database Tools

• Graphical DB client for Eclipse https://dbeaver.io/
• Oracle Developer https://www.oracle.com/de/database/technologies/appdev/sqldeveloper-landing.html

Java Test Libs

• https://github.com/awaitility/awaitility

Visual Studio Code & Windows

Install PowerShell 7.x.x

Check the current version $PSVersionTable.PSVersion

This requires admin permissions on the windows system.

winget install --id Microsoft.Powershell --source winget

Configure PowerShell 7 as CMD default

Open the windows shell, select in the menu the drop down and settings, select powershell and save.

Configure PowerShell 7 as VS Code default

There is also now a plugin available: https://code.visualstudio.com/docs/languages/powershell

Open the user Settings settings.json to add the new shell, you can see all Settings (read only) in the Default Settings (JSON).

• ctrl+p
• type Open Settings

Add the new install PowerShell 7 and set it as the new default.

"terminal.integrated.profiles.windows": {
    "PowerShell_7": {
        "source": "PowerShell",
        "icon": "terminal-powershell",
        "path": "C:\\Program Files\\PowerShell\\7\\pwsh.exe"
    },
},
"terminal.integrated.defaultProfile.windows": "PowerShell_7",

Eclipse ini settings

Memory settings G1 or ZGC

Where the G1 is optimized for shorter GC pause, which maybe is good too (default with Java 17), adjust the Xmx as you see fit eclipse.ini:

-Xms512m
-Xmx2048m
-XX:+UseG1GC
-XX:MaxGCPauseMillis=50
-XX:+UnlockExperimentalVMOptions
-XX:+UseStringDeduplication
-XX:+OptimizeStringConcat
-Dfile.encoding=UTF-8
-Dorg.eclipse.swt.internal.gtk.cairoGraphics=false
-Dorg.eclipse.swt.internal.gtk.useCairo=false

adjust the following settings based on your CPU count

-XX:ParallelGCThreads=6
-XX:ConcGCThreads=4

Increase icon size for large screens

-Dswt.autoScale=quarter

Eclipse autoscale comes with some examples. Basically quarter means leave it to the system to scale in 25% steps. Alternatively, use integers like 200 to scale to 200%.

-Dswt.autoScale=200

Miscellaneous

• Autogenerate Getter/Setter: https://projectlombok.org/
• Angular Browser Plugin: https://augury.rangle.io
• https://google.github.io/styleguide/javaguide.html

Nowadays we have a screen with a resolution of 2560×1440 or 3440×1440 4K. The problem with Eclipse is, that all the icons and buttons stay very tiny and are hard to interact with.

Solution

The easiest solution is to adjust the eclipse.ini or STS.ini with the following parameters at the end:

Fixed 200% scale

-Dswt.autoScale=200
-Dswt.autoScale.method=nearest

Autoscale based on screen resolution

-Dswt.autoScale=quarter
-Dswt.autoScale.method=nearest

Links

Eclipse documentation