Install and Setup JavaSDK and Cucumber (MacOS): Difference between revisions
From KKM-STUDIO-WIKI
More actions
| (35 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
'''READ ME FIRST''' | '''READ ME FIRST''' | ||
*This tutorial applies to the ''' | *This tutorial applies to the '''Mac''' operating system, you can also check '''[https://kkmstudio.dk/mediawiki/index.php?title=Install_and_Setup_JavaSDK_and_Cucumber_(Windows) Windows]''' tutorial.<br> | ||
*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. | *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 ([mailto:s214919@student.dtu.dk s214919@student.dtu.dk]) if you find a problem or have suggestions for this Wiki. | *Contact Shuokai Ma ([mailto:s214919@student.dtu.dk s214919@student.dtu.dk]) if you find a problem or have suggestions for this Wiki. | ||
= Install | = Install and Verify JavaSDK = | ||
== Download JavaSDK == | |||
Go to the [https://www.oracle.com/java/technologies/downloads/ JavaSDK Download Page]. Based on your OS, download the following file (Java 21 recommended): | |||
macOS: ARM64 DMG Installer (for M series chips) or x64 DMG Installer (for Intel chips) | |||
== Install JavaSDK == | |||
'''Double-click''' the file you downloaded and then '''double-click''' the '''pkg''' file, you should see the following interface[[File:Mac install java.png|400px|center|thumb|Java(TM) Installing Program]] | |||
== Verify JavaSDK | Click '''CONTINUE''', and '''choose''' where you want to install it. Then you should '''provide''' your password and wait for it to finish installing and click '''CLOSE'''. | ||
== Verify JavaSDK == | |||
Open your terminal and write <code class="mwt-code">java --version</code>. You should see the following content:[[File:Mac java.png|400px|center|thumb|Verify JavaSDK]] | |||
= Download and Install IDE (Eclipse or IntelliJ) = | = 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 [https://www.eclipse.org/downloads/ Eclipse] and [https://www.jetbrains.com/idea/download/ | 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 [https://www.eclipse.org/downloads/ Eclipse] and [https://www.jetbrains.com/idea/download/?section=mac 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 = | = Download and Install the Cucumber plugin = | ||
== Eclipse == | == Eclipse == | ||
From the Eclipse '''marketplace''' (from '''inside the Help menu''' of Eclipse), download the "Cucumber" plugin.[[File: | From the Eclipse '''marketplace''' (from '''inside the Help menu''' of Eclipse), download the "Cucumber" plugin.[[File:Mac04.png|500px|center|thumb|Install Cucumber (Eclipse)]] | ||
== IntelliJ == | == 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 ''' | 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 '''IntelliJ IDEA -> Settings -> plugins'''. [[File:Mac09.png|500px|center|thumb|Install Cucumber (IntelliJ)]] | ||
== Restart your IDE == | == Restart your IDE == | ||
| Line 47: | Line 34: | ||
= Download and Import the project "libaray01" to your IDE = | = Download and Import the project "libaray01" to your IDE = | ||
You can download the zip file [https://www2.imm.dtu.dk/courses/02161/2021/files/library01.zip library01.zip] here. And then you should unpack the zip file first. | You can download the zip file [https://www2.imm.dtu.dk/courses/02161/2021/files/library01.zip library01.zip] here. And then you should '''unpack the zip file first'''. | ||
== Eclipse == | == Eclipse == | ||
You can now import the project into Eclipse by clicking '''File -> Import -> | You can now import the project into Eclipse by clicking '''File -> Import -> Maven -> Existing Maven Projects. '''After clicking '''Next''', proceed to click '''Browse '''and '''select''' the file you unpacked from the zip file. Then, '''mark '''the project '''pom.xml''' and click '''Finish'''.[[File:Mac05.png|500px|center|thumb|Import project (Eclipse)]] | ||
== IntelliJ == | == 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 | 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 Open''' and '''Open as Project'''.[[File:Mac08.png|500px|center|thumb|Import project (IntelliJ)]] | ||
= Run the project in your IDE = | = Run the project in your IDE = | ||
== Eclipse == | == Eclipse == | ||
Find the file '''AcceptanceTest.java''' under the <code class="mwt-code">src/test/java/dtu.library.acceptance_tests</code> and then '''right-click -> Run as -> JUnit Test'''. You will see the following content:[[File: | Find the file '''AcceptanceTest.java''' under the <code class="mwt-code">src/test/java/dtu.library.acceptance_tests</code> and then '''right-click -> Run as -> JUnit Test'''. You will see the following content:[[File:Mac06.png|500px|center|thumb|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:[[File: | 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:[[File:Mac07.png|500px|center|thumb|Successfully passed the first scenario test in Eclipse]] | ||
== IntelliJ == | == IntelliJ == | ||
Find the file '''AcceptanceTest.java''' under the <code class="mwt-code">src/test/java/dtu.library/acceptance_tests</code> and then '''right-click -> Run 'AcceptanceTest''''. You will see the following content:[[File: | Find the file '''AcceptanceTest.java''' under the <code class="mwt-code">src/test/java/dtu.library/acceptance_tests</code> and then '''right-click -> Run 'AcceptanceTest''''. You will see the following content:[[File:Mac10.png|500px|center|thumb|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:[[File:Mac11.png|500px|center|thumb|Successfully passed the first scenario test in IntelliJ]] | |||
[[Category:Course 02161 Software Engineering 1|1]] | [[Category:Course 02161 Software Engineering 1|1]] | ||
Latest revision as of 02:05, 29 January 2024
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.
Install and Verify JavaSDK
Download JavaSDK
Go to the JavaSDK Download Page. Based on your OS, download the following file (Java 21 recommended):
macOS: ARM64 DMG Installer (for M series chips) or x64 DMG Installer (for Intel chips)
Install JavaSDK
Double-click the file you downloaded and then double-click the pkg file, you should see the following interface
Click CONTINUE, and choose where you want to install it. Then you should provide your password and wait for it to finish installing and click CLOSE.
Verify JavaSDK
Open your terminal and write java --version. You should see the following content:
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.
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 IntelliJ IDEA -> Settings -> plugins.
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 -> Maven -> Existing Maven Projects. After clicking Next, proceed to click Browse and select the file you unpacked from the zip file. Then, mark the project pom.xml and click Finish.
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 Open and Open as Project.
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:
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:
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:
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:
