Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "Eclipse/Installation"

(Install a JVM)
(Extending Eclipse)
(16 intermediate revisions by 6 users not shown)
Line 1: Line 1:
Installing Eclipse is relatively easy.  
+
Installing Eclipse is relatively easy, but does involve a few steps and software from at least two different sources. '''Eclipse is a Java-based application''' and, as such, '''''requires a Java runtime environment (JRE)''''' in order to run.  
  
== Install a JVM ==
+
== Install a JVM ==
  
* Regardless of your operating system, you will need to install some Java virtual machine.
+
Regardless of your operating system, you will need to install some Java virtual machine (JVM). You may either install a Java Runtime Environment (JRE), or a Java Development Kit (JDK), depending on what you want to do with Eclipse. If you intend to use Eclipse for Java development, then you should install a JDK (the JDK includes--among other useful things--the source code for the standard Java libraries). If you aren't planning to use Eclipse for Java development and want to save some disk space, install a JRE.  
:* If using Windows, you may already have one installed, but upgrading won't hurt.
+
:* If using Linux, [[IRC_FAQ#I_just_installed_Eclipse_on_Linux.2C_but_it_does_not_start._What_is_the_problem.3F | read this]] -- GCJ will '''NOT''' work. Also see: [http://www.64bitjungle.com/ubuntu/install-java-jre-160-update-x-on-hardy-as-the-default-java-runtime Installing JRE 1.6.0 (Update x) as the Default Runtime].
+
* Consider an [http://www.ibm.com/developerworks/java/jdk/index.html IBM JDK] or a [http://java.sun.com/javase/downloads/index.jsp Sun JDK]. See below for minimum requirements.
+
  
== Eclipse 3.3 / Europa ==
+
*If you're using Windows, you may already have a JRE installed, but upgrading won't hurt.  
 +
*If using Linux, [[IRC FAQ#I_just_installed_Eclipse_on_Linux.2C_but_it_does_not_start._What_is_the_problem.3F|read this]]
 +
**GCJ will '''NOT''' work.
 +
**Also see: [http://www.64bitjungle.com/ubuntu/install-java-jre-160-update-x-on-hardy-as-the-default-java-runtime Installing JRE 1.6.0 (Update x) as the Default Runtime in Linux].
  
* [[#Install a JVM | Install a JDK or JRE]] -- minimum required level is 1.4.2 for basic functionality, but some plugins require 5.0/1.5; for example [http://www.eclipse.org/mylyn Mylyn] and various [http://www.eclipse.org/webtools/ WTP] plugins. If you downloaded and installed the [http://www.eclipse.org/downloads/moreinfo/jee.php Java EE Developer package], you will definitely need Java 5 or JDK 1.5 to run it.
+
=== JRE/JDK Sources ===
  
* Get Eclipse:
+
There are several sources for a JRE/JDK. Here are some of the more common/popular ones (listed alphabetically):  
:* If installing on Linux, you '''''can''''' look for a package from your distro maintainter/repositories, but ''this is not supported by eclipse.org.'' If you encounter problems with such a bundle, please contact your distro maintainer.
+
:* Otherwise, download an [http://download.eclipse.org/eclipse/downloads/ Eclipse SDK or Runtime Binary] or a [http://www.eclipse.org/europa Europa Bundle], then unpack it and [[IRC_FAQ#How_do_I_start_Eclipse.3F | start it up]].
+
  
=== Additional Plugins===
+
*[http://www.ibm.com/developerworks/java/jdk/index.html IBM JDK]
 +
*[http://openjdk.java.net/ OpenJDK]
 +
*[http://www.oracle.com/technetwork/java/javase/downloads/index.html Oracle JDK]
  
To add other plugins, here's the general process.
+
== Eclipse 4.3 (Kepler)  ==
  
* Start [[IRC_FAQ#What_is_the_Update_Manager.3F | Update Manager]].
+
Eclipse 4.3 (Kepler) was released in June 2013.
{{codeblock|
+
Help > Software Updates > Find and Install... >
+
  (*) Search for new features > Next >
+
  [x] Europa Discovery Site >
+
  New Remote Site > ''[[IRC_FAQ#Where_can_I_get_project_XYZ.3F|add a new site]]'' >
+
  Finish
+
}}
+
  
* Expand the Europa Discovery site to resolve dependencies. '''Collapsed sites will not be searched.'''
+
A Java 6 JRE/JDK is recommended for Eclipse 4.3. More information concerning tested configurations for Eclipse 4.3 is provided [http://www.eclipse.org/eclipse/development/readme_eclipse_4.3.html#TargetOperatingEnvironments here].  
  
* Select the feature(s) you want to install.  
+
Download Eclipse from the [http://www.eclipse.org/downloads Eclipse Downloads Page].  
  
* Click the '''Select Required''' button to resolve missing dependencies.  
+
The download will be delivered as a compressed (i.e. a ".zip", or ".tar.gz") file. Decompress this file into the directory of your choice (e.g. "c:\Program Files\Eclipse" on Windows). You can optionally create a shortcut of the executable file ("eclipse.exe" on Windows, or "eclipse" on Linux).  
  
* Install. Restart. Enjoy.
+
Note that there is a known problem with the built-in decompression utility on all current versions of '''Windows'''. We recommend that you use a more robust decompression utility such as the open source [http://www.7-zip.org/ 7zip] when decompressing an Eclipse download. Some people report success when initially decompressing Eclipse into a root directory (e.g. c:\) and then moving it to a more appropriate home (e.g. c:\Program Files\Eclipse)
  
== Eclipse 3.2 / Callisto ==
+
== Extending Eclipse ==
  
* [[#Install a JVM | Install a JDK or JRE]] -- minimum required level is 1.4.2.
+
Use the ''Help > Install new software...'' menu option to add Kepler features to your Eclipse installation (you can, for example, use this option to add C/C++ development support). Additionally, you can tap into a vast collection of extensions provided by the Eclipse community and ecosystem via the '''Eclipse Marketplace Client''' (''Help > Eclipse Marketplace''). Note that not all Eclipse packages contain the Eclipse Marketplace Client.
  
* Get Eclipse:
+
== More information ==
:* If installing on Linux, you '''''can''''' look for a package from your distro maintainter/repositories, but ''this is not supported by eclipse.org.'' If you encounter problems with such a bundle, please contact your distro maintainer.
+
:* Otherwise, download an [http://download.eclipse.org/eclipse/downloads/ Eclipse SDK or Runtime Binary], then unpack it and [[IRC_FAQ#How_do_I_start_Eclipse.3F | start it up]].
+
 
+
=== Additional Plugins===
+
 
+
To add other plugins, here's the general process.
+
 
+
* Start [[IRC_FAQ#What_is_the_Update_Manager.3F | Update Manager]].
+
{{codeblock|
+
Help > Software Updates > Find and Install... >
+
  (*) Search for new features > Next >
+
  New Remote Site > ''add the new site: http://download.eclipse.org/callisto/releases/'' >
+
  New Remote Site > ''[[IRC_FAQ#Where_can_I_get_project_XYZ.3F|add a new site]]'' >
+
  Finish
+
}}
+
 
+
* Select the projects &/or components you want to install.
+
 
+
* Expand the Callisto Updates site to resolve dependencies. '''Collapsed sites will not be searched.'''
+
 
+
* Select the feature(s) you want to install.
+
 
+
* Click the '''Select Required''' button to resolve missing dependencies.
+
:* If it does not work, you will have to manually select dependencies.
+
::* If '''that''' doesn't work, start over, but add more update sites. Can't find a given dependency? Try [[IRC_FAQ#Where_can_I_get_a_list_of_all_the_Eclipse_projects.3F | here]] or [[IRC_FAQ#Where_can_I_get_project_XYZ.3F | here]].
+
 
+
* Install. Restart. Enjoy.
+
  
 +
*[[FAQ Where do I get and install Eclipse?|Where do I get and install Eclipse?]]
 +
*[[Eclipse/Installation/Older Versions|Installation instructions for older versions of Eclipse]]
  
 
[[Category:FAQ]]
 
[[Category:FAQ]]

Revision as of 17:33, 26 June 2013

Installing Eclipse is relatively easy, but does involve a few steps and software from at least two different sources. Eclipse is a Java-based application and, as such, requires a Java runtime environment (JRE) in order to run.

Install a JVM

Regardless of your operating system, you will need to install some Java virtual machine (JVM). You may either install a Java Runtime Environment (JRE), or a Java Development Kit (JDK), depending on what you want to do with Eclipse. If you intend to use Eclipse for Java development, then you should install a JDK (the JDK includes--among other useful things--the source code for the standard Java libraries). If you aren't planning to use Eclipse for Java development and want to save some disk space, install a JRE.

JRE/JDK Sources

There are several sources for a JRE/JDK. Here are some of the more common/popular ones (listed alphabetically):

Eclipse 4.3 (Kepler)

Eclipse 4.3 (Kepler) was released in June 2013.

A Java 6 JRE/JDK is recommended for Eclipse 4.3. More information concerning tested configurations for Eclipse 4.3 is provided here.

Download Eclipse from the Eclipse Downloads Page.

The download will be delivered as a compressed (i.e. a ".zip", or ".tar.gz") file. Decompress this file into the directory of your choice (e.g. "c:\Program Files\Eclipse" on Windows). You can optionally create a shortcut of the executable file ("eclipse.exe" on Windows, or "eclipse" on Linux).

Note that there is a known problem with the built-in decompression utility on all current versions of Windows. We recommend that you use a more robust decompression utility such as the open source 7zip when decompressing an Eclipse download. Some people report success when initially decompressing Eclipse into a root directory (e.g. c:\) and then moving it to a more appropriate home (e.g. c:\Program Files\Eclipse)

Extending Eclipse

Use the Help > Install new software... menu option to add Kepler features to your Eclipse installation (you can, for example, use this option to add C/C++ development support). Additionally, you can tap into a vast collection of extensions provided by the Eclipse community and ecosystem via the Eclipse Marketplace Client (Help > Eclipse Marketplace). Note that not all Eclipse packages contain the Eclipse Marketplace Client.

More information

Copyright © Eclipse Foundation, Inc. All Rights Reserved.