UIQ 3.3 Beta SDK - release notes


27 March 2008

CONTENTS

Introduction

This SDK is based on UIQ 3.3 and Symbian OS v9.3. It provides you with the code and information you need to develop applications for the phones running UIQ 3.3.

Platform requirements

We have successfully tested this SDK on Windows XP and Windows 2000.

The UIQ 3.3 beta SDK doesn't officially support Windows Vista, but it has been successfully tested on this operating system.

The SDK can be used with Carbide.c++ v1.3, CodeWarrior 3.1. It can also be used with Visual Studio .NET 2003.

There is also a plug-in to Visual Studio called Carbide.vs and a UIQ support package to this available at Tools page.

What's New

» Added new default theme, the old default theme is available in themes.

» New Opera Browser Version 9, which support Widgets. The new version of Opera 9 also includes an administration application for Widgets called Widget Manager.

» UIQ Dashboard, it is a UIQ application that enables easy display of Widgets.

» Changes in UI Configuration

  • Command Mapping for Softkey style and Softkey style Touch
  • Key Configuration
  • Reference Configuration

For more information about each topic and much more, see What's new in UIQ 3.3 SDK documentation.

Download and Installation

» Download

The SDK can be downloaded at the SDK Download page.

» Install

Space required on your disk is approximately 1.1 GB.

Run UIQ3.3SDK_beta.exe to install the SDK.

We recommend you to select an empty or non-existing directory as install location.

There are three different components to install:

  • Emulator:             Files and tools needed to run the emulator.
  • C++ Developer:  Files and tools needed to compile and debug C++ applications on target and emulator using an IDE.
  • Documentation:    UIQ 3.3 Beta SDK Documentation.

All sub-components you select will be installed at the end of the SDK installation. The Ethernet settings will be preconfigured to use DHCP.

» Uninstall

Make sure to move all files you wish to save from the following directories before uninstalling the SDK:

  • \Documentation
  • \epoc32
  • \Examples
  • \Extensions

All contents in the above directories may be deleted by the uninstaller.

Also make sure to uninstall all extension packages before uninstalling the SDK.

Known issues and troubleshooting

» Compiler

If you selected to install the GCC-E compiler while installing the SDK, the path variable has to be updated manually since the GCC-E installation does not do that for you.

Building for GCC-E target is not possible in Codewarrior 3.0 due reasons beyond UIQ's control.

Warning appears when the file epoc32/INCLUDE/bitmap.h is included and compiled with the GCC-E compiler: warning: enumeral mismatch in conditional expression: `TTrue' vs `TFalse'

Warning appears when the file epoc32/INCLUDE/msvstd.inl: is included and compiled with the GCC-E compiler: warning: enumeral mismatch in conditional expression: `' vs `TMsvEntry::<anonymous enum>'

» Emulator

The built-in UIQ applications are only verified in the reference phone style which is the Softkey style and Softkey style Thouch.

If you have installed the SDK on a Windows XP machine as admin, the SDK emulator will not run for unprivileged users.

There are issues with the window server not redrawing parts of the screen, this mainly affects scrollable containers. A manual redraw can be forced by pressing CTRL-ALT-SHIFT + R

The emntest application will be removed in later releases.

» Installer

If you want to update your UIQ 3.3 installation, e.g. by adding/removing components, we recommend that you save your work to a location other than the SDK area and then overwrite your existing installation rather than using a new location.

If you would like to install your UIQ 3.3 in a different location than the default, do not use a "." when stating the folder name to where it should be installed.

» Paths

In rare cases installing the SDK causes a loss of paths. To help you restore your paths check <installdir>\path.log.

» Platform Security

All required platform security capabilities are not yet documented in the API reference. When an API call returns with the error KErrPermissionDenied this can indicate that the application is running with insufficient capabilities and trying to access a restricted API. See the enum TCapability in the developer library (or e32capability.h) for a complete list of capabilities. Also, an API list with required capabilities can be found in the Developer library under: UIQ 3.3 SDK Beta » Symbian OS v9.3  » Symbian OS guide » Platform Security <class="separator">» Symbian OS v9 Security Architecture.

Platform Security related errors can be found in the emulator log file epocwind.out in the windows temp directory.

» MegabytesOfFreeMemory

The parameter MegabytesOfFreeMemory in the epoc.ini files has been changedfrom 16 to 32. This due to the web browser is a pre-release and is not stable in only 16 MB.

API Support

Note that only APIs in » UIQ 3.3 SDK Beta » UIQ API reference and in » UIQ 3.3 SDK Beta » Symbian OS v9.3 » Symbian OS reference are supported for 3rd party usage.

More Information

For more information, visit the UIQ Developer Community Web Portal.

Documentation updates since the UIQ 3.1 SDK

» Programmer's Guide

The Programmer's Guide has been removed and all previous information has been added into the various How-to's. For further information on controls and other miscellaneous areas, see the How-to guides.

» Style Guide

The Style Guide has been updated with new themed images. The Style guide has also been updated accordingly, with the major changes made defining the two default reference configurations Softkey style and Softkey style Touch.

Help

UIQ 3 SDK documentation