Skip to content

Latest commit

 

History

History
83 lines (52 loc) · 2.48 KB

BUILDING.md

File metadata and controls

83 lines (52 loc) · 2.48 KB
Raw

Compiling from Source

Introduction

In addition to the standard Java tools, Renjin relies on a GCC-based build chain to compile C/Fortran math routines to JVM byte code. These tools are under active development and are sensitive to different versions of GCC. The current version of Renjin requires GCC 4.7.x.

Requirements

  1. JDK 1.8 Recommended
  2. GCC 4.7

Vagrant

Vagrant is a tool that helps manage virtual development environments and will help you quickly setup a Virtual Box with all the tools needed for Renjin's C/Fortran compile step.

Install Vagrant from https://www.vagrantup.com and then run the following from the root of the Renjin git repository that calls the Vagrantfile:

vagrant up
vagrant ssh -c "cd /home/ubuntu/renjin && ./gradlew build"

Vagrant configures a shared directory on the VirtualBox guest machine that includes the Renjin repository, so once the initial build is complete you can work normally from your IDE on your own (host) machine.

Note that this requires that your host machine has a case-sensitive filesystem. For Mac OS X, you can check if your harddrive is case sensitive and, if needed, create a small case-sensitive volume just for Renjin.

Once you have run the build through Vagrant, then you should be able to make iterative changes to the Java sources and debug via your IDE as normal.

Ubuntu 16.04

You can install the required tools through the APT package manager. A 64-bit architecture is required.

sudo apt-get install openjdk-8-jdk make gcc-4.7 gcc-4.7-plugin-dev gfortran-4.7 g++-4.7 gcc-4.7.multilib g++-4.7-multilib libz-dev unzip

Then build:

./gradlew test

From the root of the project.

Ubuntu 20.04

You can install some of the required tools through the APT package manager:

sudo apt-get install openjdk-8-jdk build-essential gcc-multilib libgmp-dev libz-dev unzip

Then you will need to run the following script to download, patch and build gcc-4.7 from source:

./build-gcc-4.7.sh

Finally, run the following to install gcc-4.7:

cd gcc-4.7 && sudo make install

Other platforms

For other platforms, consider using Vagrant to bootstrap your build, or you may need to experiment a bit.

You can also ask for help on the mailing list (renjin-dev@googlegroups.com).