Builder _ Installation _ LINUX

Overview > Builder >

Installing GUIslice Builder on LINUX

EMAIL SUPPORT: During the beta, please feel free to send an email to [email protected] with any comments, questions or suggestions you might have

Java Installation

The GUIslice Builder on LINUX requires Java to be installed on your system.

• If the Arduino IDE 1.8.7 is installed, then the Java 8 JRE should already be present
• Otherwise, please install Java 8 JRE

During installation you will need to identify what directory has the Java 8 JRE.

Depending on whether you have already installed Java or the Arduino IDE, select one of the following three options.

Option A: If Arduino IDE already installed

For Arduino's IDE Java it is inside your current Arduino IDE directory for example:

• $HOME/arduino-1.8.7/java

Option B: If Arduino IDE not installed but java previously installed

If you are not using Arduino's Java but you have previously installed other versions of Java, then you can find the full set of installed versions by using this command:

sudo update-alternatives --config java

Example output:

There are 2 choices for the alternative java (providing /usr/bin/java).

  Selection    Path                                            Priority   Status
------------------------------------------------------------
* 0            /usr/lib/jvm/java-11-openjdk-amd64/bin/java      1101      auto mode
  1            /usr/lib/jvm/java-11-openjdk-amd64/bin/java      1101      manual mode
  2            /usr/lib/jvm/java-8-openjdk-amd64/jre/bin/java   1081      manual mode

Press <enter> to keep the current choice[*], or type selection number:

After Identifying the correct location of java 8 or 1.8 you can enter the path during the run of install.sh script.

If you are using Arduino IDE's skip to LINUX GUIsliceBuilder SETUP.

Option C: If Arduino IDE not installed and no java previously installed

You can download Java 8 JRE by opening a terminal and using:

sudo add-apt-repository ppa:openjdk-r/ppa
sudo apt-get update

sudo apt install openjdk-8-jre

As we will need to find the exact path to the Java JRE, it may be possible to use the following command:

• sudo update-alternatives --config
• The above might report: There is only one alternative in link group java (providing /usr/bin/java): /usr/lib/jvm/java-8-openjdk-amd64/jre/bin/java
• In this example, the full path would be /usr/lib/jvm/java-8-openjdk-amd64/jre/bin/java
• An alternate approach that may work for some users is to run readlink -f $(which java)

GUIsliceBuilder Setup

GUIslice Builder binary location:

• In the latest GUIslice Builder repo Release Notes under Assets, you will find builder-linux-X.Y.Z.tar.gz

  • Look for the highest version number

• Download and untar builder-linux-X.Y.Z.tar.gz into your home directory, where X.Y.Z represents the latest version number

  • Open a terminal
  • cd $HOME
  • Download the builder-linux-X.Y.Z.tar.gz using a web browser (see above), or use the equivalent wget command, for example: wget https://github.com/ImpulseAdventure/GUIslice/releases/download/v#.#.#/builder-linux-X.Y.Z.tar.gz
  • tar xvzf builder-linux-X.Y.Z.tar.gz

• Enter the new GUIsliceBuilder folder

  • cd GUIsliceBuilder

• Run the installer and indicate where the Java 8 files are located.

  • ./install.sh
  • When the installer runs, it will prompt for the location of Java 8. IMPORTANT NOTE: you must enter the path (identified earlier), but not including the /bin/java at the end. For example, if the complete path is: /usr/lib/jvm/java-8-openjdk-amd64/jre/bin/java, then please enter /usr/lib/jvm/java-8-openjdk-amd64/jre

The GUIsliceBuilder should now be on your Desktop.

Launching the Builder

Clicking on the GUIslice icon on your Desktop will open the builder.

You can also run the builder by: ./GUIslice.sh