Tool Instructions

On the Programming 2 course, we use the following tools:

Java Development Kit (JDK), a software development kit that includes, among other things, the Java compiler and the Java Virtual Machine for running Java programs.
Git, a version control system (VCS) that enables source code versioning and collaboration between developers.
IntelliJ IDEA, an integrated development environment (IDE) for developing and debugging Java programs and more. We use the free Community Edition of IntelliJ IDEA.
SceneBuilder, a helper tool for creating JavaFX user interfaces.

The above programs are pre-installed in the Agora computer classrooms. If you have your own computer, we strongly recommend installing them there as well. In particular, completing the project work is much easier when all required tools are available on your own computer.

The officially supported operating systems for this course are Windows, macOS, and Linux. Installing the tools on ChromeOS may be possible, but unfortunately we cannot provide support for that operating system. For this reason, we do not recommend using ChromeOS.

Select your operating system below.

The instructions below have been tested on:

Windows 11
Windows 10 (version 1809 or newer)

You can see your Windows version by running the following command in PowerShell:

winver

Select your operating system from the options above.

Prerequisites

If Windows Update offers operating system updates, install them.

After that, verify that the winget package manager is installed:

Open PowerShell. (search-icon write PowerShell Windows PowerShell).
Run the following command:
```
winget -v
```
The version of winget should be displayed. If you instead receive an error such as: 'winget' is not recognized as the name of a cmdlet, function, script file, or operable program you most likely do not have winget installed. If updating Windows does not help, try the following:
- Verify that your Windows installation is up to date.
- Download and install winget manually. After installation, close and reopen PowerShell.

First, make sure your computer is up to date.

Then verify that the Homebrew package manager is installed:

Open Terminal (Launchpad Terminal).
Run:
```
brew --version
```
If you receive the error: command not found: brew

you must install Homebrew.

How to install Homebrew

Open Terminal
Install the macOS developer tools:

xcode-select --install

You may receive a prompt asking whether you want to install the command-line developer tools(The 'xcode-select' command requires the command line developer tools. Would you like to install the tools now?). If so, choose Install and wait for the installation to finish.

If you receive the message: command line tools are already installed you already have the required tools.

install Homebrew:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Allow the installation to complete.

When prompted for a password, enter your macOS password and press Enter. Note that no characters, not even asterisks, are shown while typing the password.

When Homebrew asks:

Press RETURN/ENTER to continue or any other key to abort:

press Enter and wait for the installation to complete.

Run the following command:

BREW_PREFIX=$( [[ $(uname -m) == arm64 ]] && echo /opt/homebrew || echo /usr/local )
echo >> ~/.zprofile
echo "eval \"\$(${BREW_PREFIX}/bin/brew shellenv)\"" >> ~/.zprofile
eval "$(${BREW_PREFIX}/bin/brew shellenv)"

Finally, verify that Homebrew works:

brew --version

If installation succeeded, you should see output similar to:

Homebrew X.X.X

where X.X.X is the installed version number.

Select your operating system from the options above.

Git

First, check whether Git is already installed.

Open PowerShell.
Run:

git --version

If you see the Git version (for example git version X.XX.XX, where X.XX.XX is the exact version), you may skip the Git installation instructions entirely.

If the command is not found, continue with the instructions below.

Installing Git

Open PowerShell.
Install Git for Windows by running the following command:

winget install -e --id=Git.Git --custom '/COMPONENTS="ext,ext\shellhere,ext\guihere"'

Wait until the command completes and grant installation permissions if necessary. If you see a prompt such as:

Do you agree to all the source agreements terms?
[Y] Yes [N] No:

press y and then Enter.

Make sure the output contains:

Successfully installed

Close all open terminals and open a new PowerShell window.
Verify that Git is installed:

git --version

If the installation succeeded, you should see output similar to:

git version X.XX.XX

where X.XX.XX is the installed Git version.

Also verify that Git Bash is installed.

Open:

Search → Git Bash → Git Bash

