Skip to content

Arctic Project Guide

Jump to bottom
Andrew Leonard edited this page Mar 18, 2025 · 24 revisions
Section 1: Introduction

Some Text To Go Here!

Section 2: Installation

Setting Up and Building the Corretto Arctic Project

This guide provides step-by-step instructions for setting up your environment, downloading and installing an appropriate Temurin JDK 17 binary, configuring environment variables, and building the Corretto Arctic project from the command line.

Prerequisites

  • A Git client installed on your system.
  • Administrative privileges (where necessary).

Step 1: Clone the Repository

To get started, clone the GitHub repository to your local machine. Open a terminal and run:

git clone https://github.com/corretto/arctic.git
cd arctic

This command downloads the repository and navigates into the arctic directory.

Step 2: Download and Install Temurin JDK 17

The Temurin JDK 17 binary needs to be installed for your platform. Below are instructions for Linux, Windows, and macOS.

Linux

curl -L -o temurin.tar.gz "https://api.adoptium.net/v3/binary/latest/17/ga/linux/x64/jdk/hotspot/normal/eclipse"
tar -xzf temurin.tar.gz
mv jdk-* temurin-jdk17

Windows (PowerShell)

Invoke-WebRequest -Uri "https://api.adoptium.net/v3/binary/latest/17/ga/windows/x64/jdk/hotspot/normal/eclipse" -OutFile "temurin.zip"
Expand-Archive -Path "temurin.zip" -DestinationPath "temurin-jdk17"

macOS

curl -L -o temurin.tar.gz "https://api.adoptium.net/v3/binary/latest/17/ga/mac/x64/jdk/hotspot/normal/eclipse"
tar -xzf temurin.tar.gz
mv jdk-* temurin-jdk17

Step 3: Configure Environment Variables

Linux/macOS

In the shell, set the environment variables for JAVA_HOME & PATH

export JAVA_HOME=$(pwd)/temurin-jdk17
export PATH=$JAVA_HOME/bin:$PATH

Apply the changes:

source ~/.bashrc  # or source ~/.zshrc

Windows (PowerShell)

$env:JAVA_HOME = "$(Get-Location)\temurin-jdk17"
$env:Path += ";$env:JAVA_HOME\bin"

To make these changes permanent, update the system environment variables manually:

  1. Open System Properties > Advanced > Environment Variables.
  2. Add a new variable JAVA_HOME pointing to the extracted temurin-jdk17 folder.
  3. Append %JAVA_HOME%\bin to the Path variable.

Step 4: Verify Java Installation

Confirm that the correct JDK version is installed:

java -version

The output should indicate JDK 17 from Eclipse Temurin:

openjdk version "17.0.x" 202x-xx-xx

Step 5: Build the Project with Gradle

Navigate to the project root directory:

cd ..  # Move to the project root

Run the Gradle build command:

./gradlew build  # Linux/macOS

.\gradlew.bat build  # Windows

This will download dependencies and build the project.

Conclusion

You have successfully cloned the repository, installed the Temurin JDK 17, set up environment variables, and built the project using Gradle. The built Arctic.jar should be in the build/Jars subdirectory of the base arctic directory

Section 3: Configuration

Configuration Tips

Section 4: Recording A Test
  1. Start "Test case" and ensure in center of the screen
  2. Start Arctic "recorder" CLI
java -jar build/jars/Arctic.jar -r
  1. Workbench window should now have been opened and sent to "background" behind your test case
  2. Move "Shade" to the side out of "Workbench"
  3. Tell Arctic CLI the group and test case name : test start mytests test1
  4. Select test case window as focus
  5. Start recording : Ctrl-Alt-Z
  6. Interact with test case and take screen shots at appropriate check points... : Ctrl-Alt-X
  7. On completion of interaction, stop recording : Ctrl-Alt-Z
  8. Quit Arctic recorder CLI : "Quit"
  9. The recordings will be saved under: ../arctic_tests/default/<group_name>/<test_name>
Section 5: Playing Back A Test (non-RMI mode)
  1. Start "Test case" initial window and ensure in center of the screen
  2. Start Arctic "player" CLI
java -jar build/jars/Arctic.jar -p
  1. Workbench window should now have been opened and sent to "background" behind your test case
  2. Tell Arctic CLI to start "playing" your group and test case : test start mytests test1
  3. Arctic will now interact in "real time" with the test case window using the recordings and verify the screenshots
  4. If all is successful Arctic CLI will output the following:
FINISHED: mytests:test1 with UNCONFIRMED
  1. If some error/failure has occured a message like the following will appear:
FINISHED: mytests:test1 with ABORTED

In this situation you can debug the problem using the "sc review" command in the CLI, this will open the failed screen review window, pressing the ">>" icon repeatedly can be used to visually see what differs between the "current" image and the "recorded" image. 8. Quit Arctic recorder CLI : "Quit" 9. The failed playback images are saved to folder "failures/mytests/test1"

Section 6: Troubleshooting Tips & Tricks

Troubleshooting Tips

Clone this wiki locally