Fullscreen
Loading...
 

Installation on Other Platforms


Steps

  1. Verify your Java Installation
  2. Application Installation
  3. Desktop Integration (Optional)

1. Verify Your Java Installation

Strange Eons is written in Java and can be used on several platforms. In order to work, you must have Java 8 or newer installed. It is recommended that you use a version with JavaFX integrated, especially if you plan to do plug-in development. You can check your version of Java and install or update it as needed by pressing this button:



If the button does not work (for example, if you have disabled JavaScript in your browser), use this installation page instead(external link).

2. Application Installation

Download the latest version of Strange Eons for "Other" systems. This version is packaged as a gzipped tarball (.tar.gz) archive. Copy this archive to wherever you want to install the application. Unpacking is done in two steps. First, unpack the tarball. Enter the following commands in a shell window (replacing the parts in braces with the information indicated):

cd {directory where you copied the file}
tar -xzf strange-eons-nix-b{XXXX}.tar.gz


This will extract the files README, unpack.jar and strange-eons.selibrary.pack. The file unpack.jar is a small Java application that will unpack the main library file for use. Still in the same directory as these two files, enter:

java -jar unpack.jar


If all goes well, the packed file will be unpacked to strange-eons.selibrary and the .pack file will be deleted. Assuming everything is working so far, you can delete unpack.jar:

rm unpack.jar


The .selibrary file that you have unpacked is Strange Eons. The file uses a dual format: it is a Strange Eons library bundle, but it is also a zip archive that you can pass to Java in order to run Strange Eons and other related tools. To start Strange Eons you can use a command like the following:

java -Xms128m -Xmx1024m -cp strange-eons.selibrary strangeeons


3. Desktop Integration

Since the magical incantation above is not exactly convenient to type or remember, Strange Eons includes a command to integrate with the desktop. This command should work with any desktop that supports the freedesktop.org standards (including Gnome and KDE). To perform this step, enter the following command:

java -cp strange-eons.selibrary register


Desktop integration will take a few moments. The register utility will print information on its progress as it runs. After registration completes, you may need to log out and log back in before Strange Eons will appear in your application menu.

Troubleshooting Desktop Integration Issues
The register utility requires that the package xdg-utils be installed. Recent builds of most popular Linux distributions will come with this package installed. If not, you will have to install it yourself. A typical command to do this step is:

sudo apt-get install xdg-utils


Refer to the documentation for your particular distribution for more information.

If xdg-utils is installed but the registration utility can't find it, you can specify the installation directory with the --xdg option. If register can't find your Java installation, you can specify a location with the --java option. However, as long as the correct version of Java is in your path, you should not need this option.

Normally, register will attempt to register the application for the current user only. To register for all users, you can try the --allusers option. (Your account must be allowed to run sudo commands for this to work.)

For a complete list of options that can be used with register, specify the --help option.


Contributors to this page: Chris Jennings and system .
Page last modified on Monday 23 of November, 2015 18:21:04 EST by Chris Jennings.