
=====================================================================
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 (<SDK_Installation_Dir>/S60CPPExamples/HsPWidget).
  - OomExample(<SDK_Installation_Dir>/S60CPPExamples/OomExample).
- New Widget example application:
  - Stew (<SDK_Installation_Dir>/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 emulators 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.
