Skip to content

Commit 1c6f873

Browse files
eviltestereviltester
committed
updated readme and speedrun
1 parent 625dde8 commit 1c6f873

2 files changed

Lines changed: 50 additions & 48 deletions

File tree

‎README.md‎

Lines changed: 27 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,30 @@
11
# startUsingJavaJUnit
22

3-
A simple Java JUnit project to check Java and Maven are installed correctly.
3+
A simple Java JUnit 4 project to check Java and Maven are installed correctly.
4+
5+
[For a Java JUnit 5 project look here](https://github.com/eviltester/startUsingJavaJUnit5)
6+
7+
This project demonstrates:
8+
9+
- Maven Setup
10+
- JUnit execution
411

512
Clone or download the project.
613

7-
Preqrequisites:
14+
Pre-requisites:
815

916
* JDK Installed
1017
* MAVEN Installed
1118

19+
## Pre-requisite Install Instructions
20+
21+
Install instructions can be found in `speedrun_install_java_checklist.md`
22+
23+
Read the [Speedrun Install Java Checklist](https://github.com/eviltester/startUsingJavaJUnit/blob/master/speedrun_install_java_checklist.md)
24+
for more details.
25+
26+
## Usage
27+
1228
In the root folder where the `pom.xml` resides, type:
1329

1430
~~~~~~~~
@@ -46,10 +62,14 @@ Tests run: 1, Failures: 0, Errors: 0, Skipped: 0
4662
[INFO] ------------------------------------------------------------------------
4763
~~~~~~~~
4864

49-
Read the [Java Install Checklist](https://github.com/eviltester/startUsingJavaJUnit/blob/master/speedrun_install_java_checklist.md)
50-
for more details.
65+
If you see the `BUILD SUCCESS` then everything has installed properly.
66+
67+
## About
68+
69+
Author: [Alan Richardson](https://www.linkedin.com/in/eviltester/)
5170

52-
Author: Alan Richardson
71+
* [EvilTester.com](https://eviltester.com)
72+
* [Compendium Developments](https://compendiumdev.co.uk)
5373

54-
* [JavaForTesters.com](http://javafortesters.com)
55-
* [Compendium Developments](http://compendiumdev.co.uk)
74+
- [A Java JUnit 5 version of this project is available](https://github.com/eviltester/startUsingJavaJUnit5)
75+
- [github.com/eviltester/startUsingJavaJUnit5](https://github.com/eviltester/startUsingJavaJUnit5)

‎speedrun_install_java_checklist.md‎

Lines changed: 23 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -50,9 +50,7 @@ The simple way is to install the apps is to use Chocolatey
5050
- Follow Install instructions [chocolatey.org/install](https://chocolatey.org/install)
5151
- Using the packages [chocolatey.org/packages](https://chocolatey.org/packages)
5252
- find what we want: (I find the chocolatey search isn't always the best so I use Google as well "site:chocolatey.org Java SE 9 JDK") (or chocolate search "tag:jdk")
53-
- `choco install jdk10`
54-
- previously `choco install jdk9`
55-
- previously `choco install jdk8`
53+
- `choco install openjdk`
5654
- `choco install maven`
5755
- `choco install intellijidea-community`
5856

@@ -63,35 +61,32 @@ The simple way is to install the apps is to use Chocolatey
6361

6462
If you used Chocolatey then you can skip this and move to the 'Check the install on Windows' section.
6563

66-
* `[ ]` Download Java
67-
* `[ ]` search for "download java sdk" (do not install the normal JRE from java.com)
68-
- http://www.oracle.com/technetwork/java/javase/downloads/index.html
64+
* `[ ]` Download Java SDK from either Adoptium.net or Oracle
65+
* `[ ]` Recommended Adoptium install https://adoptium.net/
66+
* `[ ]` Oracle's Open JDK https://openjdk.org/
6967

7068
---
7169

72-
* `[ ]` Install Java JDK
70+
* `[ ]` Install The Java JDK
7371
* `[ ]` Windows
74-
- e.g. `C:\Program Files\Java\jdk1.8.0_102`
75-
* `[ ]` add the Java "\bin" folder to the path if it hasn't been added
76-
e.g. `C:\Program Files\Java\jdk1.8.0_102\bin`
77-
* `[ ]` create a JAVA_HOME environment variable while there for the root path
78-
e.g. `C:\Program Files\Java\jdk1.8.0_102`
79-
- some people add a `JDK_HOME` for the root path as well (I haven't done this)
8072
* `[ ]` check Java JDK installed by typing `javac -version` in a new command line
73+
* `[ ]` add the JDK "\bin" folder to the path if it hasn't been added
74+
* `[ ]` create a JAVA_HOME environment variable for the root path of the JDK
8175

8276
---
8377

8478
* `[ ]` Install Maven
85-
* `[ ]` Download Maven http://maven.apache.org/download.html#Installation
79+
* `[ ]` Download Maven https://maven.apache.org/download.cgi
8680
* `[ ]` Windows
81+
* Follow the install instructions https://maven.apache.org/install.html
8782
* `[ ]` Unzip maven to a directory (avoid one with spaces in it)
88-
- e.g. `C:\maven_3_3_9`
89-
* `[ ]` add `C:\maven_3_3_9\bin` to the `PATH` in System Variables
83+
- e.g. `C:\maven_3_9_3`
84+
* `[ ]` add `C:\maven_3_9_3\bin` to the `PATH` in System Variables
9085
* `[ ]` check installed by typing `mvn -version` into a new command window
9186

9287
---
9388

94-
* `[ ]` everything is installed, check the environment variables by displaying them on the console
89+
* `[ ]` with everything now installed, check the environment variables by displaying them on the console
9590
* `[ ]` Windows
9691
* `[ ]` `echo %JAVA_HOME%`
9792
* `[ ]` `echo %PATH%`
@@ -145,9 +140,13 @@ If it runs successfully then you have Java and Maven Installed in Windows.
145140

146141
* `[ ]` install homebrew from http://brew.sh/
147142
* `[ ]` `brew update`
148-
* `[ ]` install jdk with `brew cask install java`
143+
* `[ ]` install jdk with one of :
144+
- Adoptium.net version `brew install --cask temurin`
145+
- Oracle Open JDK version `brew install openjdk`
149146
* `[ ]` install maven with `brew install maven`
150147

148+
You can also use SDKMan to manage and install different versions of java SDK: https://sdkman.io/
149+
151150
---
152151

153152
* `[ ]` everything is installed, check the environment variables by displaying them on the console
@@ -174,7 +173,7 @@ If it runs successfully then you have Java and Maven Installed on Mac.
174173

175174
You can install IntelliJ using Homebrew as well by typing:
176175

177-
* `[ ]` `brew cask install intellij-idea-ce`
176+
* `[ ]` `brew install --cask intellij-idea-ce`
178177

179178
Or you can install it like a normal Mac application using the instructions below.
180179

@@ -190,26 +189,24 @@ Generic Links:
190189
==============
191190

192191
+ Download Java SDK From
193-
http://www.oracle.com/technetwork/java/javase/downloads/index.html
194-
- 1.10 http://www.oracle.com/technetwork/java/javase/downloads/jdk10-downloads-4416644.html
195-
- 1.9 http://www.oracle.com/technetwork/java/javase/downloads/jdk9-downloads-3848520.html
196-
- 1.8 http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
197-
- 1.7 http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html
192+
- Adoptium (recommended): https://adoptium.net/
193+
- Oracle: https://openjdk.org/
198194

199195
+ Download Maven From
200196
* http://maven.apache.org/download.cgi
201197

202198
---
203199

204200
+ sample JUnit test project from
205-
* https://github.com/eviltester/startUsingJavaJUnit
201+
* JUnit 4 - https://github.com/eviltester/startUsingJavaJUnit
202+
* JUnit 5 - https://github.com/eviltester/startUsingJavaJUnit5
206203

207204
+ Download IntelliJ from
208205
* http://www.jetbrains.com/idea/download/
209206

210207
+ Mac HomeBrew and Cask
211208
* http://brew.sh
212-
* https://caskroom.github.io/
209+
* https://caskroom.github.io
213210

214211
---
215212

@@ -220,18 +217,3 @@ http://www.oracle.com/technetwork/java/javase/downloads/index.html
220217
* https://www.java.com/en/download/help/mac_uninstall_java.xml
221218
* http://docs.oracle.com/javase/8/docs/technotes/guides/install/mac_jdk.html
222219

223-
---
224-
225-
# Java For Testers
226-
227-
## A book and a blog teaching Java for non-programmers.
228-
229-
* www.javafortesters.com
230-
231-
By Alan Richardson
232-
233-
* www.eviltester.com
234-
* www.seleniumsimplified.com
235-
* www.compendiumdev.co.uk
236-
* http://uk.linkedin.com/in/eviltester
237-
* [@eviltester](http://twitter.com/eviltester)

0 commit comments

Comments
 (0)