Introduction

gvSIG Mobile is a software developed in Java to display and manage geographic information in mobile devices (hereafter PDA). This document presents the installation process of gvSIG Mobile and a gvSIG Desktop extension to export projects to gvSIG Mobile.

gvSIG will be named gvSIG Desktop in this document in order to differentiate with gvSIG for mobile devices.

Application Download

To download gvSIG Mobile Installer, please go to the gvSIG web site.

http://www.gvsig.gva.es/index.php

Next is a picture about how the site looks like.

./instalacion-gvsig-mobile.img-1/es/gvsig-download.png

gvSIG Web site.

Next step is to access gvSIG Mobile section, and to look for the installer (see next point).

./instalacion-gvsig-mobile.img-1/es/gvsig-download2.png

Downloading application manuals and installer.

It's also recommended to download the application manuals (even this one). There are download links in the same web site.

Selecting the installer

On the download website, can see several installers. You must select one of them in accordance with your device.

Next, you can see the installer names:

gvSIGMobile-0.2b-build_213-WM2003-Arm-withPhoneMe.CAB where:

gvSIG Mobile runs on Java J2ME CDC Personal Profile JVM. It have been tested using IBM WEME (J9) and PhoneMe Advanced.

Note:

PhoneMe advanced is under development, It is NOT recommended use it on production systems because it has stability problems.

Note:

IBM WEME (J9) it's a Java Virtual Machine licensed by IBM , if you are interested on use it, you must get in contact with IBM.

Those are the present available alpha version 0.2 (pilot 2) installers:

Next, each installer content are explained, if after read it you have any doubts about which one choose, please install gvSIGMobile-0.2a-build_261-WM2003-Arm-withPhoneMe.CAB.

gvSIGMobile-0.2a-build_261-WM2003-Arm-withPhoneMe.CAB

Installs gvSIG Mobile and the PhoneME Advanced JVM on Windows Mobile 2003 based devices. It includes the Java Virtual Machine, and you don't need another software to use gvSIG Mobile.

gvSIGMobile-0.2a-build_261-WM5-Arm-withPhoneMe.CAB

Installs gvSIG Mobile and the PhoneME Advanced JVM on Windows Mobile 5 and Windows Mobile 6 based devices. It includes the Java Virtual Machine, and you don't need another software to use gvSIG Mobile.

gvSIGMobile-0.2a-build_261-WMX-forPhoneMe.CAB

Installs gvSIG Mobile on Windows Mobile based devices. This file includes a executable file which look for the PhoneME Advanced Jave Virtual Machine on the root PDA device path and on the root path on the memory card to get easier the application launcher. To use this installer you must to have installed the PhoneME Advanced JVM on the device previously.

gvSIGMobile-0.2a-build_261-WMX-forJ9.CAB

Installs gvSIG Mobile on Windows Mobile based devices. This file includes a executable file which look for the J9 Jave Virtual Machine on the root PDA device path and on the root path from memory card to get easier the application launcher. To use this installer you must to have installed J9 JVM on the device previously.

gvSIGMobile-0.2a-build_261.zip

Includes the gvSIG Mobile files without installer only. This version is to use gvSIG Mobile under other Operating Systems or with another JVM. To run the application you have to be able call his own JVM, passing the right parameters. It's only expert user's recommended.

Quick gvSIG Mobile Install

The present chapter explains how to install gvSIG Mobile.

gvSIG Mobile Requires a Java Virtual Machine (VM) to run. gvSIG Mobile have been tested on IBM's J9 and SUN's PhoneME Advanced.

There are three different installers:

If you want to use an installer without included VM, you will have to install it separately.

NOTE:

gvSIG Mobile with included SUN PhoneMe Java Virtual Machine Quick Install

First Step: Copy installer to the PDA Device

Next, the new downloaded installer must be copied to the PDA memory. There is different ways to do that depending on the OS. On the following pictures the installation it's done from Windows XP with ActiveSync 4.5 and WM 5.

Second Step: Install gvSIG Mobile into PDA

To start the installation, use the PDA File Explorer and navigate to the place where the gvSIG_Mobile_with_PhoneMe.BNxx.Arm.CAB installer was copied. Now click on it.

In there is a secondary storage (SD expansion memory, etc..), the installation process ask if we want to install it on the Device, or the secondary memory. You can choose both but installation on the PDA root is recommended.

gvSIG Mobile and PhoneMe will be installed and a new gvSIG Mobile link will be created on the programs menu.

./instalacion-gvsig-mobile.img-1/es/foldermenu-es.png

gvSIG Mobile Init.

Now just tab on gvSIG Mobile.exe to run the application

./instalacion-gvsig-mobile.img-1/en/splash-en.png

