releasenotes.txt

Symbian智能手机操作系统源代码值的参考_服务器

About S60 Platform: World Server Example
---------------------------------------
The World Server Example demonstrates the usage of the Symbian World Server. 
The example has methods for retrieving city/country-related information from the 
world server, writing new information to it, deleting information from it, 
performing basic calculations supported by the world server, and resetting the world 
server database to the original (ROM memory) state.

The World Server API is supported until Symbian OS v9.1 (S60 3rd Edition) where it is 
deprecated and and replaced by the Time Zone Localizer API (not covered in this example).

Prerequisites
-------------
- Symbian OS key concepts

Important classes
-----------------
CWSEngine:
A class that handles communication with the world server.

Known issues
------------
-The example does not work in the emulator (tested with Series 60 2nd 
Edition SDK for Symbian OS, Supporting Feature Pack 1, for C++, Supporting 
Microsoft Visual Studio).

-Connecting to the world server seems to reset some values (for example,
the time zone). As a workaround solution in the example a TLocale locale 
is constructed before connecting to the world server (see the WSENgine.cpp 
source file). Thus the initial, correct values are saved and they are then
restored after the connection.


Running the World Server Example
-----------------------------
All the functions of the application can be used from the Options menu that
has different options depending on which information is shown:

-'Search cities' and 'Search countries' functions fetch information about a 
selected city/country and add city/country-related options into the menu. 
All the name searches from the world server database accept partial names 
and in the case of multiple matches the user is prompted to select a desired
one.
-A distance from the currently shown city to another user-chosen city can be 
calculated by selecting the 'Distance to' function.

All options that alter the world server database content can be found in the 
'City database' submenu: 
-The selected city/country can be added to and removed from the database. 
-A whole datafile can be imported from and exported to the database. 
-The original world server database (located in ROM) can be restored with the 
'Reset database' function.


Installation instructions
-----------------------
-----------------------

MOBILE DEVICE
------------------
Go to /WSExample/group
bldmake bldfiles
abld build armi urel
Go to /WSExample/install
Edit the WSExample.pkg's paths to match those on your system.
makesis WSExample.pkg
Install the .sis file to your device

EMULATOR
------------------
Go to /WSExample/group
bldmake bldfiles
abld build wins udeb
Start the emulator


COMPATIBILITY
------------------
(S60 1st Edition)
S60 2nd Edition
TESTED WITH Nokia 6260, Nokia 6670, and Nokia N70.

Created / tested with Series 60 2nd Edition SDK for Symbian OS, Supporting 
Feature Pack 1, for C++, Supporting Microsoft Visual Studio


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=fec8a22a-d2a1-47e5-bc16-2ed90436e347/S60_Platform_World_Server_Example_v1_0.zip