===================================================================== RELEASE NOTE FOR NOKIA N97 SDK v1.0 16.07.2009 ===================================================================== The Nokia N97 SDK (for Symbian OS) is a device specific SDK, intended for application development for the Nokia N97 mobile computer. However, this SDK is fully compatible with the S60 5th Edition SDK v1.0, except for some features (refer to the What's new section below) that are specific to the Nokia N97 device. What's new in the Nokia N97 SDK ------------------------------- - Home screen widget ‘mini-view’ support in emulator home screen. - QWERTY and rocker key support. - Three new C++ APIs: - Homescreen Publishing API. - OOM Client API. - Sensor Data Compensator API. - Support for JRT 1.4, which includes: - Mobile Sensor API (JSR-256) 1.2 (New). - Nokia UI API 1.3 (Updated). - New C++ example applications: - HsPWidget (/S60CPPExamples/HsPWidget). - OomExample(/S60CPPExamples/OomExample). - New Widget example application: - Stew (/S60WidgetExamples/stew). Supported IDEs for C++ ---------------------- - Carbide.C++ v2.0 Supported IDEs for Java development ----------------------------------- - NetBeans IDE 6.0, 6.1, and 6.5 - Eclipse 3.3.1 with EclipseME 1.7.7 and MTJ Steps for MIDlet debugging on Eclipse: Go to Windows > Preference > Java > Debug tab Deselect all checkbox Debug timeout: 200000 Launch timeout: 200000 For EclipseME: Go to Windows > Preference > J2ME Debug Server Time-out(ms): 70000 For MTJ: Go to Windows > Preference > Java ME Debug Server Time-out(ms): 70000 Note: These configurations are guidelines. Users can change these configurations based on their requirement and machine performance. System requirements ------------------- Basic requirements - Microsoft Windows XP (Service Pack 2). - Minimum 1 GHz Pentium PC with 1024 MB of memory. - At least 2 GB free disk space. - This SDK requires administrator rights on the installation PC. - Additional disk, processor, and other requirements for any IDE used. Additional software - Active Perl 5.6.1 build 635 for SDK build tools. Unofficial support for newer versions of Active Perl can be enabled by following the guidelines from: KIS001302 - Compiling context-sensitive help fails with latest version of Perl (http://tinyurl.com/NewPerlForS60). Perl must be installed before using the SDK to build applications. - Java Runtime version 1.6.0_xx Compilers --------- - For emulator builds (WINSCW platform) the Nokia C++ Compiler is required. This compiler is delivered with Carbide.c++. - For device builds there are two build platforms supported: - GCCE for Symbian is a free compiler provided with the SDK and can be used to build applications using the GCCE platform. - ARM RVCT compiler 2.2 build 593 or newer is supported. This is a commercial complier for the ARMV5 platform, developers will need to acquire this compiler separately. Known issues and deficiencies in this release --------------------------------------------- - The emulator’s web browser cannot be opened when a widget is running on the home screen. - Some strings appear in English when emulator language is changed to Chinese. - Local HTML files cannot be opened in the emulator using the File > Open option on the emulator menu. - The MIDP Security feature is not working in the emulator. - This SDK contains a new version of the mifconv.exe tool, namely version 3.0.1. This version implements strict parameter processing and some legacy extension (*.mk) scripts may fail. For example, if the tool is called with the /h parameter and the parameter is not followed by a *.mbg header file name, conversion will not be undertaken. - The *.pkg files for the example S60 applications in the SDK have not been updated with the S60 5th Edition UID. As a result these example applications will display the message "Application not compatible with phone, continue anyway?" when installed on S60 5th Edition devices. - The Media Fetch API no longer supports a number of Media Types. Media Fetch API enumerations: - ENoMediaFile - ERAMFile - EPlaylistFile - EGMSFile - EPresentationsFile - EAnyMediaFile are not supported and the method MGFetch::RunL will leave with KErrNotSupported when those values are used. - The documentation for the HSPWidget example differs from the implementation. Documentation code snippets contain errors that have been fixed in the example application code. - Using the right hand softkey Exit function in the Music Widget throws an error "System error -1". This has no functional impact. S60 API Issues -------------- - RestoreHeaderL and SetHintType methods in the class CContactItemField of the header Cntfield.h are not implemented in the SDK. - The CParserPropertyValueAlarm() method in CParserPropertyValueAlarm class of header vcal.h is not implemented in the SDK. - The DataTypes method in the class TApaAppServiceInfo of the header apaid.h is not implemented in the SDK. - CCameraAdvancedSettings in ecam.h is not implemented in the SDK. - Implementations for some of the methods from following headers are missing. cntfilt.h,cntfield.h,cntviewbase.h,vcal.h,apaid.h, ct/ccttokentypeinfo.h,ct/ccttokentype.h,cfstokentypeclient.h, pkixcertchain.h, pkixvalidationresult.h,asn1dec.h, ct/tctfindtokentypesbyinterfaceandattribute.h, and ct/tctfindtokentypesbyinterface.h. Installation and removal issues ------------------------------- - Uninstalling earlier SDKs while the Nokia N97 SDK is present will cause an error note at the end of the uninstall process. In this case the active SDK needs to be set manually using the 'devices' utility from the command prompt. Compliant JSRs -------------- - PDA Optional Packages for the J2ME Platform (JSR-75). - Mobile Information Device Profile 2.0 (JSR-118) - Mobile Information Device Profile 2.1 (JSR-118) - Wireless Messaging API (JSR-120). - Mobile Media API (JSR-135). - Connected Limited Device Configuration 1.1 (JSR-139) - J2ME Web Services Specification (JSR-172). - Security and Trust Services API for J2ME (JSR-177) – SATSA package. - Location API for J2ME (JSR-179). - Mobile 3D Graphics API for J2ME (JSR-184). - Wireless Messaging API 2.0 (JSR-205) - Scalable 2D Vector Graphics API for J2ME (JSR-226). - Advanced Multimedia Supplements (JSR-234). - Mobile Service Architecture (JSR-248). - Nokia UI. Supported JSRs -------------- - Mobile Sensor API (JSR-256). Copyright (c) 2009 Nokia Corporation. All rights reserved. Nokia and Nokia Connecting People are registered trademarks of Nokia Corporation.