Start gvSIG Mobile.

There is a log file that logs the launch process and shows the potential errors. This file is in the installation folder and is named gvsig_mobile_launch.log.

The IBM J9 virtual machine

./instalacion-gvsig-mobile.img-1/es/logo-IBM-J9.gif

Currently, gvSIG Mobile run correctly on J9 virtual machine developed by IBM. Previous gvSIG Mobile pilot version, which runs only with this virtual machine exclusively, was be able to download the JVM from the IBM web. Unfortunately, the download link isn't available anymore, thought the compatibility with the IBM JVM is maintained, isn't possible shows a installation process to follow in this manual. If you've got an installation of this JVM, you don't need download and install anyone, even if you are thinking about get this IBM JVM, gvSIG Mobile is compatible.

Once JVM IBM J9 is installed on the device, following the next steps to finish the installation of gvSIG Mobile IBM J9 version.

Download from the gvSIG web, if it wasn't done before, in the previous step, the gvSIG installer IBM J9 compatible.

To conclude the gvSIG Mobile install, follow the Second and Third previous chapter steps.

The PhoneMe virtual machine

./instalacion-gvsig-mobile.img-1/es/logo-Phoneme.png

Nowadays, the PhoneMe Advanced project is the new Sun JVM for mobile devices in developing process. This JVM is developed by Hinkmond Wong y Davy Preuveneers. In the gvSIG Mobile project, it have been working closer with Davy Preuveneers, who develop the JVM CDC with Personal Profile.

Unlike of J9, the IBM JVM, PhoneMe has GPL license and it's free distributed. This new JVM, can be installed separately from gvSIG Mobile, although it's distributed one gvSIG Mobile installer which includes the PhoneMe virtual machine.

The separately installation option, allows update the JVM as new versions are coming out, without having to uninstall gvSIG Mobile.

On the other hand, the gvSIG Mobile with the included PhoneMe JVM installation, guarantees the installation of the JVM version tested by the gvSIG Mobile developers.

The gvSIG Mobile aplication uses PhoneMe CDC with Personal Profile, it's possible uses this JVM on PDA's and SmartPhones with Windows Mobile Operating Systems (henceforth OS).

NOTE:

Installing PhoneMe virtual machine

If it's made the decision of install the PhoneMe JVM separately from gvSIG Mobile installation, next there are some details about the steps to download and install on the device.

First Step: Download the JVM

PhoneMe has a web to download the CAB file installers for Windows Mobile. The web offers several JVM supporting different Operating Systems and performances. Have to select the correct installer for the device OS where the application will be installed. For gvSIG Mobile are allowed the JVM since the WM2003 generated for.

Furthermore, there are differences between several JVM, based on the device and performance. To be able to execute gvSIG Mobile is needed the PhoneMe CDC with Personal Profile JVM, one of the most performance to mobile devices.

Select the correct JVM and download it.

Go to Davy's Web site to do that:

http://www.cs.kuleuven.be/~davy/phoneme/downloads.htm

The web looks like the next picture showed.

instalacion-gvsig-mobile.img-1/es/phoneme-download.png

PhoneMe download website.

Second Step: Syncrhonize with PDA Device

Next, the new downloaded installer must be copied to the PDA memory. There is a manner to do that from PC through the PDA depending on the used OS. On the following pictures the installation it's done from Windows XP with ActiveSync 4.5 to WM 5.

Third Step: Install JVM on the PDA

To Begin the installation, search on the PDA File Explorer, the place where the CAB installer was copied, and run it.

In the case of some memory extern device is available (SD expansion memory, etc..), the installation process ask us about if is wanted to install on the Device, or the secondary memory instead of it, to save device main memory.

Automatically, the JVM is installed at the device, making a new folder named phoneme and now allows running the JVM.

Once JVM SUN PhoneMe is installed on the device, following the next steps to finish the installation of gvSIG Mobile PhoneMe version.

Download from the gvSIG web, if it wasn't done before, in the previous step, the gvSIG installer PhoneMe compatible.

To conclude the gvSIG Mobile install, follow the Second and Third steps from the Quick gvSIG Mobile Install chapter.

Installing the export extension on gvSIG Desktop

The pilot is complemented with an extension to gvSIG Desktop which allows the user to export vector and raster data from a gvSIG Desktop view into a folder, ready to be sent to the PDA.

./instalacion-gvsig-mobile.img-1/en/exportinstall-en.png

Installer extension.

The installation process is similar to any other extension of gvSIG Desktop. Using an easy multiplatform installer, the extension is added to an installation of gvSIG Desktop.

This extension is compatible with gvSIG 1.1 and later revisions.

./instalacion-gvsig-mobile.img-1/en/exportrun-en.png

Main window exporter.