Creating a BEAM JAR

Building BEAM as a JAR through Gradle:

1. Once your BEAM project is running on an IDE like IntelliJ, go to your build.gradle file.
2. We're going to build a fatJar, which is an executable file that includes all of the dependencies in the jar.
3. We will need an additional plugin for creating the fatJar. In build.gradle, put this plugin into the plugins section: [id "com.github.johnrengelman.shadow" version "5.2.0"] // Shadow helps create fatJars

Your plugins should look similar to this:

plugins {

    id "net.ltgt.apt" version "0.5"
    
    id "de.undercouch.download" version "3.2.0"
    
    id "org.scoverage" version "2.5.0"
    
    id 'maven-publish'
    
    id "me.champeau.gradle.jmh" version "0.5.0"
    
    id "com.github.johnrengelman.shadow" version "5.2.0" // Shadow helps create fatJars

}

4. In the same build.gradle file, scroll down to under tasks.withType(scalaCompile){}
5. Copy and paste this under tasks.withType(scalaCompile){} [not the line of code, the entire section]

mainClassName = 'beam.sim.RunBeam'

shadowJar{

    zip64 true
    
    mergeServiceFiles('reference.conf')
    
    manifest{
    
        attributes 'Main-Class': mainClassName
    
    }
}

Also check to see if there is another line in the build.gradle that sets the mainClassName (I believe it is a couple hundred lines earlier, but I could be wrong). This line can be deleted/commented/whatever so Shadow doesn't get confused (I'm not actually sure what happens if you have two different mainClassNames, but no need to try fate).

6. Compile the jar using this command while in your BEAM project directory:

   gradle shadowJar

7. Your new JAR should be in BEAM\build\libs

8. To execute your jar, use this command while in your BEAM project directory:

   java -jar -Xmx8g .\build\libs\beam-0.8.0-all.jar --config test/input/beamville/beam.conf

This example is using the default scenario BEAMVILLE.

9. You will need the additional input files for your scenario as well, otherwise you'll get a error for missing files.