releasenotes.txt

Log Engine的使用

S60 Platform: Log Example
-------------------------

This C++ application demonstrates the usage of the Log Engine API provided by 
Symbian. The API is used to record events of interest to the user, of which 
they may not be immediately aware, or which are of high importance since costs 
are incurred, such as telephone calls. These events can be retrieved by a viewer 
application and displayed to the user. 

The Log Engine API is supported from S60 2nd Edition onwards.

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

PREREQUISITES

Symbian OS key concepts

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

IMPORTANT FILES/CLASSES

CLogExEngine:
- This class is used for retrieving events from the event storage.

CLogExampleLogDatabaseObserver:
- This class observes the event storage and notifies about changes in the 
  storage.

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

KNOWN ISSUES

Adding your own type of event requires a capability (WriteDeviceData) that is not 
available for a developer certificate. Therefore, you will probably not be able to 
add your own type of event in a device.

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

RUNNING THE EXAMPLE

On the Events tab, you can search for different types of events by selecting
'View events' from the 'Options' menu. The found events will then be displayed 
on the Events tab. Once displayed, you can view the details of an event by 
selecting 'Show details' from the 'Options' menu. An event can be removed by 
selecting 'Delete event' from the 'Options' menu.

You can add a random event or your own event to the event storage by selecting 
'Add event' from the 'Options' menu on the Events tab.

The Recent events tab shows all recent events (usually only voice calls). 
You can delete an event or view its details by selecting 'Delete event' or 
'Show details' from the 'Options menu'.


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

BUILD & INSTALLATION INSTRUCTIONS


--Mobile device (S60 3rd Edition)
    Go to /LogExample/group
    bldmake bldfiles
    abld build gcce urel
    Go to /LogExample/sis
    Edit the LogExample_s60_3rd_ed.pkg's paths to match those on your system.
    makesis LogExample_s60_3rd_ed.pkg
    
    Sign the SIS package:
	Sign the sis file (find out more about signing the sis file and 
        developer certificate from www.symbiansigned.com):
        signsis LogExample_s60_3rd_ed.sis LogExample3rdEd.sis YourCertificate.cer 
           YourKey.key YourPassword

    Install the signed .sis file to a S60 3rd Edition device.
    
--Mobile device (S60 2nd Edition)
    Go to /LogExample/group
    bldmake bldfiles
    abld build thumb urel
    Go to /LogExample/sis
    Edit the LogExample.pkg's paths to match those on your system.
    makesis LogExample.pkg    
    Install the SIS file to the device.
    
--Emulator (WINSCW)
    Go to /LogExample/group
    bldmake bldfiles
    abld build winscw udeb
    Start the emulator.

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

COMPATIBILITY

S60 3rd Edition
S60 2nd Edition

Tested on Nokia 6630, Nokia N90, Nokia E60

Created / tested with Series 60 2nd Edition SDK for Symbian OS, Supporting Feature
Pack 2, For C++, Supporting Metrowerks CodeWarrior


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

IMPROVEMENT IDEAS

Notification of events and clearing the event log could be handled using the 
MLogClientChangeObserver and MLogViewChangeObserver instead of the generic change 
method used in the current example.

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

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=320b0a08-3c5b-4c27-961b-058a97d6d3b9/S60_Platform_Log_Example_v1_0.zip