Back to Table of Contents

Changing the application language

Changing the application language is about changing the menus and prompts in the mobile client. To do this, you will need to edit the language properties file. The process is very similar to changing the server URL.

To do this you will need java installed on your desktop machine where you are editing the .jar

Open a terminal / command prompt:

  • Windows: from the start menu, go to run a program and type cmd
  • Mac: Terminal is in the utilities
  • Linux: gnome-terminal / xterm / terminator etc.

From the command prompt type:
$ java -version
If you see something like
java version "1.6.0_32"
Java(TM) SE Runtime Environment (build 1.6.0_32-b05)
Java HotSpot(TM) 64-Bit Server VM (build 20.7-b02, mixed mode)
you should be able to update your jar.

Extract the language properties file from the jar

At the command prompt, navigate to the location of your mobile client - e.g. mforms-midlet-2.4.8-me.jar

$ jar -xf mforms-midlet-2.4.8-me.jar

(Don't forget to use your midlet name)

This extracts the file from your jar and you should now see it in the folder you are in with your mforms-midlet-2.4.8-me.jar. If you omit from the end of the command it will extract the entire contents of the jar. In this case you will also be able to see the which is the spanish translation of the application that comes by default with the mforms client.

If you are running mforms on a spanish phone, the phone should detect the _es file and use the spanish version automatically

Edit the file

Open in your favorite text editor (not Word) e.g. notepad, gedit

It will contain many lines, this is a sample from
MAIN_MENU=Menu Principal
SELECT_STUDY=Elija estudio
SELECT_FORM=Elija formulario
DOWNLOAD_STUDIES=Descargar estudios
DOWNLOAD_FORMS=Descargar formularios
UPLOAD_DATA=Cargar datos
DOWNLOAD_DATA=Descargar datos
LOGOUT=Terminar sesión
LOGOUT_PROMPT=¿Desea salir de la aplicación?
DATE_FORMAT=Formato Fecha

Edit this for your translations.

When you are finished, save this file back to where you opened it

Update your jar with your new

At the command prompt, navigate to the location of your mobile client again

$ jar -uf mforms-midlet-2.4.8-me.jar

This is the same as before but with -uf instead of -xf

(Don't forget to use your midlet name)

Check it woks

Copy your jar onto your phone and you should now have a new default menu.