=============================================================================== Nokia 7710 SDK for Symbian OS 20.1.2005 Supporting Microsoft Visual Studio .NET 2003 C++ and Borland C++BuilderX Mobile Edition, Simplified Chinese Version =============================================================================== Product Description: ==================== Designed for high-end mobile devices with high-resolution, touch-sensitive color screens, Nokia 7710 is a complete and feature-rich device providing an excellent environment for media consumption, mobile services and a true Internet experience. Nokia 7710 SDK for Symbian OS enables C++ application development for Nokia 7710 device. This SDK is based on Symbian OS v7.0s. The SDK includes all key functionality needed for application development (documentation, API reference, add-on tools, emulator, target compiler) except for an integrated development environment (IDE). This SDK supports Microsoft Visual Studio 6.0, Microsoft Visual Studio .NET 2003 and Borland C++ BuilderX. Features: ========= - Emulator for debugging applications - Building tools and environment for emulator (wins udeb) - Target compiling environments for ARMI and THUMB (armi and thumb) - Integrated Documentation. Combined Symbian and Nokia 7710 SDK documentation - Nokia 7710 tools including: + Environmentswitch tool + MBMViewer for viewing Symbian multibitmap images + Application Wizard - Examples for introducing Nokia 7710 UI styles and features coding - Code examples and Symbian sample code set - Code example documentation is embedded into main documentation set - Support for Symbian OS 7.0s - Support for Microsoft Visual Studio 6.0 - Support for Microsoft Visual Studio .NET 2003 Professional - Support for Borland C++ BuilderX 1.5. - Ethernet support - Lunar calendar - Chinese input engine Enhancements: ============= New Features ============ - Improved API documentation structure and a new API quick reference for Nokia 7710 - New Documents: - Deprecated APIs + Etel Core APIs will be removed in future. - Support for Nokia Connectivity Framework: SMS sending and receiving System Requirements: ==================== Minimal Configuration: - Operating systems: Windows (Tested with: Windows 2000 with SP3, XP with SP1a) - 800 MHz or faster processor - 256 MB of RAM - 500 MB free disk space, other requirements as required by the IDE used - Compiler: Microsoft Visual Studio 6.0 or Microsoft Visual Studio .NET 2003 Professional or Borland C++ BuilderX 1.5 and Microsoft Visual Studio Additional Requirements: - Installation/uninstallation of the SDK requires local admin rights. - Active Perl 5.6.1 build 531 for SDK build tools. Newer or or older Perl versions may not be fully compatible with Symbian build tool chain. Perl must be installed before using the SDK to build applications. - Use of Emulator menubar and Application Wizard require a Java runtime to be installed. Java Runtime version 1.4.1_02 or later is required. - EnvironmentSwitch tool requires Microsoft XML Core Services (MSXML) to work. Preferred version is 4.0 or later. - When developing bluetooth applications, a fast (recommended >2GHz, 512 MB of memory) desktop machine is required. Supported bluetooth card protocols are BCSP and H4. - SDK Installation path should not contain spaces or other special characters. - SDK installation should reside in same drive than: + Microsoft Visual Studio 6.0 or Microsoft Visual Studio .NET 2003 Professional or Borland C++ BuilderX 1.5 and Microsoft Visual Studio IDE and + Developer's project and source files Compatibility Issues: ===================== Unsupported or deprecated SDK functionality ------------------------------------------- - Sisar, AIF Builder and CS Help Compiler UI tools may or may not work properly with this release of the Series 90 SDK. These applications will be removed from SDK in future. It is recommended to use corresponding command line tools: + makesis + epocaif.pl (and aiftool.bat) + cshlpcmp Co-existence with SDKs based on Symbian OS versions 6.0 and 6.1 --------------------------------------------------------------- - The Devices command is the recommended way to change between SDK build toolchains. SDKs based on Symbian releases 6.1 or earlier require use of "Environmentswitch" tool. See documentation for Environmentswitch for more information. Third Party PC applications --------------------------- - When using ZoneAlarm firewall ethernet connection for Nokia 7710 emulator is not functional unless security level is set to "Medium". Known Problems: =============== Emulator -------- - Window server short cut keys Ctrl + Alt + Shift + E / D / W / H / T do not work in emulator. - Quick Task switching (Ctrl + Alt + Shift + T) does not work - Function keys "Alt + F2" and "F8 " do not work in the emulator. - Camera Application hangs when Video mode is started. Workaround: Go to images application and use command button "Go to Camera". Camera is reset to still mode. Video mode is not supported in emulator. - Messaging application: + MMS is not supported. + SMS is supported through Nokia Connectivity Framework See documentation for Nokia Connectivity Framework for more details. + E-Mail: not fully supported. - File Manager: rename memory card function renames C:\ volume on PC. - Bluetooth: problems when sending large files across BT link with NCF. Connectivity ------------ - In some environments Ethernet Support fails to initialize correctly. Workaround: Start npacket service manually. Detailed steps are: -- Assumption: ethernet support is configured using configuration UI -- in Emulator -> Tools -> Preferences -> Ethernet Settings 1. Start emulator 2. Start Browser (or another application using TCP/IP) 3. Start application called npacketadmin.exe from \\Epoc32\tools 4. From npacketadmin UI select the network adapter you are using for TCP/IP connectivity. 5. Check the status. Correct state should be "STARTED", when emulator is running. 6. If status is "STOPPED", close the emulator. 7. After emulator has been shut down. Select "Start" button. 8. When status has changed to "STARTED", restart emulator. 9. Test that browser functions normally. 10.Control Panel - Internet Setup application in emulator resets TCP/IP settings and will break Ethernet support function. Application should not be used, instead use Emulator menubar Preferences to setup TCP/IP connection settings for emulator. Installation - Uninstallation ----------------------------- - Installing/uninstalling Symbian SDKs requires local admin rights. - 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. Nokia 7710 Example Applications ------------------------------ - ChipFlip: When using the SIP Server Emulator as the SIP Server, it must be configured to not use IPv6 in order to game registration to succeed. - Dialer: In target device, the Telephone application may be automatically launched when the Dialer application is exited. - EmbeddableObject: Inserting existing objects is not implemented. - Form: Added form components are not refreshed properly on screen. - HttpClient: Application does not launch in target device. In emulator, opening a page in browser may fail if the Browser application has not been launched previously. - LandmarksReference: The Categories list is empty in the target device. - MoreAnimation: This is the example application mentioned in the Animation API documentation. The other animation example demonstrates a different use case. - TelephoneNumber: Number formatting turns some number characters into rectangles. - ResourceUtilities: Font loading may fail in target device. - Skin: Skin toggling may fail in target device. - samplecode/messaging/textmtm sample is excluded from the SDK package. - PasswordDialog: "Ckn Change N" options used for changing passwords with the CCknChangePasswordDialog class don't close the dialog window with the "Ok" button if the entered passwords match and are 6 characters long or more. - Audio streaming example application delivered within SDK is not correct. The application is broken and a corrected version will be delivered later on. Misuse of audio streaming API can cause audio system halt without notification to user, please use the audio playing API that are introduced with the Sound Example application. Symbian Example Applications ---------------------------- - Some Symbian examples have dependencies to legacy headers and will not compile with Series 90 SDK. Note: ------- If yor are implementing an application that uses desktop, a missing library must be copied to the SDK installation. This package is in the root of the installtion package. Instructions: Unzip AddToDesk.zip to Nokia 7710 SDK Epoc32 folder. AddToDesk.lib file is added to armi, thumb and winscw folders. ------------------------------------------------------------------------------- Copyright 2003-2005 Nokia Corporation. All rights reserved. Nokia and Nokia Connecting People are registered trademarks of Nokia Corporation.