UIQ 3.1 SDK - release notes
21 June 2007
CONTENTS
- Introduction
- Platform requirements
- Download and installation
- Known issues and troubleshooting
- API Support
- Documentation updates
- Files - added and removed
Introduction
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.
For information about the new features in UIQ 3.1, see "What's new in 3.1" in the UIQ Developer Library.
Platform requirements
We have successfully tested this Beta SDK on Windows XP. Some limited testing was also done on 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 on the Tools page.
Download and Installation
» Download
The SDK can be downloaded at SDK Download page.
» Install
Space required on your disk is 800 MB.
Run UIQ3.1SDK.exe to install the SDK.
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.
» 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 to reasons outside of UIQ's control.
» Emulator
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
» Installer
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).
» Java
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.
» 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.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.
» Makesis.exe
The -d option does not work for language dependent files, check for updates of this issue on Tools page.
API Support
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.
Documentation updates
Updates in the UIQ Developer Library:
Files added and removed
Several header files have been added to this SDK and a few have been removed.
» Files added
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
» Files removed
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