blob: ed23dd97f97283aa1c5ccb93b71e640b4360dc10 [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">Download</h1>
</div>
<div class="Cell Cell--12-12 GettingStarted-u-paddingLeft">
<h2 id ="_eclipse_installer">Eclipse Nightly Builds</h2>
<p>
If you just want to use the Eclipse N4JS IDE, you probably want to download the product directly.
</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>
In order to run the product, i.e. the Eclipse N4JS IDE, you need Java (version 11), to be installed on your machine.
</p>
<p />
</div>
<div class="Cell Cell--12-12 GettingStarted-u-paddingLeft">
<h2 id ="_eclipse_installer">Third Party Nightly Builds (bundled Java JRE)</h2>
<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">
<p/>
<h2 id ="_eclipse_installer">Eclipse Installer (Oomph)</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>
<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, e.g. "Eclipse IDE for Eclipse Committers" with a product version (usually latest version)
</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>
Double-click the entry <b>Eclipse Projects/N4JS</b> so that it is shown in the catalog view
</li>
<li>On the next page, configure your desired paths for the installation and workspace directories. You may want to use git with https instead of ssh</li>
<li>Begin installation</li>
</ol>
<p>
Once Eclipse with all plugins is downloaded, it is automatically started by the installer.
The Eclipse installer application is the finished, but additional installer scripts are run within the downloaded and automatically started IDE.
You can see the installer scripts by clicking on the icon next to the startup tasks report in the status bar.
<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>
</p>
<p>
The workspace is configured automatically.
This includes fetching the necessary git repository.
If you have selected git with SSH you may run into problems.
In this case you can re-run the scripts and select HTTPS instead, this should work in any case.
</p>
<p>
<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 installer scripts are done, that means the git repository has been cloned and the workspace has been configured (including the project set setup).
</p>
<p>
Now the automatical build kicks in as you can see in the status bar.
<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>
</p>
<p>
The build will show a lot of erros while still working.
Eventually the whole project should have been compiled without any errors.
Unfortunately, due to a <a href="https://github.com/eclipse/n4js/issues/1373">known issue</a>, two problems exists. Please have a look at the linked issue on how to fix that (it is quite easy).
</p>
</div>
<div class="Cell Cell--12-12 Downloads-u-paddingLeft Downloads-u-paddingRight">
<p class="SystemRequirements">
System Requirements: In all cases,
<a href="https://adoptopenjdk.net/" target="_blank">Java 11</a> is required to be installed on your system.
<a href="https://nodejs.org/en/download/">Node.js version 10+</a> is also required.
The N4JS plugins require the <a href="https://www.eclipse.org/downloads/" target="_blank">Eclipse 2019-06 release</a>.</p>
</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>