releasenotes.txt

symbian平台

About Series 60 Platform 1st/2nd Edition: SMS Example
-----------------------------------------------------------------------------
-----------------------------------------------------------------------------
This example shows how SMS messages can be manipulated programmatically.
In addition, the example demonstrates how messages can be deleted, copied, or
moved to other folders (inbox, outbox, drafts). The program can also send,
autoreceive (that is, catch the message before a user sees the incoming message), 
and autodelete messages.


Prequisities
------------
- Active objects
- Symbian OS key concepts 
- Messaging key concepts


Important classes
-----------------

CSMSExampleMtmsEngine  | SMS handling { deletion / copying / moving /  sending/  msg bodys / msg address }.
			
CLogView               | Visualizes what has happened.

CListboxView           | Manages Listbox command handling and performs operations on selected messages.

CMarkableListContainer | SMS message container. Selects groups of messages.

CSMSExampleParser      | Searches for a number which has exactly 10 digits from SMS message body.

CSMSExampleAppUi       | Manages command handling and captures (automatically) received messages. Also performs 
                         automatic deletion of the received messages, if this feature is on.


Running the example
--------------------------

Log view:
The default view is the log. The log collects all events and displays information
about every event that has happened. The log tells, for example, when a new message has arrived and 
displays its body text/address. Please be patient if your folders are large; listing operations
could take several seconds. Note that the messages moved or copied from inbox cannot be edited
due to the fact that the messages have their complete flag on.


The commands in the Options menu are as follows:

1. "Send SMS".
  1.1 "Address query". Write SMS recipient. For example "050 123 4567".
    1.1.1 "SMS body text". Write SMS body text. Max 160 characters.

2. "Move message". 
  2.1 "From drafts". Select source folder.
    2.1.1 "To inbox". Select target folder.  -> 6. Listbox Operation Move from drafts to inbox.
    2.1.2 "To outbox". Select target folder. -> 6. Listbox Operation Move from drafts to outbox.
 
	
  2.2 "From outbox". Select source folder.
    2.2.1 "To inbox". Select target folder.  -> 6. Listbox Operation Move from outbox to inbox.
    2.2.2 "To drafts". Select target folder. -> 6. Listbox Operation Move from outbox to drafts.

  2.3 "From inbox". Select source folder.
    2.3.1 "To outbox". Select target folder. -> 6. Listbox Operation Move from inbox to outbox.
    2.3.2 "To drafts". Select target folder. -> 6. Listbox Operation Move from inbox to drafts.

3. "Copy message".
   Same as 2.1 but the Operation is Copy.

4. "Delete message".
   4.1 From drafts -> 6. Listbox Operation Delete from drafts
   4.2 From outbox -> 6. Listbox Operation Delete from outbox
   4.3 From inbox  -> 6. Listbox Operation Delete from inbox
	
5. "Settings"
   5.1 "Automatic delete on". Set this option if you want to delete received SMS messages automatically.
       NOTE! This feature will delete every arrived SMS message while it is on. Be careful with it, although
       it shows the message address/content before deletion. There is a slight delay between message
       arrival and message automatic deletion because ncnlist panics if there is no time to play the
       "message has arrived" tone.

   5.2 "Automatic delete off". Set this option, if you do not want to delete received SMS messages automatically (Default).


Listbox view:
Choose a group of messages for which to perform an operation. The commands in the Options menu are as follows:

6. "Select all". Select all SMS messages of the chosen source folder.

7. "Deselect all". Deselect all SMS messages.
 
8. "Done". Execute an operation for chosen messages. ( See 2. / 3. / 4. ). The Log is notified of the executed operation.


Press the joystick/scroller key to select or deselect a message.

9. "Back". Return to the log view and do nothing.
 




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

MOBILE PHONE
------------------
go to /SMSExample/group
bldmake bldfiles
abld build armi urel
go to /SMSExample/sis
makesis Series60_v21_smsexample.pkg (if SDK 2.x)
makesis Series60_v12_smsexample.pkg (if SDK 1.x)  Note: See the Known issues section for required changes
install .sis to your device


EMULATOR
------------------
go to /SMSExample/group
bldmake bldfiles
abld build wins udeb
start the emulator

Note: The emulator observes the Drafts folder instead of the Inbox. Thus it is possible to see what
the example does without a real SMS support from the emulator.


Compiled with series60 SDK v1.2.
Tested with Nokia 6260, Nokia 6600, Nokia 3650, and Nokia 6630


Known issues
------------
-smutset.h and smuthdr.h are missing from the Series 60 SDK 2.0.
-etelgprs.h / etelbgsm.h are missing from the Series 60 SDK 1.2. Thus, when building for Series 60 Platform v1.2, 
you need to change the header files smutset.h, smsuaddr.h, and gsmumsg.h as follows:

File			Replace				With
------------------------------------------------------------------------------------------------------
smutset.h		#include <etelgprs.h>		class RGprs { public: enum TSmsBearer{}; };

smsuaddr.h		#if !defined(__ETELBGSM_H__)	const TUint KGsmMaxTelNumberSize = 100;
			#include <etelbgsm.h>
			#endif

gsmumsg.h		#if !defined (__ETELBGSM_H__)	class RSmsStorage				
			#include <etelbgsm.h>		{
			#endif				public:
								enum TStatus{};
							};