Create a New Java Project in Eclipse

Eclipse is one of the most popular development environments for Java, as it contains everything you need to build a Java project from scratch. Before you can start working on your new project, you'll need to create it first. Creating a new Java project in Eclipse is fairly straightforward, but can be confusing if you've already installed Eclipse for a different programming language.

Steps

  1. Install the Eclipse IDE for Java Developers. When you install Eclipse for the first time, you're given the option to choose your IDE (integrated development environment). Choose "Eclipse IDE for Java Developers". This will install the necessary files and tools to create Java projects.
    • If you installed Eclipse for a different programming language, you can add Java support from within Eclipse. Click the "Help" menu and select "Install New Software". Select "All Available Sites" from the top drop-down menu, and then type "java" into the Filter field. Check the "Eclipse Java Development Tools" box and click "Next". Follow the prompts to download and install the Java tools. Eclipse will restart once the installation is complete.
  2. Click "File" → "New" → "Java Project". This will open the "New Java Project" window.[1]
    • If you don't see the "Java Project" option but have the Java Development Tools installed, select "Project..." from the "New" menu. Expand the "Java" folder and select "Java Project".
  3. Give the project a name. This doesn't have to be the final name for your program, but should help you and others identify the project.
  4. Select the location for the project files. The files are saved to the Eclipse directory by default. You can set a custom location if you prefer.
  5. Select Java Runtime Environment (JRE) you want to use. If you are creating a program for a specific JRE, select it from the drop-down menu. By default, the newest JRE will be selected.
  6. Select your project layout. You can choose to either use the project folder, or create separate folders for sources and class files. The default option is "Create separate folders...", though you may need to change depending on the needs of your project.[2]
  7. Click "Next" to open the "Java Settings" window. This is where you'll define additional sources as well as add libraries to your project.
  8. Use the Source tab to define your build path. The build path is what the compiler uses to build the program. You can create additional source folders, link external sources, and add or remove folders from the build path. The compiler uses the build path to determine which sources to compile.
  9. Use the Libraries tab to add libraries to the project. This tab will allow you to add JAR files to include in your project, as well as select built-in libraries to use. Importing JAR files allows you to use libraries from other projects.
  10. Click "Finish" to start working on your new project. You'll be taken to your Java workspace. If you were working in a different programming language before starting the project, you'll be prompted to switch to the Java perspective. This is recommended to get the most out of the IDE.
    • Your project will be displayed in the "Package Explorer" frame on the left side of the window. If you just see the Eclipse Welcome tab, click the small Java button on the left side of the window.[3]
    • See Write-Your-First-Program-in-Java for a detailed guide on creating your first Java program.

Tips

  • If you ever want to change your project's settings after it's been created, right click the project's name and navigate to your desired option.

Related Articles

Sources and Citations