The Emerald Programming Environment -- Installation Guides
Docker (Recommended)
The recommended way to run Emerald for basic development is to use the Docker image. This ensures a consistent development experience for all students.
- The image designed for this course is on Docker Hub: portoleks/in5570v21.
- If you prefer not to download software from Docker Hub, let Oleks know.
- There is a convenient Makefile for working with the Docker image here.
- A guide and tools for Windows users will become available after the first exercise session.
Compiling and running
- ec is the Emerald compiler (given a .m file, produces a .x file)
- emx is the Emerald runtime (given a .x file, runs it)
Emerald modes
Install Emerald Natively
Mac
- Download Mac-versjon
- Unpack the package to the location where you want to install emerald
(e.g., /opt - The package is then unpacked in the directory
emerald-PACKAGEVERSION under /opt) - Set EMERALDROOT in your environment to point to this directory (e.g.,
export EMERALDROOT=/opt/emerald )
Windows
- Download Windows-version
- Created by Stig Halvorsen. ec that can be copied to bin directory! her
- Set the path environment variable, read the README in ec download for instructions.
Linux
- Conceptually the same procedure as shown for mac, but because some problems with address space layout randomization some versions of linux want run the compiler. Feel free to try the mac-guide(it depends on which version of the linux kernel you run). Or you can download the 0.99 version of the compiler under here.
- Download Linux-version