Luet oppimateriaalin englanninkielistä versiota. Mainitsit kuitenkin taustakyselyssä osaavasi suomea. Siksi suosittelemme, että käytät suomenkielistä versiota, joka on testatumpi ja hieman laajempi ja muutenkin mukava.

Suomenkielinen materiaali kyllä esittelee englanninkielisetkin termit. Myös suomenkielisessä materiaalissa käytetään ohjelmaprojektien koodissa englanninkielisiä nimiä kurssin alkupään johdantoesimerkkejä lukuunottamatta.

Voit vaihtaa kieltä A+:n valikon yläreunassa olevasta painikkeesta. Tai tästä: Vaihda suomeksi.

Installing Eclipse and Scala IDE

As mentioned in Chapter 1.2, O1’s official programming environment is the Eclipse IDE and its Scala IDE plugin, which are installed on Aalto IT’s Linux workstations.

If you want to use Eclipse and Scala IDE on your personal computer, you’ll first need to install them. These tools are available for Windows, macOS, and Linux. The newer your operating system, the less likely it is you’ll run into trouble installing the tools.

Version numbers matter!

Any tools you use in O1 should be compatible with version 2.12.6 of the Scala programming language. Officially, we use version 4.7 Oxygen of Eclipse and version 4.7 of Scala IDE. You’ll also need a Java toolkit (JDK); the recommended version is 8.

Follow the instructions below to install the appropriate versions. First, select your operating system:

Windows
macOS
Linux

Windows

Step 1 of 4: Install Java

Screenshots of installing Java.

