symbian 日志 使用范例

S60 Platform: Log Example v1.1 ------------------------------ 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 C++ basics. 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 WriteDeviceData capability which mandates signing with a developer certificate. In order to self-sign the application, the you need to make at least the following changes (these changes have been implemented in the self-signed installation package that is provided in the package): 1. Comment out the WriteDeviceData capability in group\LogExample_S60_3rd_ed.mmp: CAPABILITY ReadUserData WriteUserData // WriteDeviceData 2. Comment out the �Add event� menu item in data\LogExample.rss: /* MENU_ITEM { command = ELogExampleCmdAppAddEvent; txt = qtn_view1_option_item2; cascade = r_logexample_submenu_add; },*/ - On S60 2nd Edition, there is no tzconverter.h header file. It is needed when doing time zone conversions, so CLogExEventForm::UTCToLocalTimeL() is not implemented for S60 2nd Edition. Because of this, all times are interpreted as UTC and timestamps may be a couple of hours off on this platform. RUNNING THE EXAMPLE ------------------------------------------------------------------------------- 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 screen. 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. BUILD & INSTALLATION INSTRUCTIONS ------------------------------------------------------------------------------- Mobile device (S60 3rd Edition) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 1. Make sure the paths in .pkg files match those on your system. 2. Compile the example: cd group bldmake bldfiles abld reallyclean gcce abld build gcce urel 3. Make the sis: cd sis makesis -d"path_to_your_SDK" LogExample_S60_3_0_v_1_1_0.pkg signsis LogExample_S60_3_0_v_1_1_0.sis LogExample_S60_3_0_v_1_1_0.sis YourCertificate.cer YourKey.key YourPassword Signing with a developer certificate is required. For details on how to enable self-signing, see the Known issues section of this release note. 4. Install the signed .sis file to an S60 3rd Edition device. - In case you have created a self-signed installation package, check that App.Manager -> Settings -> Software Installation is set to "All� to avoid a "Certificate error" during installation. Mobile device (S60 2nd Edition, FP3) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 1. Make sure the paths in .pkg files match those on your system. 2. Compile the example: cd group bldmake bldfiles abld reallyclean thumb abld build thumb urel 3. Make the sis: cd sis makesis -d"path_to_your_SDK" LogExample_S60_2_3_v_1_1_0.pkg 4. Install the .sis file to an S60 2nd Edition device. Emulator (WINSCW) ~~~~~~~~~~~~~~~~~ 1. Compile the example: cd group bldmake bldfiles abld reallyclean winscw abld build winscw udeb 2. Start the emulator. COMPATIBILITY ------------------------------------------------------------------------------- S60 3rd Edition, Feature Pack 2 S60 3rd Edition, Feature Pack 1 S60 3rd Edition, Maintenance Release S60 2nd Edition, Feature Pack 3 S60 2nd Edition, Feature Pack 2 S60 2nd Edition, Feature Pack 1 S60 2nd Edition Tested on Nokia 6220 Classic, Nokia 6290, Nokia 6600, Nokia E61(i), Nokia E90 Communicator, Nokia N90, Nokia N95 8GB Developed and tested with: S60 3rd Edition SDK for Symbian OS, supporting Feature Pack 2, for C++, Beta S60 3rd Edition SDK for Symbian OS, supporting Feature Pack 1, for C++ S60 3rd Edition SDK for Symbian OS, for C++, Maintenance Release Series 60 2nd Edition SDK for Symbian OS, Supporting Feature Pack 3, For C++ VERSION HISTORY ------------------------------------------------------------------------------- 1.1 Backup & restore support implemented. Recent events view removed. Scalability issues fixed. Timestamps treated according to the time zone of the device. 1.0 First release. 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=5593178e-d998-45f0-a91f-91903006e7cb/S60_Platform_Log_Example_v1_1_en.zip.