blob: a3754547ae915d93aede8533d989beccff1a9e2c [file] [log] [blame]
<!DOCTYPE HTML>
<html>
<head>
<!-- ************* Meta ************* -->
<title>Eclipse N4JS Language and IDE</title>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1" />
<!-- ************* OpenGraph ************-->
<meta name="description" content="The Eclipse N4JS language and its IDE enable high-quality JavaScript development for large Node.js projects.">
<meta property="og:site_name" content="Eclipse N4JS"/>
<meta property="og:title" content="Eclipse N4JS Language and IDE"/>
<meta property="og:url" content="https://eclipse.org/n4js"/>
<meta property="og:description" content="The Eclipse N4JS language and its IDE enable high-quality JavaScript development for large Node.js projects."/>
<meta property="og:image" content="images/n4js.png">
<!-- ************* JQuery ************* -->
<script src="https://code.jquery.com/jquery-1.12.4.js"></script>
<script src="https://code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
<!-- ************* Favicon ************-->
<link rel="icon" href="images/favicon.ico" />
<link rel="icon" type="image/png" href="images/favicon-32x32.png" sizes="32x32" />
<link rel="icon" type="image/png" href="images/favicon-16x16.png" sizes="16x16" />
<!-- ************* Styles ************* -->
<link rel="stylesheet" type="text/css" href="styles/styles.min.css">
<!-- ****************** Required for buttom to top scripts ****************** -->
<link rel="stylesheet" type="text/css" href="styles/backtotop.css">
</head>
<body>
<header class="Grid">
<div class="Cell Cell--4-12">
<a href="index.html"><img src="images/n4js-logo.png" alt="Eclipse N4JS Language and IDE"></a>
</div>
<div class="Cell Cell--8-12">
<nav>
<a href="downloads.html">Download</a> ·
<a href="community.html">Community</a> ·
<a href="userguides/index.html">Documentation</a>
</nav>
</div>
</header>
<div class="Main">
<article class="Grid" id="download">
<div class="Cell Cell--12-12">
<br/>
<h1 id="_download">Downloads</h1>
<p>
We offer downloads for the N4JS IDE builds and the Developer Environment to develop the sources of the N4JS IDE.
</p>
<br/>
</div>
<div class="Cell Cell--12-12 GettingStarted-u-paddingLeft">
<h2 id ="N4JS_IDE">N4JS IDE</h2>
<p>
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.
</p>
<h3 id ="Eclipse_Nightly_Builds">Eclipse Nightly Builds</h3>
<p class="SystemRequirements">
System Requirements (versions see below): <b>Java, Node.js</b></a>.
</p>
<p>
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
<a href="https://projects.eclipse.org/projects/technology.n4js/downloads" target="_blank">N4JS Eclipse project's download page</a>.
</p>
<p />
<h3 id ="Third_Party_Nightly_Builds">Third Party Nightly Builds (bundled Java JRE)</h3>
<p class="SystemRequirements">
System Requirements (versions see below): <b>Node.js</b></a>.
</p>
<p>
<a href="https://www.enfore.com" target="_blank">Enfore AG</a> 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
<a href="https://download.enfore.com/n4js/" target="_blank">Enfore N4JS download page</a>.
</p>
<br/>
</div>
<div class="Cell Cell--12-12 GettingStarted-u-paddingLeft">
<h2 id ="Developer_Environment">Developer Environment</h2>
<p>
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 <a href="https://wiki.eclipse.org/Eclipse_Installer">Eclipse.org</a>.
Run the installer and follow these steps (click on the images to enlarge):
</p>
<h3 id ="Eclipse_Installer">Eclipse Installer (Oomph)</h3>
<p class="SystemRequirements">
System Requirements (versions see below): <b>Java, Node.js, Yarn</b></a>.
</p>
<ol>
<li>
<a href="images/oomph/eclipseInstallerMode.png">
<img src="images/oomph/eclipseInstallerMode.png" alt="Screenshot 1" title="Screenshot Eclipse Installer, Select Mode (Click to see large version)" style="width:100px;float:right" />
</a>
Switch to <b>Advanced Mode</b> via the menu located in the upper-right corner.
This will let you select the product with version and a specific project (N4JS).
</li>
<li>
<a href="images/oomph/eclipseInstallerProductSelection.png">
<img src="images/oomph/eclipseInstallerProductSelection.png" alt="Screenshot 2" title="Screenshot Eclipse Installer, Select Product (Click to see large version)" style="width:100px;height:50px;float:right" />
</a>
Select a product and the product version.
We recommend "Eclipse IDE for Eclipse Committers" (product version see below).
Click "Next".
</li>
<li>
<a href="images/oomph/eclipseInstallerProjectSelection.png">
<img src="images/oomph/eclipseInstallerProjectSelection.png" alt="Screenshot 3" title="Screenshot Eclipse Installer, Select Project (Click to see large version)" style="width:100px;height:50px;float:right" />
</a>
Check the entry <b>N4JS</b> in the category "Eclipse Projects" so that it is shown in the catalog view below.
Click "Next".
</li>
<li>
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".
</li>
<li>
Automatic installation by the Eclipse installer and the setup tasks
<ol>
<li>
The Eclipse Installer will download and install the Eclipse IDE and all its plugins.
</li>
<li>
The installed Eclipse IDE is started by the installer.
</li>
<li>
<a href="images/oomph/ideExecutingStartupTasks.png">
<img src="images/oomph/ideExecutingStartupTasks.png" alt="Screenshot 4" title="Screenshot Installer Scripts (Click to see large version)" style="width:100px;float:right" />
</a>
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.
</li>
<li>
<a href="images/oomph/ideInstallerFinished.png">
<img src="images/oomph/ideInstallerFinished.png" alt="Screenshot 5" title="Screenshot Installer Scripts Done (Click to see large version)" style="width:100px;height:50px;float:right" />
</a>
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).
</li>
<li>
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.
<a href="images/oomph/ideBuild.png">
<img src="images/oomph/ideBuild.png" alt="Screenshot 6" title="Screenshot Automatic Build (Click to see large version)" style="width:100px;float:right" />
</a>
</li>
</ol>
</li>
<li>
Unfortunately, at the moment there will be a few compile errors after everything is finished completely.
Please consult the <a href="https://github.com/eclipse/n4js/issues/1373">Github issue 1373</a> to fix it.
</li>
</ol>
<h3 id ="Trouble_Shooting">Trouble Shooting</h3>
<p>
<ul>
<li>
<b>Compile errors after installation or clean-build</b>
<p>
Unfortunately, due to <a href="https://github.com/eclipse/n4js/issues/1373">Github issue 1373</a>, 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).
</p>
</li>
<li>
<b>SSH error when downloading a file 'content.xml'</b>
<p>
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.
</p>
</li>
<li>
<b>Error "No more authentication methods available"</b>
<p>
This error is related to your choice of the git protocol ("N4JS Github repository"):
<ul>
<li>
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:
<ul>
<li>
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.
</li>
<li>
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.
</li>
</ul>
</li>
<li>
HTTPS read/write: you need to specify your github user ID below.
</li>
<li>
HTTPS read-only: works always but you cannot push changes.
</li>
</ul>
</p>
</li>
</ul>
</p>
<br/>
</div>
<div class="Cell Cell--12-12 GettingStarted-u-paddingLeft">
<h2 id ="Required_Versions">Required Versions</h2>
<ul>
<li>
<a href="https://adoptopenjdk.net/" target="_blank">Java 11</a>
</li>
<li>
<a href="https://nodejs.org/en/download/" target="_blank">Node.js 10.13</a>
</li>
<li>
<a href="https://yarnpkg.com/en/docs/install" target="_blank">Yarn 1.13.0</a>
</li>
<li>
Eclipse Product Version: <a href="https://www.eclipse.org/downloads/" target="_blank">Eclipse 2019-09 release</a>
</li>
</ul>
</div>
</article>
</div>
<footer class="Grid" style="color:#d5dfea">
<div class="Cell Cell--2-12 m-Cell--withMargin">
<h2>Quick Links</h2>
<ul>
<li><a href="downloads.html">Download</a></li>
<li><a href="userguides/index.html">Documentation</a></li>
<li><a href="https://github.com/eclipse/n4js/">Source</a></li>
<li><a href="https://github.com/eclipse/n4js/issues">Issues</a></li>
</ul>
</div>
<div class="Cell Cell--2-12 m-Cell--withMargin">
<br/><br/>
<ul>
<li><a href="https://www.eclipse.org/forums/index.php/f/365/">Forum</a></li>
<li><a href="http://n4js.blogspot.de/">Blog</a></li>
<li><a href="https://dev.eclipse.org/mailman/listinfo/n4js-dev">Mailing List</a></li>
<li><a href="https://projects.eclipse.org/projects/technology.n4js">Eclipse Project Page</a></li>
<li><a href="https://twitter.com/n4jsdev">Tweets by n4jsdev</a></li>
</ul>
</div>
<div class="Cell Cell--2-12 m-Cell--withMargin">
<br/><br/>
<ul>
<li><a href="http://www.eclipse.org/">Eclipse Home</a></li>
<li><a href="http://www.eclipse.org/legal/privacy.php">Privacy Policy</a></li>
<li><a href="http://www.eclipse.org/legal/termsofuse.php">Terms of Use</a></li>
<li><a href="http://www.eclipse.org/legal/copyright.php">Copyright Agent</a></li>
<li><a href="http://www.eclipse.org/legal/">Legal</a></li>
</ul>
</div>
<div style="clear: both; height: 0; overflow: hidden;"></div>
</footer>
<script type="text/javascript">
// Create a back to top button
$('body').append('<a href="#" class="back-to-top" style="right:5%">Back to Top</a>');
var amountScrolled = 300;
$(window).scroll(function() {
if ( $(window).scrollTop() > amountScrolled ) {
$('a.back-to-top').fadeIn('slow');
} else {
$('a.back-to-top').fadeOut('slow');
}
});
$('a.back-to-top, a.simple-back-to-top').click(function() {
$('html, body').animate({
scrollTop: 0
}, 700);
return false;
});
</script>
</body>
</html>