If everything works correctly, a Git Bash terminal window should open.

First, check whether Git is already installed.

Open Terminal.
Run:

git --version

If the command is not found, continue with the instructions below.

Installing Git

Open Terminal.
Git should already be installed if you completed the prerequisite steps. Verify the installation:

git --version

If successful, you should see output similar to:

git version X.XX.XX

where X.XX.XX is the installed Git version.

First, check whether Git is already installed.

Open your distribution's terminal.
Run:

git --version

If you see the Git version, you may skip the Git installation instructions entirely.

If the command is not found:

Installing Git

Open your distribution's terminal.
Install the git package. The package name is generally the same across common Linux distributions such as Ubuntu, Debian, Fedora, and Arch.
After installation, close and reopen the terminal.
Verify the installation:

git --version

If successful, you should see output similar to:

git version X.XX.XX

where X.XX.XX is the installed Git version.

Select your operating system from the options above.

IntelliJ IDEA

Open PowerShell.
Install IntelliJ IDEA Community Edition:

winget install --interactive -e --id=JetBrains.IntelliJIDEA.Community

After downloading, the installer will open. Continue through the installer using the Next button. In Installation Options, enable:

Add "Open Folder as Project"
Create Associations: .java, .gradle, .kt

Allow the installation to finish.

At the end of the installation, select Run IntelliJ IDEA and click Finish. Verify that IntelliJ IDEA starts correctly.

The first startup may take some time because the system performs a security check. Accept the license agreement if prompted.

If another JetBrains IDE or Visual Studio Code is installed, IntelliJ IDEA may ask whether you want to import settings from it. You may either import the settings or choose Skip Import.
When startup completes, you should see the Welcome to IntelliJ IDEA screen.
Disable AI-powered code completion:

Settings
→ Editor
→ General
→ Inline Completion

Disable:

Enable local Full Line completion suggestions

Done!

Open Terminal.
Install IntelliJ IDEA:

brew install --cask intellij-idea-ce

Wait for the installation to finish. You may be asked for your macOS password.

Verify that IntelliJ IDEA works:

Open Launchpad and start IntelliJ IDEA CE.

The first startup may take some time. Accept license agreements if prompted.

if IntelliJ asks whether to import settings from another IDE, select Skip Import.
When installation is complete, the Welcome to IntelliJ IDEA screen should be visible.
Disable AI-powered code completion:

Settings
→ Editor
→ General
→ Inline Completion

Disable:

Enable local Full Line completion suggestions

Done!

Open your distribution's terminal.
Install IntelliJ IDEA Community Edition.

Installation methods vary by distribution:

Arch Linux intellij-idea-community-edition:

pacman -S intellij-idea-community-edition

Other distributions (recommended IDEA snap package):

snap install intellij-idea-community --classic

Alternatively, follow the official IntelliJ IDEA installation instructions.

Start IntelliJ IDEA.

Accept license agreements if prompted.

If IntelliJ asks whether to import settings from another development environment, select Skip Import.
When installation is complete, the Welcome to IntelliJ IDEA screen should be visible.
Disable AI-powered code completion:

Settings
→ Editor
→ General
→ Inline Completion

Disable:

Enable local Full Line completion suggestions

Done!

Select your operating system from the options above.

Disabling IntelliJ IDEA AI Assistance

IntelliJ IDEA includes two AI-powered code completion features: AI Assistant and Inline Completion. These attempt to automatically complete code as you write.

You can disable these features as follows.

Disabling AI Assistant

Settings → Plugins
Select the Installed tab
Find JetBrains AI Assistant
Disable the plugin or uninstall it completely

Disabling Inline Completion

Open IntelliJ IDEA to the Welcome to IntelliJ IDEA screen
Select Configure → Settings in the lower-left corner

Navigate to:

Editor
→ General
→ Code Completion
→ Inline

Uncheck:

Enable inline completion using language models

Save the settings.

Java Development Kit (JDK)

