Windows Installation Guide
This document will guide you through setup on Windows so you'll be ready to do the course exercises, and optionally, continue exploring Scala after you're done.
Part 1: prerequisites for course exercises
Check your Java installation
IMPORTANT: These instructions work only if you use the default Windows Command Prompt (they may work in PowerShell also, but this hasn't been tested). There is a known issue in which the doodle project will hang indefinitely if you use a different terminal such as Cygwin.
You will need a command prompt window to complete the installation. In Windows 10, type
cmd into the text box to the bottom left of your screen and hit
enter. The command prompot window should then come up. It looks something like this:
If you're having trouble launching the command prompt or are on a different version of Windows, refer to these instructions.
java -version at the prompt. If you have Java installed you should get a response like:
C:\Users\Taylor>java -d64 -version java version "1.8.0_101" Java(TM) SE Runtime Environment (build 1.8.0_101-b13) Java HotSpot(TM) 64-Bit Server VM (build 25.101-b13, mixed mode) C:\Users\Taylor>
If your Java version is 1.8 or higher, then you can skip the Java JDK Installation section below. If you get an error or different looking output than above, you should continue with the Java JDK Installation.
Java JDK Installation
- Download the JDK installer for Windows from Oracle. Choose the 64-bit installation option, refered to as
x64. The 32-bit installation (known as x86) will not work.
- Run the installer
- Add the
bin\directory of the installed JDK to the PATH environment variable, as described here
- To verify the JDK installation, open the Command Prompt and type
java -d64 -version. You should see output to the one in the previous section.
If you have problems installing the JDK, ask for help.
Download the ZIP file here and unzip it into a folder that you can find later. Then, navigate to the directory you unzipped from the Windows Command Prompt, using the
cd command. Ask for help if you get stuck.
sbt.bat. Make sure see output that looks like the following (this will take a little while the first time you do it).
C:\Users\Taylor> sbt.bat . . . (you'll see some [info] logs here) . .
Once that's done, you will see a prompt that looks like
console. It should look something like this:
> console . . . (you'll see some [info] logs here) . . scala>
scala> prompt means that you are ready to test your install. Try the following at the prompt:
After the last command, verify that you see a window open that looks like this:
Part 2: optional Scala and SBT install for further learning
- Go to the Scala Download page and choose the first option to download the Scala binaries installation package to your computer. The
downloadbutton will automatically download the Windows installer for Scala version 2.12.
- Use Windows Explorer to locate and run the installer. The Scala Programming Language Distribution Setup Wizard will appear.
- Repeatedly use the
Nextbutton to choose all the installation defaults. Check the box on the license page to accept the license.
The installer will install the core Scala language, update the System path for the Scala executables, and privide a start menu link to Scala documentation.
Verify installation by opening a command prompt window and entering
scala at the prompt:
C:\Users\Taylor>scala Welcome to Scala 2.12.1 (Java HotSpot(TM) 64-Bit Server VM, Java 1.8.0_74). Type in expressions for evaluation. Or try :help. scala>
scala> prompt indicates you are in the REPL. For now, just type
:quit at the prompt to exit the REPL.
Install sbt using the Windows msi installer (or by downloading the zip file) from the sbt website
Once you have installed it you can run
sbt at the command prompt. You will see something like this:
C:\Users\Taylor>sbt Java HotSpot(TM) 64-Bit Server VM warning: ignoring option MaxPermSize=256m; support was removed in 8.0 [info] Set current project to julie (in build file:/C:/Users/julie/) >
> is the sbt command prompt.