Using multiple SDKs

One of a typical issue when developing a Symbian application, is to adapt it to several platforms. 字串3

Until last year, things were clear:
Developers targeting the Nokia devices had to use the Nokia Series 60 v1.x SDK and any Symbian enabled IDE since they finally all had their own version of the Nokia SDK (Visual Studio, Metrowerks Codewarrior and Borland C Builder).
Developers targeting the SonyEricsson device had no choice and must use the SonyEricsson/UIQ 2.0 SDK alongst with Metrowerks CodeWarrior. 字串4

Note: I am not mentionning alternatives like Linux based environment since they are (unfortunately) not mainstream environments for Symbian development.

With the arrival of Series 60 v2.0, Series 90 and UIQ 2.1 platforms, things are becoming a little bit more complex since the number of SDKs are increasing rapidly. Not to mention the Siemens SX1 SDK, Sendo SDK,... It now becomes quite common to have several SDKs installed on a single machine (as far as I am concerned, I commonly use Nokia Series 60 v1.2, Nokia Series 60 v2.0 and UIQ v2.1 SDKs).

字串3

Furthermore, users of Visual Studio and Borland C Builder do not have to move to Codewarrior to enjoy UIQ development anymore. So, a proper configuration of all these tools has become a necessity (and -until recently- a real pain).

字串1

As a matter of fact, not all the SDKs use the same method to configure themselves:
Symbian 6.1 based SDKs (all Series 60 v1.x SDKs) use the EPOCROOT environment variable
Symbian 7.0/7.0s SDKs (UIQ, Series 60 v2.0 and Series 90) rely on the new - and not so easy to use - device command. 字串9

The EnvironmentSwitch tool

Happily enough, Nokia delivers with its latest SDKs (NS60 v2.0 and NS90 v1.0beta) a small utility program called EnvironmentSwitch that is really useful to achieve succesful cohabitation of all SDKs (even non-Nokia ones). This tool is located by default in

or

Two files are required to run the tool [] :
environmentswitch.exe which is the tool executable 字串3
settings.xml which is the configuration file.

This settings.xml file is the key to configure your system properly. EnvironmentSwitch looks for it in the following places:
the full path (directory and filename) specified by a single command line argument, else
the full path (directory and filename) specified by the environment variable ENVSWITCHCONFIG, else
a file named settings.xml in the directory from which it is launched.

字串1

Once started, a small yellow icon will appear on your taskbar waiting for you to select your working SDK.

The EnvironmentSwitch configuration

The configuration file is in a simple attribute-based XML format. An example is shown at the bottom of this page.

The document root element type is settingsfile. It has no attributes.

字串8

All child elements of the root are of type environment. Each environment element is typically use to define a new SDK configuration. An environment element has the following attributes: 字串5

• name (mandatory) - the menu item caption
• icon (optional) - .ico file for the tray icon when this environment is selected - like old EPOCICON
• tooltip (optional) - tooltip text when this environment is selected - defaults to value of name

Child elements of an environment element are of type env or command.

The env element modifies an environment variable:

字串7

• key (mandatory) - the variable to modify
• value (optional) - the value
• action (optional) - how it modifies current value
  • " prepend "
  • " append "
  • " replace " (default) Note: use "replace" with no value to unset a variable.
• registry (optional) - if "yes", modify the current control set in the Registry to affect other processes (default is "no")

The environment variables (including the Registry) are restored this when environment is deselected (or EnvironmentSwitch terminates). 字串2

The command element specifies a command to execute: 字串6

• value - the command (mandatory)
• directory - (optional) working directory in which to invoke it - extends old PROJECTPATH
• binding - (optional) when to execute, defaults to "entry":
  • " entry " - run when this environment is selected
  • " exit " - run when this environment is deselected (or EnvironmentSwitch terminates)
  • " middlebutton " - run on middle mouse button click
  • " doubleclick " - run on left mouse button double click
  • " menu " - attach to the EnvironmentSwitch (right mouse button) menu
• outputwindow - (optional) if "yes", capture any command output (stdout & stderr) to an error message box - intended to support ’devices -setdefault’
• caption - (optional) menu item caption if binding is "menu", ignored otherwise. Default is to use the value attribute

Example Configuration File

Here is the settings.xml file I use:

[收藏] [推荐] [评论] [打印] [关闭]

0

顶一下

上一篇：How to define the memory configuration of the Symbian WINS emulator
下一篇：How to create a SIS file