Install and Setup JavaSDK and Cucumber (MacOS)

READ ME FIRST

• This tutorial applies to the MAC operating system, you can also check WINDOWS tutorial.
  
• This tutorial is based on this file (Programming Exercises Course 02161 Week 1 written by Hubert Baumeister in January 2022) to make additions and changes.
• Contact Shuokai Ma (s214919@student.dtu.dk) if you find a problem or have suggestions for this Wiki.

Download and Install Homebrew

test

Download and Install JavaSDK

Download JavaSDK

Go to the JavaSDK Download Page. Based on your OS, download the following file (Java 21 recommended):

Windows: x64 Installer

Install JavaSDK

Double-click the file you downloaded, you should see the following interface

Java(TM) Installing Program

Click NEXT, and choose where you want to install it. Then you wait for it to finish installing and click CLOSE.

Verify JavaSDK (Optional)

You should now find your JavaSDK installation directory e.g. C:\Program Files\Java\jdk-21\bin and copy that path.

JavaSDK Installation directory

Now you should modify environment variables on Windows.

1. On the Windows taskbar, right-click the Windows icon and select System.
2. In the Settings window, under Related links, click Advanced system settings.
3. On the Advanced tab, click Environment Variables.
4. Choose Path under the system variables and then Click Edit to modify that environment variable.
5. Click New and Paste that address (e.g. C:\Program Files\Java\jdk-21\bin) on the textbox
6. Move up that textbox to the top of the list.
7. Click OK and then Apply to have the change take effect.

Environment Variables Dialog in Windows

You can now verify your JavaSDK using the terminal command java --version. You should see the following content:

Verify JavaSDK

Download and Install IDE (Eclipse or IntelliJ)

The course will use Eclipse in its teaching material but all the things we do in the course can be done in IntelliJ too. You can download the latest version of Eclipse and IntelliJ (Community Edition) here. After that, you can follow the instructions of the installation wizard to install the IDE.

Download and Install the Cucumber plugin

Eclipse

From the Eclipse marketplace (from inside the Help menu of Eclipse), download the "Cucumber" plugin.

Install Cucumber (Eclipse)

IntelliJ

IntelliJ already comes with a Cucumber plugin. But I recommend you also download a plugin called Cucumber for Java since it can add support for Cucumber testing tools with step definitions written. You can download that from File -> Settings -> plugins. 

Install Cucumber (IntelliJ)

Restart your IDE

After you install the Cucumber plugin, you need to restart your IDE (Your IDE will also notify you to do that).

Download and Import the project "libaray01" to your IDE

You can download the zip file library01.zip here. And then you should unpack the zip file first.

Eclipse

You can now import the project into Eclipse by clicking File -> Import -> General -> Projects from Folder or Archive. And then you click the Directory and choose the file you unpacked from the zip file. Then you mark that project library01 and click Finish.

Import project (Eclipse)

IntelliJ

You can now import the project into IntelliJ by clicking Open and Choosing the file pom.xml you unpacked from the zip file. Then click OK and Open as Project.

Import project (IntelliJ)

Run the project in your IDE

Eclipse

Find the file AcceptanceTest.java under the src/test/java/dtu.library.acceptance_tests and then right-click -> Run as -> JUnit Test. You will see the following content:

Run the project in Eclipse

Although the program fails the test (as it should), it proves that you can already run the cucumber plugin. You can now begin to implement the production code such that the scenarios "Admin login", "Admin logout", "Add book", and "Search book" pass. After implementing the first scenario on "Admin login", you should see the following:

Successfully passed the first scenario test in Eclipse

IntelliJ

Find the file AcceptanceTest.java under the src/test/java/dtu.library/acceptance_tests and then right-click -> Run 'AcceptanceTest'. You will see the following content:

Run the project in IntelliJ

Although IntelliJ shows "build failed" at first, you can assume that you can already run the cucumber plugin. You can now begin to implement the production code such that the scenarios "Admin login", "Admin logout", "Add book", and "Search book" pass. After implementing the first scenario on "Admin login", you should see the following:

Successfully passed the first scenario test in IntelliJ