Skip to content

Installation

Jump to bottom
huacayacauh edited this page Sep 26, 2018 · 25 revisions

Install for Ubuntu 16.04 LTS

Install git

sudo apt-get install git  
mkdir git  
git config --global user.name “alice”  
git config --global user.email alice@mail.com  
git config --global core.editor gedit  
git config --global merge.tool kdiff3  
git config --global credential.helper cache  
git config --global push.default simple  
git config --list

Clone SXP

git clone https://github.com/pja35/SXP.git

Install compiler tools

sudo apt-get install default-jdk  
sudo apt-get install nodejs-legacy  
sudo apt-get install nodejs-npm  
sudo apt-get install gradle  
sudo npm install electron-packager -g

Install GUI

cd src/main/js/
electron-packager . SXP --platform=linux --arch=x64 --electron-version=1.2.3

(if electron-packager is not available see alternative way of running the GUI below)

Install Backend

cd ~/git/SXP  
gradle build

(some tests may fail, not a catastrophy, gradle run will still work)

Launch GUI

cd src/main/js/SXP-linux-x64  
./SXP

Alternative way

First:

cd src/main/js/
google-chrome --disable-web-security --user-data-dir html/index.html

Then:

Open a new tab and browse the https://localhost:8081 web page. A warning should be displayed indicating that the connection is not secure. Click on Advanced parameters and Continue to localhost. Chrome is now trusting the SXP self-signed certificate. You can close the tab and continue to browse SXP files.

Launch Backend

gradle run

Install SXP on Aix-Marseille Université machines 2018-2019

In case gradle build raises around one hundred exceptions, most of them of type Exception Description: An exception was thrown while searching for persistence archives with ClassLoader: jdk.internal.loader.ClassLoaders$AppClassLoader Internal Exception: java.lang.NullPointerExceptionjava.lang.NullPointerException jdk which is version 10 must be downgraded to version 8. Since we do not have sudo rights, we install version 8 in our home directory and tell the system to use it. Here is the procedure to fix it:

  1. download to your home directory /amuhome/mylogin/myfolderforjava/ the file jdk-8u181-linux-x64.tar.gz from: https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
  2. extract it: tar xvfz jdk-8u181-linux-x64.tar.gz
  3. tell the system to use it: export JAVA_HOME="/amuhome/mylogin/myfolderforjava/jdk1.8.0_181"
  4. gradle build should now work with usual errors (good style is to implement tests first ;-))

Install for MacOS

Use macport instead of apt-get. Slight modifications:

sudo port install nodejs6
...
sudo port install npm3
...
electron-packager . SXP --platform=darwin --arch=x64 --version=1.2.3
...
cd src/main/js/SXP-darwin-x64 
...
./SXP.app

Install Windows

Download and install latest Github git client.

Clone the repo.

Download and install latest JDK. This should update the classpath automatically.

Download and install latest Gradle.

Download and install latest NodeJS. It includes npm.

npm install electron-packager -g
cd src/main/js/
electron-packager . SXP --platform=win32 --arch=x64 --electron-version=1.2.3

Launch as for other platforms.

Setting up Eclipse

Install latest version for Java developers. This ought to include support for git (egit) and gradle (buildship), check for instance in

File > Import... > Gradle Project

To import the project, you must use the Gradle wizard! Accept recommended options such as gradle wrapper.

Launch by going to gradle tasks pane, Application > run.

Clone this wiki locally