Eclipse N4JS Language and IDE

Downloads

We offer downloads for the N4JS IDE builds and the Developer Environment to develop the sources of the N4JS IDE.


N4JS IDE

If you just want to use the Eclipse N4JS IDE, you probably want to download the product directly. We offer the following two builds of the N4JS IDE.

Eclipse Nightly Builds

System Requirements (versions see below): Java, Node.js.

Since the Eclipse N4JS project is in incubation phase, we do not provide release versions yet. You can find links to nightly builds (update site and products for Windows, Linux and MacOS) at the N4JS Eclipse project's download page.

Third Party Nightly Builds (bundled Java JRE)

System Requirements (versions see below): Node.js.

Enfore AG originally introduced N4JS and hosts nightly builds that include Java JRE. You can find links to nightly builds (update site and products for Windows, Linux and macos) at the Enfore N4JS download page.


Developer Environment

For developing extensions for the N4JS language (or simply to fix bugs ;-) ), the recommended way to install the Eclipse IDE and set up the N4JS Java sources in a developer workspace is to use the Eclipse Installer. This installer is available from Eclipse.org. Run the installer and follow these steps (click on the images to enlarge):

Eclipse Installer (Oomph)

System Requirements (versions see below): Java, Node.js, Yarn.

  1. Screenshot 1 Switch to Advanced Mode via the menu located in the upper-right corner. This will let you select the product with version and a specific project (N4JS).
  2. Screenshot 2 Select a product and the product version. We recommend "Eclipse IDE for Eclipse Committers" (product version see below). Click "Next".
  3. Screenshot 3 Check the entry N4JS in the category "Eclipse Projects" so that it is shown in the catalog view below. Click "Next".
  4. Configure your desired paths for the installation and workspace directories. Check "Show all variables" if not checked already. Regarding "N4JS Github repository" you have the choices GIT, HTTPS read/write, and HTTPS read-only. In case you chose GIT, mind the trouble shooting hints below. Click "Next" and then "Finish".
  5. Automatic installation by the Eclipse installer and the setup tasks
    1. The Eclipse Installer will download and install the Eclipse IDE and all its plugins.
    2. The installed Eclipse IDE is started by the installer.
    3. Screenshot 4 The installation continues inside the IDE by running all setup tasks. You can see the running setup tasks by clicking on the animated yellow/blue arrow icon in the status bar at the bottom of the IDE window. In this step, the workspace is configured automatically. This includes fetching the necessary git repository. If you have selected GIT and run into an error, mind the hints below.
    4. Screenshot 5 Eventually the setup tasks are done, that means the git repository has been cloned and the workspace has been configured (including the project set setup).
    5. Now the automatical build kicks in as you can see in the status bar. The build will show a lot of errors while still working. Eventually the whole project should have been compiled without any errors. Screenshot 6
  6. Unfortunately, at the moment there will be a few compile errors after everything is finished completely. Please consult the Github issue 1373 to fix it.

Trouble Shooting

  • Compile errors after installation or clean-build

    Unfortunately, due to Github issue 1373, two problems exists which cause some compile errors to show up. Please have a look at the linked issue on how to fix that (it is quite easy).

  • SSH error when downloading a file 'content.xml'

    This error happens when your Java version is outdated. The reason is that Java comes with its own set of SSH certificates which might get incomplete or partly revoked over time.

  • Error "No more authentication methods available"

    This error is related to your choice of the git protocol ("N4JS Github repository"):

    • GIT: Make sure that you have your public/private key pair in your .ssh directory, otherwise the installer will say "No more authentication methods available". In that case, there are two fixes:
      • Either quit the installer, go to the Eclipse preferences, search for SSH2, and point to your keys. Afterwards, restart the installer by Help->Perform Setup Tasks.
      • Alternativily, chose the button "Back" in the setup tasks wizard and go back to the beginning, click on "Show all Variables" and then change the git repository to HTTPS. Afterwards, click finish to execute the setup tasks again.
    • HTTPS read/write: you need to specify your github user ID below.
    • HTTPS read-only: works always but you cannot push changes.


Required Versions