When you have completed the installation you can continue with the Getting Started page, or the overview page.
No special steps are needed when installing SICStus for use by SPIDER, an ordinary install will work fine.
SPIDER tends to work best with the latest version of SICStus. SPIDER works with both 32-bit and 64-bit versions of SICStus Prolog.
You should install a recent version (i.e. Java 11 or later) of Java. A 64-bit version of Java is needed.
Java can be obtained from Oracle but there are many other distributions, e.g. AdoptOpenJDK, and if you are running Linux you can use the version of Java that comes with your Linux distribution.
It should not matter whether you install the smaller Java “JRE” or the full Java “JDK”, but we always use the full JDK.
Follow the instructions on the Eclipse web site for how to unpack or install the version of Eclipse you chose.
Eclipse comes in many configurations. We recommend “Eclipse IDE for Java Developers”, which has support for developing Java programs, but any variant of Eclipse should work fine.
The minimum supported version of Eclipse is 2019-03 (4.11) but we recommend to always use the latest version (currently, May 2020, Eclipse 2020-03 (4.15)).
Note: (Linux only) Do not attempt to use the Eclipse tha comes with your Linux distribution, since it is most likely much too old to be useful.
This is done by telling Eclipse about the SPIDER Software Site, https://sicstus.sics.se/sicstus/update/. See below for details.
The final step in setting up SPIDER is to tell it about the location of the SICStus Prolog binaries. If it cannot do this automatically, it will prompt you at start-up and offer to open the relevant Settings page. See below for details.
Note: You should change the Settings every time you update SICStus Prolog, so that SPIDER always uses the latest version of SICStus Prolog.
We expect to release new versions of SPIDER more often than of SICStus Prolog itself. For this reason it is a good idea to let Eclipse check for updates occasionally.
You can check for new versions of SPIDER by selecting “Check for Updates” in the Eclipse Help menu. It is also possible to tell Eclipse to check for updates automatically.
Every time you install a new version of SICStus Prolog you need to change the SPIDER preferences to tell it about the new version.
Once you have Eclipse up and running you need to tell it to download and install the SICStus specific features.
Eclipse has a concept of “Update Site” which is a web location with special contents.
The update site for SPIDER is https://sicstus.sics.se/sicstus/update/. Note that this update site does not contain any interesting human readable contents.
Select the “Install New Software” menu item from the Eclipse Help menu.
(The screen shots are from an old version of Eclipse, it should look similar in current versions of Eclipse).
Then fill in the update site address (https://sicstus.sics.se/sicstus/update/) and click the Add button, as shown in the screenshot.
You can give the update site a name, e.g. SICStus Prolog IDE.
Eclipse should now present a list of the features available at the update site.
Select the SICStus IDE Feature and click Next. Accept the license terms and click Finish.
Eclipse may warn about “… unsigned content.”, this can safely be ignored in this case.
Allow Eclipse to restart itself.
There should now be a Prolog-specific entry on the Eclipse Welcome Page (you can open the Welcome Page from the Help menu). You should close the Welcome page, e.g. by clicking on the “Workbench” button in the upper right corner.
If SPIDER could not automatically select the SICStus Prolog to use, it will prompt you to set things up in the preferences, as shown below.
Once SPIDER has been installed into Eclipse you need to tell SPIDER about where the SICStus program, e.g. sicstus.exe is located. Typically SPIDER will prompt you to to open the preferences, but you may also do this manually, e.g. after you have installed a more recent version of SICStus Prolog.
The SPIDER preference page “Installed SICStus Prologs” lets you search for available SICStus Prolog installations and select which one to use. If you installed SICStus Prolog in the default location, it will typically be found automatically. It is also possible to use the Search button to search for all installations within a folder tree on disk.
(The screen shots are from an old version of Eclipse, it should look similar in current versions of Eclipse).
Once you have selected a SICStus executable, and closed the preferences dialog, a “Prolog Reference” project should be created (or updated) automatically. This is a project that refers to the library files that comes with SICStus Prolog. You should not modify this project (but you can use it to browse the library files and their example code).
Setup of SPIDER is now complete. Continue at Getting Started.
