# Software Installation (Windows OS)
Author: [Vincent Lau](https://www.linkedin.com/in/vincent-lau-30435bb6/)
Note: This material is intended for educational purposes only. All rights reserved. Any unauthorized sharing or copying of this material, in any form, to any individual or party, for any use without prior permission, is strictly prohibited.
### Part 0: Prerequisites
0.1 Show hidden files & file extensions
- View -> "File name extensions" & "Hidden items", check both boxes.
- File name extensions are convenient for developers to handle & visualize code source files
- Lots of generated files/ config files are in hidden mode. We should visualize them for development.
### 0.2 Windows OS Requirement
- If your laptop's OS is not Windows 10 or above, please raise it to the trainer. Some of the installation guides may not be compatible, such as WSL.
- Ideally Random Access Memory (RAM) >= 16GB. If your laptop is running 8GB RAM, please raise to trainer as well.
### Part 1: JDK
- As a Java developer, you have to download JDK (Java Development Kit) for Java Application Development. We will further explore JDK/ JRE/ JVM later on. Let's start the installation first.
- Let's use JDK 21, which is a LTS version (Long Term Support).
- Based on your laptop specification, choose the corresponding JDK version to download.
[Zulu Java 21 (WIndows OS)](https://www.azul.com/downloads/?version=java-21-lts&os=windows&package=jdk#zulu) Please check 64-bit or 32-bit.
Place the unzipped package on your preferred path.
**This is screen capture sample for Java17, your one should be with Java 21 version.**
For example,==C:\software\zulu17.36.17-ca-jdk17.0.4.1-win_x64==
- Setup %PATH% & %JAVA_HOME%
Go to "System enviroment variables" in the control panel ，（編輯系統環境變數）
- Advanced -> Environment Variables
- In System variables, select "Path", and then "Edit".
- Click "New", and place the JDK downloaded path as below.
**This is screen capture sample for Java17, your one should be with Java 21 version.**
- Back to "System variables", "New" a new variable "JAVA_HOME", and place the JDK downloaded path (the path does not include "\bin").
**This is screen capture sample for Java17, your one should be with Java 21 version.**
[result check]
- CMD to check if JDK is installed correctly
```
java --version
```
```
echo %JAVA_HOME%
```
```
echo %PATH%
```
**This is screen capture sample for Java17, your one should be with Java 21 version.**
"javac" should show guidelines on how to use javac.
### Part 2: Git
- DevOps tool used for source code management.
- Free and open-source version control system used to handle small to very large projects efficiently.
- Tracks changes in the source code, enabling multiple developers to work together on non-linear development.
### 2.1 Install Git
Offical git download: https://git-scm.com/download/win
- For Windows, we download the standalone installer from official site
- Press "Next"
- Where to install git. You can choose your own path.
- For me, I had installed to ==D:\software\Git.==
- Choose components to install, simply just leave the default setting unchanged.
- Default setting and Press Next
- Default setting and Press Next
- Default setting and Press Next
- Default setting and Press Next
- Default setting and Press Next
- Default setting and Press Next
- Default setting and Press Next
- Default setting and Press Next
- Default setting and Press Next
- Configure experimental options. These two features are new and optional. I will suggest you check “Enable experimental built-in file system monitor“. Usage we will see later. This will be the last screen of setup and now click on Install.
- Environment variable (Setup %PATH%)
Go to "System enviroment variables" in the control panel
- Advanced -> Environment Variables
- In System Variables, select "Path", and then "Edit".
- Click "New", and place the git downloaded path as below.
- If you don't have WSL2/WSL, it is recommended to use git-bash as terminal (pin it to taskbar, easy to launch later)
[Result check]
- "where git" to check what git versions are installed. "git --version" to check what version of git is installed
```
# check git version
git --version
# where did you install the git
where git
```
### 2.2 Create Github account
- As a developer, create a github account to start your journey.
- Create your own Github Account [ignore if you have created before].
- Update your github account info (https://hackmd.io/0L9QRERCSWSmeTEiIt4Q3w)
- It is a well known open source repository for sharing idea/ projects among the developers' community. You will find lots of useful projects/materials in github during your life as a developer. Over 80 million developers are using github as of 2022.
- You should store or backup your own projects/ material/ documents by github, so that you can refer to it in the future easily.
- Vincent's github profile - You can follow me (Star my repositories)
### 2.3 Setup SSH key
Generate ssh key - from github (Reference, or follow the steps below)
1. Open Git Bash
2. Generate ssh key
```
# Type this command to generate ssh key. The ssh key will be located in your laptop C:/Users/XXXX/.ssh
ssh-keygen -t ed25519 -C "your_email@example.com"
```
**[if fail in Step 2]** If you are using a legacy system that doesn't support the Ed25519 algorithm, use:
```
# only execute when you cannot success execute ED25519
ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
```
3. ==**[Just Enter]**== You will find "Enter a file in which to save the key", please press Enter. This accepts the default file location.
```
# Sample
> Enter a file in which to save the key (/Users/you/.ssh/id_algorithm): [Press enter]
```
4. ==**[Just Enter]**== At the prompt, ask for a secure passphrase. Suggest pressing "enter" to skip.
```
# Sample
> Enter passphrase (empty for no passphrase): [Type a passphrase]
> Enter same passphrase again: [Type passphrase again]
```
**[result check]**
You will use the public key "id_ed25519.pub" later.
### 2.4 Insert ssh key to Github a/c
1. Login your github a/c
2. Click the icon at the right top corner, Go to **Settings**.
3. Go to **SSH and GPG keys**, and press **New SSH key**
4. Open the **id_ed25519.pub** (public key) that we generated before, copy all contents of the key in the "Key" section shown below.
For title, simply put your email address.
[result check]
After adding the ssh key, you can download the github repository by git clone using SSH (You will use it in later installation part).
Now, you can download "repository" from github by using SSH, you will try later on.
### 2.5 Git config
```
git config --global user.name "your name"
```
```
git config --global user.email your_email@example.com
```
```
git config --global init.defaultBranch main
```
```
git config --global pager.branch false
```
```
git config --global pager.diff false
```
**[Result]** For Windows, the .gitconfig file is located C:\Users\yourname\
### Part 3: Maven
- Project management and comprehension tool that provides developers a complete build lifecycle framework.
- Development teams can automate the project's "build" infrastructure in almost no time as Maven uses a standard directory layout and a default build lifecycle.
- You will learn and use it when developing a Java & Springboot application.
### 3.1 Install Maven 3
[Offical Maven Download](https://maven.apache.org/download.cgi) (as of 2023.06.30, should be version 3.9.3. For Maven, fine to get the latest version.
- No installation process, extract the Maven archive to a directory of your choice once the download is complete. For example, C:\software\apache-maven-3.8.6
### 3.2 Add MAVEN_HOME System Variable
1. Open the Start menu and search for [environment variables](https://phoenixnap.com/kb/windows-set-environment-variable).
2. Click **Edit the system environment variables** result.
- Click the **New** button under the System variables section to add a new system environment variable.
- Click the **New** button under the System variables section to add a new system environment variable.
- Enter **MAVEN_HOME** as the variable name and the path to the Maven directory as the variable value. Click **OK** to save the new system variable.
### 3.3 Add MAVEN_HOME to PATH Variable
- Select the **Path** variable under the System variables section in the Environment Variables window. Click the **Edit** button to edit the variable.
- Click the **New** button in the Edit environment variable window.
- Enter **%MAVEN_HOME%\bin** in the new field. Click **OK** to save changes to the **Path** variable.
- Click **OK** in the Environment Variables window to save the changes to the system variables
**[Result Check]**
- Check maven version
- "Java version" should be the current java version
- "Runtime path" should be same as java_home
- Maven home should be same as %MAVEN_HOME%
```
mvn -v
```
You may check `%MAVEN_HOME%` and `%PATH%` as well, which are just set by you.
### Part 4: Visual Studio Code
- **We will use VSCode to code your Java & Springboot programs in the coming weeks!**
- Visual Studio Code is a lightweight but powerful source code editor which runs on your desktop and is available for Windows, macOS and Linux.
- If you have programming background and want to use "IntelliJ IDEA" instead of VSCode, it's fine, just an IDE. But I would still recommend you to try VSCode, and feel how lightweight it is.
### 4.1 Install VSCode from Official Site
- Install VScode in Windows OS directly, you can still use VSCode in Ubuntu Env.
[VScode Download](https://code.visualstudio.com/download) - Choose Windows, **Choose other system type if needed (64-bit / 32-bit)**
- After downloading and unzipping, start the installation. Following the instructions with default settings, you will complete the installation.
**[Result Check]**
Launch the VSCode.
### 4.2 Extensions
- Explorer / Search / Extensions are common functions in VScode. Put it in the menu bar on the left hand side of VSCode.
- **Extensions** in VSCode help it become an integrated IDE with powerful functions, like color themes/ syntax management/ icon setting/ text color for different file types. All of those features enable you to code much more easily in VSCode.
You can install all of the extensions below:
- ==Language Support for Java(TM) by Red Hat==
- ==Extension Pack for Java==
- ==Maven for Java==
- ==Debugger for Java==
- ==Project Manager for Java==
- ==Test Runner for Java==
- ==Ayu (teabyii)==
- ==Prettier - Code formatter==
- ==One Dark Pro (binaryify)==
- ==Spring Initializr Java Support==
- ==Spring Boot Tools==
- ==Spring Boot Dashboard==
- ==Spring Boot Extension Pack==
- ==Lombok Annotations Support for VS Code==
- ==XML==
- ==YAML==
- ==SQL Beautify==
- ==Markdown Preview Enhanced==
You can select your own favourite color theme (download & install from VSCode Extension)
- Light Modern (Light Theme)
- One Dark Pro (Dark Theme)
Change the theme by VSCode Setting -> Themes -> Color Theme
### 4.3 Code Formatter/ settings.json/ key shortcut
#### Step 1: VSCode general setting - settings.json
In VSCode, press `shift+crtl+p`, type **"open user settings json"** and select **"Open User Settings(JSON)"**.
**Download the settings.json:**
https://github.com/vincentwclau/laptop-setup/blob/main/vscode/setting/windows/settings.json
Then, just copy the content in the above settings.json file, and paste it to your settings.json in VSCode and Save.
##### [Result]
#### Step 2: VSCode Code Formatter - googlestyle.xml
**Download the settings.json:**
https://github.com/vincentwclau/laptop-setup/blob/main/vscode/code-formatter/java/googlestyle.xml
For example, I download it to the following folder (don't put into 桌面).
```
C:\github\formatter\java\googlestyle.xml
```
**In VSCode**, `shift+crtl+p` , type "open settings json" and select **"Open User Settings(JSON)"**.
Double check the path value is "**C:\\\github\\\formatter\\\java\\\googlestyle.xml**" in **"java.format.settings.url"**
Double check **"lineSplit"** to **80** and **"comment.line_length"** to **200**.
#### Step 3: VSCode keyboard shortcut - keybindings.json
Download the keybindings.json file:
https://github.com/vincentwclau/laptop-setup/blob/main/vscode/keyboard-shortcut/windows/keybindings.json
**In VSCode**, `shift+crtl+p`, type **"keyboard shortcuts json"** & select **"Open Keyboard Shortcut(JSON)"**
Replace the downloaded json file content into the VSCode.
Usages: These are the shortcuts that you would frequently use:
```
- shift+crtl+f: Auto format the code
- shift+crtl+o: Organize java Imports, remove unused Imports
- shift+crtl+k: Restart VSCode
```
##### [Result]
- To let the above configurations take effect, you have to **restart the VSCode (you can just shift+crtl+k)**
Sign in with Wallet
Connect another wallet