Skip to content

1. Download & Build

abbasjariani edited this page Dec 16, 2018 · 2 revisions

Download

On the command line, enter the following command to clone the repository to your computer.

git clone --depth 1 https://github.com/santa-dev/santa-sim.git

After you build the project, there will be an executable santa.jar file created inside the dist folder.

However, unless you would like to tweak the code you do not have to build the project. There is a pre-built executable santa.jar available for download in the release section of the repository: https://github.com/santa-dev/santa-sim/releases. You need to have Java installed on your computer to execute this file. Instructions on how to install Java is detailed below.

Build instructions

In case you prefer to build the software from the source code, follow these instructions please.

Quick version:

  • Install Java 8
  • Install Ant
  • Build the SANTA source
  • Start running simulations!]

Install Java 8

You must have Java 8 installed in order to build or run SANTA. On Linux, you can install the latest JRE 8 from Oracle or the latest OpenJDK. Under MacOS you can install the official JRE 8 from Oracle, but I would recommend installing Java through Homebrew. We have not tested SANTA on Windows recently, but it should work. Start by installing the latest JRE 8 for Windows from Oracle.

Install Ant

You will also need to install Apache Ant 1.8 or later to build SANTA. If you do not have ant on your machine you should follow the instructions at:

http://ant.apache.org/manual/install.html

Build the project

When building for the first time, you'll need to have an internet connection, because additional files need to be downloaded.

Change to the directory where you cloned SANTA, and type:

ant dist

A directory called dist will be created which contains the file santa.jar