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.
Difference between revisions of "Eclipse/Installation"
(→Install a JVM) |
(→Install a JVM) |
||
| (25 intermediate revisions by 9 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. |
| − | == | + | == Eclipse 4.4 (Luna) == |
| − | + | Eclipse 4.4 (Luna) was released on June 25, 2014. | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | A '''Java 7''' JRE/JDK is '''required''' for most of the Luna package downloads based on Eclipse 4.4. More information concerning tested configurations for Eclipse 4.4 is provided [http://www.eclipse.org/eclipse/development/readme_eclipse_4.4.html#TargetOperatingEnvironments here]. | |
| − | + | == 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 [http://www.eclipse.org/eclipse/development/readme_eclipse_4.3.html#TargetOperatingEnvironments here]. | |
| − | + | == Install a JVM == | |
| + | {{warning|If you are using Eclipse to do Java development, install a JDK<br/> | ||
| + | A Java Development Kit (JDK) includes many useful extras for Java developers including the source code for the standard Java libraries.}} | ||
| − | + | 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''. If you aren't planning to use Eclipse for Java development and want to save some disk space, install a JRE. | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | * | + | *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]. | ||
| − | + | === JRE/JDK Sources === | |
| − | + | {{warning|Be sure to install a JVM with the same bit level as Eclipse<br/> | |
| + | i.e. install a 32-bit JRE to run 32-bit Eclipse; install a 64-bit JRE to run 64-bit Eclipse}} | ||
| + | There are several sources for a JRE/JDK. Here are some of the more common/popular ones (listed alphabetically): | ||
| − | * | + | *[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] | ||
| − | == Eclipse | + | ==Download Eclipse== |
| − | + | Download Eclipse from the [http://www.eclipse.org/downloads Eclipse Downloads Page]. | |
| − | + | There are several package choices. Note that you can install the features from any package into any other package. If you are, for example, planning to do mostly Java development and some C/C++ development, you should download the ''Eclipse IDE for Java Developers'' and then add the C/C++ development tools via the "Help > Install New Software..." menu option. | |
| − | + | ||
| − | + | ||
| − | + | 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:\eclipse" on Windows) and ensure you have full Read and Execute permissions. 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 [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) | |
| − | + | == Configure Eclipse to use the JVM == | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | It is strongly recommended to configure Eclipse with the specific JVM that you want. See the instructions at [[Eclipse.ini]] | |
| + | This is a very important step to be sure that Eclipse is using the JVM you intend and can't be influenced by any other software that might alter your system. | ||
| + | The JVM used to launch Eclipse has no affect on whether it can compile Java sources for other Java language versions. | ||
| − | + | == 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 == | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| + | *[[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 18:29, 5 March 2015
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.
Contents
Eclipse 4.4 (Luna)
Eclipse 4.4 (Luna) was released on June 25, 2014.
A Java 7 JRE/JDK is required for most of the Luna package downloads based on Eclipse 4.4. More information concerning tested configurations for Eclipse 4.4 is provided here.
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.
Install a JVM
A Java Development Kit (JDK) includes many useful extras for Java developers including the source code for the standard Java libraries.
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. If you aren't planning to use Eclipse for Java development and want to save some disk space, install a JRE.
- If you're using Windows, you may already have a JRE installed, but upgrading won't hurt.
- If using Linux, read this
- GCJ will NOT work.
- Also see: Installing JRE 1.6.0 (Update x) as the Default Runtime in Linux.
JRE/JDK Sources
i.e. install a 32-bit JRE to run 32-bit Eclipse; install a 64-bit JRE to run 64-bit Eclipse
There are several sources for a JRE/JDK. Here are some of the more common/popular ones (listed alphabetically):
Download Eclipse
Download Eclipse from the Eclipse Downloads Page.
There are several package choices. Note that you can install the features from any package into any other package. If you are, for example, planning to do mostly Java development and some C/C++ development, you should download the Eclipse IDE for Java Developers and then add the C/C++ development tools via the "Help > Install New Software..." menu option.
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:\eclipse" on Windows) and ensure you have full Read and Execute permissions. 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)
Configure Eclipse to use the JVM
It is strongly recommended to configure Eclipse with the specific JVM that you want. See the instructions at Eclipse.ini This is a very important step to be sure that Eclipse is using the JVM you intend and can't be influenced by any other software that might alter your system. The JVM used to launch Eclipse has no affect on whether it can compile Java sources for other Java language versions.
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.