The Eclipse N4JS project is in the Incubation Phase and there is no official release available yet (for unofficial releases see the download page. This doesn’t mean that N4JS is unstable; we have an extensive test suite (>90.000 tests including the ECMAScript test suites) to ensure a stable nightly build. N4JS has been in use in several large non-public projects for years. There still may be bugs (as there are always bugs) and features which are currently under development. We encourage feedback from all users! For questions about getting started with the N4JS Language and IDE for developing your own projects, see the the Eclipse N4JS forum.
Eclipse developers who want to develop N4JS itself should use the Oomph Eclipse installer. The N4JS project is listed under "Eclipse Projects/N4JS" This setup installs the correct Eclipse version, creates a new workspace and clones all projects into it (for details see below).
The recommended way to install the Eclipse IDE and set up the workspace is to use the Eclipse Installer. This installer is to be downloaded from https://wiki.eclipse.org/Eclipse_Installer
Run the installer and apply the following steps:
change to "Advance Mode" via the menu (upper-right corner) (no need to move the installer)
select a product, e.g. "Eclipse IDE for Eclipse Committers" with product version "Oxygen"
double-click the entry Eclipse Projects/N4JS so that it is shown in the catalog view below
on the next page, configure paths accordingly. You only have to configure the installation and workspace folder.
The installer will then guide you through the rest of the installation. All plug-ins are downloaded and configured automatically, so is the workspace including downloading the git repository and setting up the workspace.
Manual IDE Configuration
For a manual install, clone the code and import all top-level projects from the docs, features, plugins, releng, testhelpers, and tests folders. Activate the targetplatform contained in the
The N4JS IDE is developed with Eclipse Oxygen 4.7 or better since the system is based on Eclipse anyway. It is almost impossible to use another IDE to develop Eclipse plugins. The list of required plugins includes:
It is important to use the latest version of Xtext and the corresponding service release of Xcore. You will find the latest version numbers and plugins used in the target platform definition at https://github.com/eclipse/n4js/blob/master/releng/org.eclipse.n4js.targetplatform/org.eclipse.n4js.targetplatform.target
Build the N4JS IDE from command line
Ensure you have
Maven 3.2.x and
installed on your system.
Clone the repository
git clone https://github.com/Eclipse/n4js.git
Change to the n4js folder:
Run the Maven build:
mvn clean verify
You may have to increase the memory for maven via
export MAVEN_OPTS="-Xmx2048m" (Unix) or
set MAVEN_OPTS="-Xmx2048m" (Windows).
For extending the N4JS-language in a different project, the
mvn clean deploy -Dlocal-snapshot-deploy-folder=/var/lib/my/folder/local-mvn-deploy-repository
The existence of
local-snapshot-deploy-folder will trigger a profile enabling the deploy-goal for the project
Copyright (c) 2017 NumberFour AG.
All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html