Use this link to download OpenJDK 8. Pick the 64-bit version.
- (You'll need to be working in a modern 64-bit operating system, not a 32-bit one. To check which kind of environment you're in, see your operating system settings; e.g. Control Panel ‣ System
Install the software simply by executing the downloaded file and agreeing when the installer asks you to approve what it's doing.

Step 2 of 4: Install Eclipse and Scala IDE

Download the Eclipse + Scala IDE bundle, version 4.7.

Install the IDE and its plugin simply by extracting the archive file you downloaded into a folder of your choice:

Double-click the archive to open it.
There’s no installer that you need to run. Just use your mouse to drag the archive’s contents (a folder named eclipse) to wherever you’d like to place it.

Step 3 of 4: Start Eclipse

Launch Eclipse by clicking eclipse.exe within the eclipse folder. When prompted, pick some new folder as your O1 “workspace”: this is the folder where you’ll store the programs that you write during O1.

Troubleshooting: “I launched Eclipse but just got a long error message.”

If that happens, the probable cause is that you’ve installed a 64-bit version of Scala IDE but have a 32-bit version of Java, or the other way around. Please use a modern 64-bit operating system and 64-bit versions of all the required tools.

Step 4 of 4: Adjust settings

We strongly encourage you to import O1’s own preference settings, which suit the course and generally make Eclipse more pleasant to work with. Here’s how:

Download the preferences file o1_2019.epf and save it on your desktop or somewhere else.
In Eclipse, select File ‣ Import... ‣ General ‣ Preferences and press Next.
At From preference file, indicate the location of the file you saved, o1_2019.epf.
Make sure that Import all is ticked.
Press Finish.
Finally, you can make it easier to lauch Eclipse in the future by pinning it to the Windows task bar. Right-click the Eclipse icon in the task bar and select Pin this program to taskbar.

macOS

Step 1 of 4: Install Java

Use this link to download Open Java Development Kit 8 (OpenJDK).
Install the software by executing the downloaded file and agreeing when the installer asks you to approve what it's doing.

Step 2 of 4: Install Eclipse and Scala IDE

Download the Eclipse + Scala IDE bundle, version 4.7.

Install the IDE and its plugin simply by extracting the archive file you downloaded into a folder of your choice:

Double-click the archive to open it.
There’s no installer that you need to run. Just use your mouse to drag the archive’s contents (a folder named eclipse) to wherever you’d like to place it. For instance, you might want to put eclipse under the Applications folder.

Step 3 of 4: Start Eclipse

Troubleshooting: "Eclipse won’t run on my Mac."

Make sure you’ve installed an appropriate version (8) of Java.

Your macOS version may be old. We recommend that you update it. Java’s version 8 requires macOS version 10.8.3 (Mountain Lion) or newer.

Step 4 of 4: Adjust settings

We strongly encourage you to import O1’s own preference settings, which suit the course and generally make Eclipse more pleasant to work with. Here’s how:

Download the preferences file o1_2019.epf and save it on your desktop or somewhere else.
In Eclipse, select File ‣ Import... ‣ General ‣ Preferences and press Next.
At From preference file, indicate the location of the file you saved, o1_2019.epf.
Make sure that Import all is ticked.
Press Finish.
Finally, you can make it easier to launch Eclipse in the future by pinning it to the Dock. Right-click the Eclipse icon and select Options ‣ Keep in Dock.

Ubuntu (Debian Linux)

Step 1 of 4: Install Java

Install OpenJDK 8 from Ubuntu's package manager. All you need to do is open a Terminal and enter these commands:

sudo apt-get update
sudo apt-get install openjdk-8-jdk

You can then enter java -version to ensure that you have the correct version of Java installed.

Step 2 of 4: Install Eclipse and Scala IDE

Download the Eclipse + Scala IDE bundle, version 4.7.

Install the IDE and its plugin simply by extracting the archive file you downloaded into a folder of your choice:

Double-click the archive to open it.
There’s no installer that you need to run. Just use your mouse to drag the archive’s contents (a folder named eclipse) to wherever you’d like to place it.

Step 3 of 4: Start Eclipse

Step 4 of 4: Adjust settings

We strongly encourage you to import O1’s own preference settings, which suit the course and generally make Eclipse more pleasant to work with. Here’s how:

Download the preferences file o1_2019.epf and save it on your desktop or somewhere else.
In Eclipse, select File ‣ Import... ‣ General ‣ Preferences and press Next.
At From preference file, indicate the location of the file you saved, o1_2019.epf.
Make sure that Import all is ticked.
Press Finish.
Finally, you can make it easier to start Eclipse in the future by pinning it to the Launcher. Right-click the Eclipse icon in the Launcher and select Lock to Launcher.

Feedback

Credits

Thousands of students have given feedback that has contributed to this ebook’s design. Thank you!

Weeks 1 to 13 of the ebook, including the assignments and weekly bulletins, have been written in Finnish and translated into English by Juha Sorva.

Weeks 14 to 20 are by Otto Seppälä. That part of the ebook isn’t available during the fall term, but we’ll publish it when it’s time.

The appendices (glossary, Scala reference, FAQ, etc.) are by Juha Sorva unless otherwise specified on the page.

The automatic assessment of the assignments has been developed by: (in alphabetical order) Riku Autio, Nikolas Drosdek, Joonatan Honkamaa, Jaakko Kantojärvi, Niklas Kröger, Teemu Lehtinen, Strasdosky Otewa, Timi Seppälä, Teemu Sirkiä, and Aleksi Vartiainen.

The illustrations at the top of each chapter, and the similar drawings elsewhere in the ebook, are the work of Christina Lassheikki.

The animations that detail the execution Scala programs have been designed by Juha Sorva and Teemu Sirkiä. Teemu Sirkiä and Riku Autio have done the technical implementation, relying on Teemu’s Jsvee and Kelmu toolkits.

The other diagrams and interactive presentations in the ebook are by Juha Sorva.

The O1Library software has been developed by Aleksi Lukkarinen and Juha Sorva. Several of its key components are built upon Aleksi’s SMCL library.

The pedagogy behind O1Library’s tools for simple graphical programming (such as Pic) is inspired by the textbooks How to Design Programs by Flatt, Felleisen, Findler, and Krishnamurthi and Picturing Programs by Stephen Bloch.

The course platform A+ has been created by Aalto’s LeTech research group and is largely developed by students. The current lead developer is Jaakko Kantojärvi; many other students of computer science and information networks are also active on the project.

For O1’s current teaching staff, please see Chapter 1.1.

Additional credits for this page

This page on Eclipse was written by Otto Seppälä, Teemu Sirkiä, and Niklas Kröger. It was edited and translated from Finnish by Juha Sorva.