Using binaries

If you downloaded precomplied binaries, follow the instructions below.

JaRMoSA

As already mentioned in Direct file download, the easiest is to directly use this link from within your mobile device' browser.

In order to manually install jarmosapp on your mobile device, you need to:

Transfer the APK to the device using the method of your choice (e.g. USB cable)
Open the stored file using e.g. the ES File Explorer (http://play.google.com/store/apps/details?id=com.estrongs.android.pop&hl=en).
Follow the device-dependent procedure to install the APK
Run the app!

Another way is to use the android debug bridge (adb), which is contained in the Android SDK (see JaRMoSA)

JaRMoSPC

The JaRMoS PC binaries come as a .zip file containing the main .jar package and all required libraries in the folder lib/. Extract the archive to a location of your choice and run the jar-File by e.g. double click.

From command line, enter the folder using a terminal or cmd (Windows) and run

java -jar JaRMoSPC-<version>.jar [<model_folder>]

in order to start JaRMoSPC using the specified model folder.

Note that Java needs to be available on your PATH. If you omit the <model_folder> argument, a default directory selection dialog will prompt you to select a model directory (See JaRMoS model definitions).

Installation from source

Once you have compiled your component, you can follow the instructions Using binaries.

JaRMoSA

In order to build JaRMoS App yourself, you need

Java JDK 1.6 or higher: http://www.java.com/en/download/
Android SDK: http://developer.android.com/sdk/index.html
Eclipse IDE (optional): http://www.eclipse.org/downloads/
Ant (if no Eclipse is used): http://ant.apache.org/

If you dont want to use Eclipse, you will need Ant in order to build JaRMoS components.

Building with Eclipse

After download of the sources, you can use the import feature of Eclipse to create the projects within Eclipse. Once all projects are imported, you need to configure the build path:

For all projects, the .classpath file should be detected and used by Eclipse in order to establish links and dependencies for building. If that does not work, the respective .jar libraries are contained in the lib/ folders of the projects, and JUnit can be found in the JaRMoS root directory under lib/. Jar files can also be referenced over different projects.
For JaRMoS App, additionally the "Order and Export" options (Properties -> Java Build Path -> Order and Export) have to be ticked for all referenced jar files. Otherwise the app will crash due to missing classes.

Now you can connect your android device, make sure it works with adb via

adb devices

and run the application e.g. via right-click on the JaRMoSA-project -> Run as -> Android Application.

Building with Ant

Simply open a terminal/console/command with the ant binary available on the path, change into the JaRMoS root folder and type

ant <target>

If you dont specify a target and just call ant, everything will be built. The possible targets are

all: builds all components including source zips and documentation
src: Creates the source .zip and .tar.gz files
jarmosa: Builds the JaRMoS App APK in JaRMoSA/bin/
jarmospc: Creates a JaRMoS PC .zip file containing JaRMoSPC-<version>.jar and dependencies
docs: Creates the documentation. Can be run without previously running any other target, however, compiling jarmosa and jarmospc will have it correctly including the download files in the documentation.

Ant will place all build outputs in a build folder at the JaRMoS root directory.

JaRMoSPC

Once the build path is configured correctly (which should be done automatically as within-workspace references are included in the .classpath files), simply use the Eclipse built-in Run configurations and select Run as... -> Java Application on jarmos.pc.Main.