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 menu_text.properties

(Don't forget to use your midlet name)

This extracts the menu_text.properties 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 menu_text.properties 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 menu_text_es.properties 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 menu_text.properties file

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

It will contain many lines, this is a sample from menu_text_es.properties
SELECT=Seleccionar
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
SETTINGS=Configuraciónes
LOGOUT=Terminar sesión
LOGOUT_PROMPT=¿Desea salir de la aplicación?
GENERAL=General
DATE_FORMAT=Formato Fecha
MULTIMEDIA=Multimedia
LANGUAGE=Idioma
CONNECTION=Conexión

Edit this for your translations.

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

Update your jar with your new menu_text.properties

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

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

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.