S60 Platform: MMS Example v2.0
--------------------------------------------------------------------------------

This C++ example demonstrates how to create multimedia messages using the 
CMmsClientMtm API. Notice that some methods have changed between S60 2nd and 3rd Edition.

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

PREREQUISITES

Symbian C++ basics

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

IMPORTANT FILES/CLASSES

src\MMSExampleContainer.cpp 
    CreateNewMessageL():   Create a new message server entry (CMsvEntry).
				   Create a new MMS message (CMmsClientMtm). 	
				   There are major changes in adding an attachment between S60 2nd and 3rd Edition.
				   (See CreateAttachment2L() method)
    SendMessageL(): 	   Send the message.
    HandleSessionEventL(): Receives session events from observer

src\MMSExampleAppUi.cpp 
    CmdOpenMessagingL():   Open S60 messaging application.


Main classes: CMsvEntry, CMmsClientMtm

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

KNOWN ISSUES

It is not possible to test the sending of a message on the emulator.

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

RUNNING THE EXAMPLE

When the application is started, select Send MMS from the Options menu.
Next, the application prompts the Recipient dialog. Fill in your phone number (For example, 0501234567) 
and press OK. The log displays information, for example, 'Sending message' or 'Message received'.
When the log displays "Message received," select 'Open inbox' from the Options menu
(if tested on a real device) or 'Open Sent folder' (if tested in the emulator).

If problems occur in the real device, make sure that the MMS settings are correct.

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

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 /MMSExample/group
    bldmake bldfiles
    abld build gcce urel
    cd to /MMSExample/sis
    Edit the MMSExample_S60_3rd_ed.pkg's paths to match those on your system.
    makesis MMSExample_S60_3rd_ed.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". 
    
--Mobile device (S60 1st and 2nd Edition)
    cd to /MMSExample/group
    bldmake bldfiles
    abld build armi urel
    cd to /MMSExample/sis
    Edit the MMSExample_S60_2nd_ed.pkg's (or MMSExample_S60_1st_ed.pkg's) paths to match those on your system.
    makesis MMSExample_S60_2nd_ed.pkg's (or MMSExample_S60_1st_ed.pkg)
    Install the SIS file to the device.

--Emulator (WINSCW)
    cd to /MMSExample/group
    bldmake bldfiles
    abld build winscw udeb
    Start the emulator.
    
--------------------------------------------------------------------------------

COMPATIBILITY

S60 3rd Edition
S60 2nd Edition
S60 1st Edition

TESTED WITH Nokia 3650, Nokia 6670, Nokia E60
Created / tested with S60 1st Edition SDK (6.1) for Symbian OS 
and with S60 2nd Edition SDK for Symbian OS, Supporting Feature Pack 2, For C++, Supporting Metrowerks CodeWarrior
and with S60 3rd Edition SDK for Symbian OS, For C++, Supporting CodeWarrior

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

VERSION HISTORY		

2.0	Added support for S60 3rd Edition and scalable UI.
1.0	First release.

--------------------------------------------------------------------------------
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=6d3bf475-c4df-4b09-a5c4-9cd362c884d7/S60_Platform_MMS_Example_v2_0_en.zip