Symbian OS Tips, Tricks & Code

The following utility is a command line-based UIQ 3 wizard, which creates new Symbian OS v9.1/UIQ 3 projects for Sony Ericsson P990 and M600 phones. This wizard makes it quick and easy to create the initial project files. 

The zip-file below includes the Windows exe-file and the source code for the wizard application, as well as a sample configuration file.

Download example application>>

To install the wizard, copy "uiq3wizard.exe" to a folder which is included in your search path. To see the current Windows path setting, give the command "set PATH". When the exe-file has been copied to a folder in the path, the wizard can be run by giving the command "uiq3wizard" with appropriate parameters:

uiq3wizard name [uid]

An example of an invocation is "uiq3wizard helloworld 0xE1234567". If no UID is given, the default value is 0xE0000001. However, it is recommended to always give a unique UID, since this will make it possible for different test applications to co-exist. For test applications, experimental UIDs can be used. For unsigned applications, test UIDs should be in the range 0xE0000000 - 0xEFFFFFFF, and for signed applications the range 0x00000000 - 0x0FFFFFFF. More information about UIDs can be found here>>

A configuration file can be used to control the prefix used in the pkg-file for local folders. If no configuration file is provided, the prefix will use the default value "\Symbian\UIQ3SDK". A configuration file might for example contain the string "\Symbian\UIQ3SDK_BETA2". The file should exist in the folder where uiq3wizard is started.

When run without parameters, uiq3wizard will display an explanation of the parameters and the configuration file.

When the uiq3wizard tool is used, a new project will be created in a folder with a given name. The folder will contain the appropriate files, for example mmp, pkg, cpp and h-files. The created project will support different UI modes.

To build a project "myproj" that has been created using the uiq3wizard, do the following:

$ bldmake bldfiles
$ abld build gcce urel
$ makesis myproj.pkg

More information:

• Previous Tips, Trick & Code article "Using different UI modes for the P990 smartphone: a code example">>
• Symbian Signed UIDs>>