Open IntelliJ IDEA and wait until the Welcome to IntelliJ IDEA screen appears.

Click New Project in the middle or upper part of the window.

In the dialog that opens, click the JDK drop-down menu and select Download JDK....

Configure the download as follows:

Version: 25

Vendor: Microsoft OpenJDK Do not change the path shown in the Location field. Finally, click Select.

Leave the remaining project settings unchanged.

Click Create in the lower-right corner and allow the project to load.

This opens the IntelliJ IDEA development environment.

Downloading the JDK may take some time. Wait patiently until all errors and red text disappear.

When the project has loaded successfully and no errors are visible, run the project using the Play button in the upper-right corner.

Wait for the project to compile.

If everything works correctly, a console window should appear at the bottom with output similar to:
Hello and welcome!

i = 1
i = 2
i = 3
i = 4
i = 5
You may now close IntelliJ IDEA.

SceneBuilder

Open PowerShell.
Install SceneBuilder:
```
winget install -e --id=Gluon.SceneBuilder
```
Wait for the installation to complete and grant permissions if necessary.

If you see a prompt such as:
```
Do you agree to all the source agreements terms?
[Y] Yes [N] No:
```
press y and then Enter.

Verify that the output contains: Successfully installed
Test that SceneBuilder works: Search → SceneBuilder → SceneBuilder

Verify that the application launches correctly.
Close the application.

Done!

Open Terminal.
Install SceneBuilder:
```
brew install --cask scenebuilder
```
Wait for the installation to complete. You may be asked for your macOS password.
Verify that SceneBuilder works.

Open Launchpad and start SceneBuilder.

The application should launch successfully.
Close the application.

Done!

Open your distribution's terminal.
Install SceneBuilder. Installation methods vary between distributions:
- Arch Linux Install the javafx-scenebuilder package from the AUR by hand or by using the yay tool. For example:
```
yay -S javafx-scenebuilder
```
- Flatpak
```
flatpak install flathub com.gluonhq.SceneBuilder
```
- Other distributions We recommend downloading the official .rpm or .deb package from the SceneBuilder website. Installing a .deb package (Debian, Ubuntu, Linux Mint):
```
sudo dpkg -i file.deb
```
Installing an .rpm package (Fedora, CentOS):
```
sudo rpm -i file.rpm
```
Verify that SceneBuilder works.

Start SceneBuilder from your application menu or from the command line. Close the application.

Done!

Select your operating system from the options above.

What Next?

Congratulations!

You now have all the tools required for the course and can continue to the course materials.

Common Problems and Solutions

I get the error error: illegal character: '\ufeff' when running a Java project in my IDE.

A problem may occur if you imported settings from JetBrains Rider. Rider settings are not completely compatible with Java development, and IntelliJ IDEA may not automatically fix the resulting issues.

Try the following:

Open IntelliJ IDEA and return to the Welcome to IntelliJ IDEA screen.

If an old project opens automatically, select: File → Close Project

Open: Configure → Settings
Navigate to: Editor → File Encodings
Set: Create UTF-8 files to: with no BOM
Save the settings.
Create a new project and try running a simple program.

Internal error: com.intellij.platform.ide.bootstrap... Process "C:\...idea64.exe" is still running and does not respond

Another possible cause is that Rider is stuck running in the background.

Try the following:

Close IntelliJ IDEA completely.
Open Rider.
Close Rider.
Start IntelliJ IDEA again.

Programming 2 OHJ 2

Tool Instructions

Windows

macOS

Linux

Choose

Prerequisites

Windows

macOS

Linux

Choose

Git

Windows

macOS

Linux

Choose

IntelliJ IDEA

Windows

macOS

Linux

Choose

Disabling IntelliJ IDEA AI Assistance

Java Development Kit (JDK)

SceneBuilder

Windows

macOS

Linux

Choose

What Next?

Common Problems and Solutions

Keyboard shortcuts

Programming 2 OHJ 2

Choose

Choose

Choose

Choose

Choose