Software Installation and Setup

This page will walk you through installing the software that you will need for the course. We’ll do the following:

  1. Install software we’ll be using for the class.

  2. Create an account on GitHub, which is a cloud service we use to distribute and collect your work. That account, or one you already have, must be tied to your WUSTL email address.

  3. “Accept” a repository for “Exercises.” You will use this repository throughout the semester.

  4. Add the assignment to Eclipse, which is the IDE we use for this course.

  5. Use Eclipse, which you installed in the first step, on the code in the repository, which you got in the third and fourth steps.

1. Installing Software

We will be using a language called Java to create and run code on our computers. Before you can execute Java code, you need to install two pieces of software:

  1. The Java Development Kit (JDK). The JDK includes a whole bunch of Java tools that are used to assist in the creation and execution of Java programs. Visit the link above to download the JDK and install it on your computer.

    • Windows users will likely want the download labelled “x64 Installer.”

    • Mac users with the newer chipset (M1 or newer) should select “Arm 64 DMG Installer” and Mac users with older machines should select “x64 DMG Installer.”

  2. Professional software developers use an Integrated Development Environment (IDE). As the name describes, it’s used to develop computer programs and it integrates several different useful features:

    • It includes a smart editor that helps you create and work with computer code.

    • It can work with other programs called compilers. Compilers translate the program you write into something the computer can run. The JDK that you installed included a compiler.

    • Other handy features, like support for debugging assistance.

    We’ll be using Eclipse, a popular IDE that supports programming in Java. Download and install Eclipse before proceeding.

2. Create a GitHub Account

We will be using software called Git for “version control”. Version control systems (VCS) are a way of life in the modern software-development industry. They track how team members have changed a project, and they are particularly useful for collaborative projects, where multiple developers work concurrently on the same body of code.

We use the site GitHub to distribute and collect course work. GitHub is a place that hosts git repositories. You need to create a (free) account. Please visit GitHub and sign up for an account. Please use your WUSTL email address, although you can add multiple e-mail addresses. If you already have an account, please be sure to add your WUSTL email. These directions describe how to add additional email addresses.

You will also need to create a Personal Access Token:

  1. After creating your GitHub account, click here to be taken back to the GitHub page for creating tokens.

  2. For the note, enter what this token will be used for

../_images/GHToken_4_Note.png
  1. Make sure the expiration is set to “never”.

../_images/GHToken_7_expiration.png
  1. Select the repo checkbox. The other checkboxes can be left unchecked

../_images/GHToken_5_repo.png
  1. Click the Generate token button

../_images/GHToken_6_button.png

Keep this tab open as you will need the personal access token in one of the following steps.

3. Accepting the exercises

For each major type of course work you will need to generate a repository on GitHub. You’ll do so by clicking on a link and “accepting” an assignment. Click HERE to accept the repository containing the first batch of course exercises *and follow along with the instructions below*.

  1. Select the button to accept the exercises:

../_images/GHClassroom_2_AcceptAssignment.png
  1. After accepting the exercises, a copy of the exercise materials, called a repository, will be made for you. Click on the link to view the repository:

../_images/GHClassroom_3_AssignmentLink.png
  1. Finally, click on Code and then click the “Copy to Clipboard” button to make a copy of the URI shown.

../_images/GHClassroom_4_CloneLink.png

You’ve now created an exercises repository and have the URI. You’ll need to do steps 2-4 many times this semester.

4. Add the exercises to Eclipse

  1. Open or go to Eclipse.

  2. Go to the File menu and select Import

../_images/EclipseImport_1_Import.png
  1. Expand the Git options and select Projects from Git

../_images/EclipseImport_2_ProjectsFromGit.png
  1. Select Clone URI and then hit Next

../_images/EclipseImport_3_CloneURI.png
  1. The URI you copied when you created the assignment should automatically be used (if not, go back to GitHub, copy the full URI for cloning the repository, and paste it in here). Hit Next

../_images/EclipseImport_4_SourceRepo.png
  1. Enter your GitHub username and the Personal Access Token you generated as the password. Do not use your GitHub password. (You should select Store in Secure Store so that you don’t have to re-enter your password every time you accept an assignment). Select Log in when ready

../_images/EclipseImport_5_Login.png
  1. Select Next on the Branch Selection window.

../_images/EclipseImport_6_What.png
  1. Select Next on the Local Destination window.

../_images/EclipseImport_7_Where.png
  1. Select Import existing Eclipse Project and select Next on the Project Wizard.

../_images/EclipseImport_8_ExistingProject.png
  1. Select Finish.

../_images/EclipseImport_9_Finish.png

5. Using Eclipse on the exercises

To verify that your installation worked correctly, use eclipse to complete the following steps and run a simple program:

  1. Expand the exercises folder.

  2. Expand the src folder.

  3. Expand the module1._whyjava folder and double click on the HelloExample.java file.

  4. Run the file by right-clicking on it, selecting Run As, and then selecting Java Application, like:

../_images/Eclipse_Run.png
  1. Once the program has finished running you should see a simple welcome message at the bottom of the window, this indicates that the installation was successful!

../_images/Eclipse_Print.png
You have attempted of activities on this page