- Install Java 8 or higher
- Install sbt at http://www.scala-sbt.org/
- To build Rholang from source configure/fetch dependencies
- BNFC - must be built from must be built from git b0252e5f666ed67a65b6e986748eccbfe802bc17 or later
- Clone RChain repository - git clone https://github.com/rchain/rchain
- Checkout dev branch - git checkout dev
- To build Rosette jar file go to roscala directory and run sbt assembly, built file should be located at ./target/scala-2.12
The project is built using Scala 2.12.4 and sbt 1.0.3 (for more information see build.sbt files)
If cross-developing for Linux (e.g. Ubuntu) on a Mac, you will need a virtual machine running the appropriate version of Linux.
- Download and install VirtualBox from https://www.virtualbox.org/wiki/Downloads
- Download the Linux distribution you need e.g. http://releases.ubuntu.com/16.04/ubuntu-16.04.3-server-amd64.iso
- Start VirtualBox and create a new Virtual Machine in the Manager.
- Boot your virtual machine using the Linux distribution ISO you downloaded earlier.
- Configure your Linux VM as desired. You may need to install additional tools such as g++, g++-multilib, make, git etc.
For a more convenient experience, you can share a folder on your Mac with the virtual machine. To do this you will need to install the VirtualBox Guest Additions. Unfortunately there are some gotchas with this. You may need to utilize one of the solutions at https://askubuntu.com/questions/573596/unable-to-install-guest-additions-cd-image-on-virtual-boxSee the README in the RChain repo for guidance to set up your development environment.