release_notes.txt

塞班3D游戏

S60 3rd Edition: Calendar Interim API Example
-------------------------------------------------

This C++ application demonstrates the usage of the new Calendar Interim API (also known as the CalInterim API), 
by adding and modifying anniversary entries. The Calendar Interim API replaced the Agenda Model API in Symbian 
OS v9.1 (S60 3rd Edition).

Note that a separate example on the usage of the Agenda Model for S60 1st and 2nd Edition 
(S60 1st/2nd Edition: Agenda Model API Example) is also available at www.forum.nokia.com.

--------------------------------------------------------------------------------

PREREQUISITES

Symbian C++ basics

--------------------------------------------------------------------------------

IMPORTANT FILES/CLASSES

CCalendarAPIexampleEngine class contains the logic of the application for 
creating, modifying, and deleting calendar entries (in this case, anniversaries).

Important Symbian OS classes: CCalEntry, CCalEntryView, CCalInstance, CCalInstanceView, CCalAlarm, CCalSession, 
MCalProgressCallBack.


--------------------------------------------------------------------------------

KNOWN ISSUES

Alarms do not work properly in the emulator.
    
--------------------------------------------------------------------------------

RUNNING THE EXAMPLE

When the application is started, choose the time for which you want to search
anniversaries. If you wish to add an anniversary, choose it from the Options menu.

When adding an alarm, it must be after the current time 
(check your emulator date/time settings) and
before the actual anniversary (during the same day or before).

When changing the date of the anniversary, the alarm offset will not be recalculated 
so the time between the alarm and the anniversary remains the same.

--------------------------------------------------------------------------------

BUILD & INSTALLATION INSTRUCTIONS

Steps for building and installing the application to a device depend on the S60 platform version:

--Mobile device (S60 3rd Edition)
    cd to /CalendarExample/group
    bldmake bldfiles
    abld build gcce urel
    cd to /CalendarExample/sis
    Edit CalendarExample_v30.pkg's paths to match those on your system.
    makesis CalendarExample_v30.pkg
    
    Sign the SIS package 
      - See the SDK Help for information about self-signed .sis packages, or
        www.symbiansigned.com for information about Developer Certificates.

    Install the signed .sis file to an S60 3rd Edition device.

    If you get a "Certificate error" during installation of a self-signed 
    package, check that App.Manager -> Settings -> Software Installation is 
    set to "All". 
    
--Emulator (WINSCW)
    cd to /CalendarExample/group
    bldmake bldfiles
    abld build winscw udeb
    Start the emulator.
    
--------------------------------------------------------------------------------

COMPATIBILITY

S60 3rd Edition

TESTED WITH Nokia E60, E61, and N91.

Created / tested with S60 3rd Edition SDK

--------------------------------------------------------------------------------

IMPROVEMENT IDEAS

The example抯 flow of execution may be a bit hard to follow. It would be a good idea
to fully split the engine from the GUI codes. Also to better demonstrate the Calendar Interim API,
the helper class (CCalHelperEntry) should be removed and the CCalEntry and
CCalInstance classes should be used directly.

--------------------------------------------------------------------------------

VERSION HISTORY		

1.0	First release. The functionality of the S60 1st/2nd Edition: Calendar API Example published 
earlier is recoded to S60 3rd Edition using the Calendar Interim API.

--------------------------------------------------------------------------------
ADDITIONAL DOCUMENTATION

Further information on the usage of Calendar Interim API is provided in the document Migration Guide for 
Symbian OS v9.1 Group Scheduling Interim APIs. It is available in the S60 3rd Edition MR SDK 
(...\S60Doc\symbianos_interim_api_migration.pdf).

--------------------------------------------------------------------------------
EVALUATE THIS RESOURCE

Please spare a moment to help us improve documentation quality and recognize the examples you find most valuable, 
by rating this resource at 
http://www.forum.nokia.com/main/1%2C%2C90%2C00.html?surveyId= d9a8c007-77ef-4190-8216-ff9577610ad0/S60_3rd_Edition_Calendar_Interim_API_Example_v1_0_en.zip