======================================================================== RELEASE NOTE for SERIES 60 SDK 2.1 FOR SYMBIAN OS 03.06.2004 ======================================================================== Product Description: ==================== The Series 60 SDK for Symbian OS enables application development for devices based on Series 60 platform using C++. The SDK is based on Series 60 developer platform 2.1 and Symbian OS 7.0s. The SDK includes all key functionality needed for application development (documentation, API reference, add-on tools, emulator, target compiler) excluding IDE. This SDK supports Microsoft Visual Studio .net Professional 2003 Series 60 Platform is a complete smartphone reference design. It represents a rich environment for developers to create exciting content and innovative applications. The platform builds on the Symbian operating system Symbian OS, complementing it with a configurable graphical user interface library and a comprehensive suite of reference applications. A set of robust components and many varied APIs are provided for developers. The APIs supplied are used extensively by the suite of "standard" applications, but they have been designed to be re-used by independent software vendors as well. Features: ========= - Emulator for debugging applications - Building tools and environment for emulator (WINS udeb and WINS urel) - Target compiling environments for ARMI and THUMB (ARMI urel and THUMB urel) - Integrated Documentation. Combined Symbian and Series 60 platform documentation - Series 60 Tools including: + EnvironmentSwitch tool + MBMViewer for viewing Symbian multibitmap images - Example applications and Symbian sample code set - Example application documentation is embedded into main documentation set - Support for Microsoft Visual Studio .net professional 2003 or newer. - Support for Microsoft Visual Studio 6 - Support for Borland C++ BuilderX Enhancements: ============= - SDK now supports Java Runtime versions from version 1.3.1_01 onwards. - Ethernet Plug-in for Series 60 SDK is now integrated into SDK. - SMS API headers and libraries are now part of SDK. - Enhanced API Reference Guide usability. New Features: ============= - Support for Microsoft Visual Studio .net professional IDE. See SDK documentation for detailed instructions. - Support for Borland C++ BuilderX - Support for Series 60 2.1 APIs: + Presence Open API + Bluetooth Notifier API - Ethernet support for Series 60 C++ SDK 2.1 enables your emulator to access your Ethernet cards enabling that your applications can access IP networks via the configured Ethernet card. This is a very useful feature if your application needs access to the Internet and you want to test connectivity in your application using the emulator. - Ethernet support can be used with 'Email' and 'Services' applications from emulator applications. Select 'ETHERNET' as access point for eMail. - Ethernet support using Nokia D211 WLAN card does not work with DHCP. Instead you can use fixed IP/DNS addresses. - The configuration tool accessible through the Start menu can be used only if Java is installed in the PC. - Reintroduced APIs (after Series SDK 2.1 Beta release): - plpvar.h, plpvariant.h, plpvariant.lib (access to device IMEI) and sysagt.lib (e.g. catching incoming calls). - Full set of SMS API headers and libraries included in the SDK: emsinformationelement.h ,emsinformationelement.inl, gsmubuf.h, gsmuelem.h, gsmuelem.inl, gsmuetel.h, gsmuetel.inl, gsmumsg.h, gsmumsg.inl, gsmupdu.h, gsmupdu.inl, gsmu.lib, smuthdr.h, smuthdr.inl, smutset.h, smutset.inl and etelmm.h. - Removed APIs: - AMR-NB Codec API: amrcodec.h - Misc SDK headers: netconerror.h - Connectivity Framework (Mrouter) Undocumented: connectionstatus.h, connmngmntbox.h, customserver.h, customserver.inl, customservershared.h, mrouteragent.h, mrouterclient.h, mrouterclientdefs.h, mrouterinstallerdefs.h, mroutersocket.h, mstreamlegacy.h, mstreamman.h, mstreamman_typecore.h, mtextutils.h, rtsock.h, scrfs.h, sczlib.h, sczlibengn.h, tcplistener.h, ws2bth.h, bluetoothapis.h, bthdef.h, bthsdpdef.h - Connection Link PLP (Pre-mRouter) Undocumented: plpbakms.h, plpcrac.h, plpcust.h, plplink.h, plplog.h, plprfile.h, plprfile.inl, plprpc.h, plprpc.inl, plpsess.h, plpsess.inl, plpsize.h, plpsock.h, plpsock.inl, plpsvr.h, plpsvr.inl, plpsvrmsg.h, plpver.h, brdcst.h - EC Custom Servers (PC connectivity server framework) Undocumented: backuppro_codes.h, capsvr.h, gencs.h, gencsif.h, eccesvrcmd.h, eccmapps.h, emsyncc.h, ecbroadcastdef.h, rfile.h, rfile.inl, saidmap.h, sasync.h, agnapii.h, agndasvr.h - SDK SMS Utilities: smsustrm.h, smsustrm.inl, smsulog.h, smsulog.inl, smsuact.h - WAP SMS Protocol Module: es_wsms.h, es_wsms.inl See API reference for detailed API information. System Requirements: ==================== Basic Requirements: - Microsoft Windows 2000 SP3 or Microsoft Windows XP SP1 - IDE: Microsoft Visual studio .net professional 2003 or IDE: Microsoft Visual Studio 6 or IDE: Borland C++ BuilderX - Minimum 1 GHz Pentium PC, 256 MB of memory - 450 MB free disk space, other requirements as required by the IDE used Additional Requirements: - Installation/uninstallation of the SDK requires local admin rights - Java2 Runtime Environment v.1.3.1 or newer for Symbian development tools: AIF Builder, CS Help Compiler, Sisar and for Ethernet Support Configuration UI - Active Perl 561 or newer for SDK build tools NB: It is strongly recommended that you install Perl and Java Runtime Environment before installing the SDK - EnvironmentSwitch tool requires Microsoft XML Core Services (MSXML) to work. Preferred version is 4.0 - When developing bluetooth applications, a fast (recommended >2GHz, 512 MB of memory) desktop machine is required. Supported bluetooth card protocols are BCSP and H4. Compatibility Issues: ===================== Co-existence with earlier Symbian OS SDKs ----------------------------------------- - See SDK documentation for "How to manage development for multiple device types" in Symbian Developer Library » Tools and Utilities » Kit management » How to manage development for multiple device types - It is recommended that the applications made by Series 60 SDK 2.1 Beta for Symbian OS are rebuilt using this version Known Problems: =============== Installation/Uninstallation --------------------------- - Please remove manually the installation directory after uninstalling this SDK. Some files and directories are created while the emulator is run for the first time. Those files and other files that are created after installation will remain on the disk. Build Tools ----------- - Compilation for emulator with Borland C++ BuilderX requires additional compiler: Microsoft Visual Studio 6 or Microsoft Visual studio .net professional 2003 - Epoc, bldmake, eshell and makmake do not work when executed on other drive than where the SDK is installed. - Makekeys.exe functions correctly only when started in epoc32\tools directory. - AIF Builder does not work in all environments. It is recommended to use command line tool aiftool instead (see SDK documentation for "How to build an aif file" in Symbian Developer Library » Tools and Utilities » Application resource tools guide » How to build an aif file. Emulator -------- - Only the following content formats are supported in emulator: wbmp, gif, jpg, bmp, tiff, mbm, png, wmf, au, awb, amr, wav. For instance, following formats are not supported: 3gp, rm. - The functionality of the emulator is faithful to the functionality of the Series 60 2.1 handset, although not all applications work identically. For example, telephony functionality is not fully supported in emulator. Therefore some applications are not fully functional in emulator. - Window server short cut keys Ctrl + Alt + Shift + E / D / W / H don't work in emulator. - Function keys "Alt + F2" and "F8 " do not work in emulator. Bluetooth --------- - In some configurations there are problems in using certain physical COM-ports for Bluetooth adapter. Workaround: Try different COM-port for the adapter. Series 60 Examples ------------------ - Bmpmanip example demonstates usage of the deprecated API (Image Converter API). The Image Converter API has been replaced by the Image Converter Library in Symbian OS 7.0s. - At the moment example applications Fetching and Notification for Presence API demonstrate only abstract API usage and do not fully implement error situation handling. Symbian Examples ---------------- - Some of the Symbian Examples won’t compile. However, the examples give good coding idioms and are thus not removed from SDK. - Symbian examples are not visible in emulator. To run these examples after building, go to directory \epoc32\release\wins\udeb and double-click the generated exe-file. Copyright © 2001-2004 Nokia Corporation. All rights reserved. Nokia and Nokia Connecting People are registered trademarks of Nokia Corporation.