Skip to content

Instantly share code, notes, and snippets.

@floogulinc
Last active January 15, 2021 22:37
Show Gist options
  • Star 0 You must be signed in to star a gist
  • Fork 0 You must be signed in to fork a gist
  • Save floogulinc/2d9f80b278332b0df731e777c43b206c to your computer and use it in GitHub Desktop.
Save floogulinc/2d9f80b278332b0df731e777c43b206c to your computer and use it in GitHub Desktop.
CSCI 3601 Windows development environment setup guide

Setting up the 3601 development environment on Windows

This guide assumes you are running 64-bit Windows 10.

The simple list of what you need is:

Some of these have gotchas you will want to look out for so we have provided a more detailed guide below.

Install Chrome

Download and run the installer from google.com/chrome if you don't already have it.

Install Visual Studio Code

Download and run the installer from code.visualstudio.com

We recommend enabling the two "Add "Open with Code" action to Windows Explorer..." options:

vgy.me

Install Git

Download and run the installer from git-scm.com

Install it with the default options, except for the two screens described below.

You may want to turn off the "Windows Explorer integration" shown below:

vgy.me

You may want to have it use VS Code as the default editor:

vgy.me

Install GitKraken

Download and run the installer from gitkraken.com

When GitKraken starts after installing, click "Sign in with GitHub" and sign into your GitHub account. Then it will bring you to a "Set Up Your Profile" screen. Enter your name and the email address you used for your GitHub account here so your commits will show up as yours.

Install the JDK

You need at least JDK version 11. We recommend OpenJDK 11 (LTS) from AdoptOpenJDK.

If you already have a Java version less than 11 installed, please uninstall it before proceeding. You can check if you have Java installed and what version it is by running java --version in PowerShell.

Download and install it from adoptopenjdk.net

It is recommended that you enable the "Set JAVA_HOME variable" option in the installer:

vgy.me

Install MongoDB

Download and run the MongoDB Community Server installer from mongodb.com.

The "Complete" installation is recommended. Leave the defaults for everything. It may open MongoDB Compass after installation, you can just close it.

Adding the MongoDB tools to the PATH

Search for "environment" and open "Edit the system environment variables"

vgy.me

Click "Environment Variables..."

vgy.me

Select "Path" in the bottom "System variables" pane and click "Edit..."

vgy.me

Make sure nothing is selected, click "Browse..."

vgy.me

Select C:\Program Files\MongoDB\Server\[version]\bin, where [version] is replaced by the version of Mongo you installed (in my example it is version 4.4), then click "OK"

image

Test your MongoDB install

After adding the tools to your path, open a new PowerShell window and run mongo --version. It should work without errors as and look similar to the screenshot below.

mongo --version

Install NodeJS

Download and run the LTS Windows installer from nodejs.org

The "Tools for Native Modules" option is optional. It is not necessary for what we are doing but you may want it for future projects that need it.

vgy.me

Install the Angular CLI

Open PowerShell and run

npm install -g @angular/cli

Now try running ng. You will probably get this error:

vgy.me

To fix this run:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Now if you run ng again you should get something like this:

vgy.me

Additional Setup

We recommend you disable "Hide extensions for known file types" in "Files Explorer Options" so you can see the extensions of your files in Explorer.

You can just search for "File Explorer Options" and find the option in the "View" tab:

vgy.me

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment