Release Notes and Known Issues

• Introduction
• Platform requirements
• Download and installation
• Known issues and troubleshooting
• API Support
• More information
• Documentation updates
• Files - Added and removed

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

We have successfully tested this SDK on Windows XP and Windows 2000. The SDK can be used with carbide.c++ v1.1 and v1.2, CodeWarrior 3.0 and 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 http://developer.uiq.com/.

The SDK can be downloaded at http://developer.uiq.com/.

Run UIQ3.1.exe to install the SDK.
Required disk space is approximately 800 MB.
We recommend you to select an empty or non-existing directory as install location.

There are four 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.
• Java Developer:   Files and tools needed to compile and debug J2ME applications on target and emulator using an IDE.
• Documentation:    UIQ 3.1 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.

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.

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 to reasons outside of UIQ's control.

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

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

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

If you anyway install the SDK to a second location you will need to update devices.xml file manually with location information. The uninstaller will not be aware of the second SDK which will cause you trouble when it is time to uninstall the SDK(s).

JRE 1.3.1 is needed by some of the Symbian tools. The installer is located in the /epoc32/tools/distrib folder and it is called j2re-1_3_1_01-win-i.exe.

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

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.1 SDK » Symbian OS v9.2 » Symbian OS guide » Platform security » Capability report v9.2.

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

The -d option does not work for language dependent files, check for updates of this issue on http://developer.uiq.com/.

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

For more information, visit the UIQ Developer Community Web Portal at http://developer.uiq.com/.

Updates in the UIQ Developer Library:

• Updated Style Guide
• Updated Programmers Guide
• New SVG Guide
• Updated Deprecated Members List

Several header files have been added to this SDK and a few have been removed.

The following header files have been added this SDK:

epoc32\include\bluetooth\pbap\pbaprequest.h
epoc32\include\connect\swishareddefs.h
epoc32\include\edg\edg3_7_rvct2_2.h
epoc32\include\libc\netinet\net_types.h
epoc32\include\networking\qos3gpp_subconparams.h
epoc32\include\networking\sip_subconevents.h
epoc32\include\networking\sip_subconparams.h
epoc32\include\xml\matchdata.h
epoc32\include\_sdpdefs.h
epoc32\include\agncontent.h
epoc32\include\calcontent.h
epoc32\include\coecoloruse.h
epoc32\include\exifutility.h
epoc32\include\featureUIDs.h
epoc32\include\gsmuieoperations.h
epoc32\include\gsmunonieoperations.h
epoc32\include\imageframeconst.h
epoc32\include\Lbs.h
epoc32\include\LbsClassTypes.h
epoc32\include\LbsCommon.h
epoc32\include\LbsCriteria.h
epoc32\include\LbsErrors.h
epoc32\include\LbsIpc.h
epoc32\include\lbsmessageenums.h
epoc32\include\LbsPosition.h
epoc32\include\LbsPositionInfo.h
epoc32\include\LbsRequestor.h
epoc32\include\LbsSatellite.h
epoc32\include\obexbttransportinfo.h
epoc32\include\obexfinalpacketobserver.h
epoc32\include\obexirtransportinfo.h
epoc32\include\obexpanics.h
epoc32\include\obextransportinfo.h
epoc32\include\obexusbtransportinfo.h
epoc32\include\QikSaveChangesDlg2.h
epoc32\include\SdpAttributeField.h
epoc32\include\SdpBandwidthField.h
epoc32\include\SdpCodecStringPool.h
epoc32\include\SdpConnectionField.h
epoc32\include\SdpDocument.h
epoc32\include\SdpFmtAttributeField.h
epoc32\include\SdpKeyField.h
epoc32\include\SdpMediaField.h
epoc32\include\SdpOriginField.h
epoc32\include\SdpRepeatField.h
epoc32\include\SdpRtpmapValue.h
epoc32\include\SdpTimeField.h
epoc32\include\SdpTypedTime.h
epoc32\include\sip.h
epoc32\include\sipacceptcontactheader.h
epoc32\include\sipacceptencodingheader.h
epoc32\include\sipacceptheader.h
epoc32\include\sipacceptlanguageheader.h
epoc32\include\sipaddress.h
epoc32\include\sipaddressheaderbase.h
epoc32\include\sipalloweventsheader.h
epoc32\include\sipallowheader.h
epoc32\include\sipcallidheader.h
epoc32\include\sipclienttransaction.h
epoc32\include\sipconcreteprofileobserver.h
epoc32\include\sipconnection.h
epoc32\include\sipconnectionobserver.h
epoc32\include\sipconnpref.h
epoc32\include\sipcontactheader.h
epoc32\include\sipcontentdispositionheader.h
epoc32\include\sipcontentencodingheader.h
epoc32\include\sipcontenttypeheader.h
epoc32\include\sipcseqheader.h
epoc32\include\sipdialog.h
epoc32\include\sipdialogassocbase.h
epoc32\include\siperr.h
epoc32\include\sipeventheader.h
epoc32\include\sipexpiresheader.h
epoc32\include\sipextensionheader.h
epoc32\include\sipfromheader.h
epoc32\include\sipfromtoheaderbase.h
epoc32\include\sipheaderbase.h
epoc32\include\siphttpdigest.h
epoc32\include\siphttpdigestchallengeobserver.h
epoc32\include\sipinvitedialogassoc.h
epoc32\include\sipmessageelements.h
epoc32\include\sipnotifydialogassoc.h
epoc32\include\sipobserver.h
epoc32\include\sipparameterheaderbase.h
epoc32\include\sippassociateduriheader.h
epoc32\include\sipprofile.h
epoc32\include\sipprofileregistry.h
epoc32\include\sipprofileregistrybase.h
epoc32\include\sipprofileregistryobserver.h
epoc32\include\sipprofiletypeinfo.h
epoc32\include\sipproxyrequireheader.h
epoc32\include\siprackheader.h
epoc32\include\sipreferdialogassoc.h
epoc32\include\siprefertoheader.h
epoc32\include\siprefresh.h
epoc32\include\sipregistrationbinding.h
epoc32\include\sipregistrationcontext.h
epoc32\include\sipreplytoheader.h
epoc32\include\siprequestelements.h
epoc32\include\siprequireheader.h
epoc32\include\sipresolvedclient.h
epoc32\include\sipresponseelements.h
epoc32\include\sipretryafterheader.h
epoc32\include\siprouteheader.h
epoc32\include\siprouteheaderbase.h
epoc32\include\siprseqheader.h
epoc32\include\sipsecurityclientheader.h
epoc32\include\sipsecurityheaderbase.h
epoc32\include\sipservertransaction.h
epoc32\include\sipstrings.h
epoc32\include\sipsubscribedialogassoc.h
epoc32\include\sipsubscriptionstateheader.h
epoc32\include\sipsupportedheader.h
epoc32\include\siptimestampheader.h
epoc32\include\siptoheader.h
epoc32\include\siptokenheaderbase.h
epoc32\include\siptransactionbase.h
epoc32\include\sipunsignedintheaderbase.h
epoc32\include\sipunsupportedheader.h
epoc32\include\ssl_compatibility.h
epoc32\include\syncmlclientds.h
epoc32\include\syncmldatafilter.h
epoc32\include\sysstartdefs.h
epoc32\include\w32stdgraphic.h
epoc32\include\wap_sock.h

The following header files have been removed from this SDK:

epoc32\include\http\framework\SecurityPolicyPluginStrings.h
epoc32\include\syncml\DmGenericAdapterStringConstants.h
epoc32\include\syncml\SmlWProvStringConstants.h
epoc32\include\WmlLib.h