Files
java-2020-class/docs/day0.md
2020-11-08 17:07:45 -05:00

162 lines
6.0 KiB
Markdown

# Day 0
When you start programming half the battle is getting your bearings. Suddenly it matters where you put your files. You need to know where you home directory is, you need to understand file permissions, you need to understand what a file actually *is*. Trying to program without first learning about *the thing you are programming* will cause headache.
Fortunately we can do some things to make your life easier. We can install an **Integrated Development Environment (IDE):** a program that lets you visualize your files and folders and quickly switch between them. We can install a **version control system (VCS)** that will let you "snapshot" your code and save it to the cloud so you never lose it. We can organize our project to be repeatable, and more importantly, un-loseable.
## I have a Windows PC
(or skip to [I have a Mac](#i-have-a-mac))
### Install Git (windows)
Git is a version control program, but you can think of it as your best friend in the cold, dark world of data loss. Git will make sure you don't lose progress. It lets you save your code at various stages and revert to previous saves if you need to. Like mentioned above, it takes a "snapshot" of your code at that point in time.
1. Head to <https://git-scm.com/>
2. Click Download
![git_download](img/day0/git_download_windows.png)
3. Run through the default install process
### Install Java (windows)
1. Head to <https://ninite.com>
2. Under the **Developer Tools** section, check the **JDK (AdoptOpenJDK) x64 8** option and then **Get Your Ninite**
![download_for_windows](img/day0/ninite_download_for_windows.png)
3. Once the file has finished downloading, click on the installer to Run through the install process.
![java_windows_install](img/day0/ninite_install_for_windows.png)
### Add Java to path (windows)
1. Open the File Explorer, and navigate to `C:\Program Files\AdoptOpenJDK\jdk-8.x.xxx\bin`
2. Copy the path to your clipboard
![java_windows_path](img/day0/java_windows_path.png)
3. Now click the Windows Start Button
4. Start typing **environment**
5. Click on **Enter the System Environment variables**
![widnows_edit_env_vars](img/day0/windows_env_var.png)
6. Click on **Environment Variables..**
7. Under the *System Variables* section, find and click the **Path** entry and then click **Edit**
![windows_sys_env_var_path](img/day0/windows_path_edit.png)
8. Click **New** and paste in the path copied in Step 1 and click **OK**
![windows_path_edit](img/day0/windows_path_edit2.png)
9. Reboot your computer
### Install BlueJ (windows)
Your most important tool as a programmer is a proper editor. It should offer you a wide selection of tools but get out of your way when you don't need it
. While there are manny advanced editors and IDEs out in the wild, its always good to start with the basics, to get a proper grasp and understanding of the
language.
1. Head to <https://bluej.org/>
2. Click on the download link
![BlueJ_download](img/day0/bluej_download.png)
3. Run through the installer, select default options
![bluej_install](img/day0/windows_bluej_install.gif)
4. Open BlueJ
![bluej_open](img/day0/bluej_open.png)
### Create a "Projects" folder (windows)
I keep all my projects in a folder called "Projects" in my home directory. On Windows this is at `C:\Users\<your username>\Projects`. Create this folder now. Bookmark it, put it in your favorites, don't lose it.
1. In BlueJ, go to the **Project** menu and click on **New Project**
2. For the Name, enter `java_game`, for the Location, select the `Projects` folder you created in the step above.
![ctrl_ko](img/day0/windows_create_bluej_project2.gif)
## I have a Mac
### Install Git (mac)
Git is a version control program, but you can think of it as your best friend in the cold, dark world of data loss. Git will make sure you don't lose progress. It lets you save your code at various stages and revert to previous saves if you need to.
1. Head to <https://git-scm.com/>
2. Click Download
![git_download](img/day0/git_download_mac.png)
3. Run through the default install process
### Install Python (mac)
1. Head to <https://adoptopenjdk.net/>
2. Select **OpenJDK 8 (LTS)** for version, and **HotSpot** for JVM and click the **Latest Release** download button
![download_java_mac](img/day0/mac_install_java.png)
3. Follow the standard install process
![java_install_for_mac](img/day0/mac_bluej_install2.gif)
### Install BlueJ (mac)
Your most important tool as a programmer is a proper editor. It should offer you a wide selection of tools but get out of your way when you don't need it
. While there are manny advanced editors and IDEs out in the wild, its always good to start with the basics, to get a proper grasp and understanding of the
language.
Your most important tool as a programmer is a proper editor. It should offer you a wide selection of tools but get out of your way when you don't need it
. While there are manny advanced editors and IDEs out in the wild, its always good to start with the basics, to get a proper grasp and understanding of the
language.
1. Head to <https://bluej.org/>
2. Click on the download link
![BlueJ_download](img/day0/bluej_download_mac.png)
3. Click on the BlueJ mac zip that was downloaded to automatically unzip the file
4. In the BlueJ folder that was just created, drag `BlueJ.app` to your `Applications` folder
![BlueJ_Drag](img/day0/mac_bluej_drag.gif)
5. Open BlueJ
![bluej_open](img/day0/bluej_open_mac.png)
### Create a "Projects" folder (mac)
I keep all my projects in a folder called "Projects" in my home directory. On Windows this is at `/Users/<your username>/Projects`. Create this folder now. Bookmark it, put it in your favorites, don't lose it.
1. In BlueJ, go to the **Project** menu and click on **New Project**
![bluej_project_new_mac](img/day0/bluej_project_new_mac.png)
2. For the Name, enter `java_game`, for the Location, select the `Projects` folder you created in the step above.
![bluej_choose_project](img/day0/bluej_choose_project2.gif)