22-Oct-2009 Tommi Kenakkala

HOW TO INTEGRATE:

- This version uses MCLwk32+QtOrbitDeltawk37+QtControlPanelwk38

- To get this working you have use the refactored vmbxengine.

Copy cvoicemailbox.h, cvoicemailboxentry.h, voicemailboxdefs.h to the phonesrv_plat api folder (Same as old)

(I'll also remove vmbxengine app layer api dependencies from mercurial)

- Copy Qt control panel to root 

- Edit \qtcontrolpanel\qtcontrolpanel\controlpanelplugins\communicationplugin\data\cpcommunicationplugin.cpcfg

by adding:

  <plugin displayname = "displayname" id = "0X20029F5D"  dll = "vmbxcpplugin.dll">

    <desc>I'm a description</desc>

  </plugin>

(remember to check that uid matches to implementation)

- To get signals from ui control in QtControlPanelwk38 package you have to fix the mistyped connect

in qtcontrolpanel\qtcontrolpanel\cpframework\src\cpsettingformitemdata.cpp:

"lineEditTextChanged" is mistyped as "lineEditTextChangge"

Signal is emitted on every character change so we or control panel have to fix that.

- After above is done compile qtcontrolpanel:

           qmake -spec symbian-abld

           bldmake bldfiles

           abld build winscw udeb

- Copy vmbxcpplugin to root and compile similarly

- If you want to avoid carbide:

 - Install DebugView (debug traces are printed there)

 - launch epoc.exe from shell, launch DebugView PC app

 - In emulator open eshell and launch the application there by typing the exe name

- If vmbxcpplugin is not loaded enable QtControlPanel tracing and check the control 

panel fw traces, there should be a trace for every plugin load attemp. 

After "desc" tag there's a "loading failed" string if e.g. vmbxcpplugin.dll 

loading failed because linking to vmbxengine.dll had problems.

Here is an ok trace from qtcontrolpanel:  

    "[1876]  diplayname =  "displayname"  

    [1876]  dll =  "vmbxcpplugin.dll"  

    [1876]  desc =  "I'm a description"  " 

HOW TO USE QT CONTROL PANEL ON UI: 

- launch by selecting applications > qtcontrolpanel 

or applications > eshell and type qtcontrolpanel

- Click the "+" to open communications group

- Click the "+" to open vmbx group

- when you start editing the number, it will be save every time you change even a single character

ABOUT DESIGN & FEATURES:

- TODO: update VmbxCpGroup to class VmbxCpGroup : public CpSettingFormItemData 

when DataForm bug is fixed (QTControlPanel wk39-41?), now append/addchild() panics.

After the base class switch API will change but it should be just a few minutes of work to do that.

- Ps Services to be implemented later when we know if they will be in vmbx control panel group or in service settings group.

- UI editing permit checking must be implemented

- Video ALS support not to be implemented on UI, do it later if there really is someone using it.

- Default mailbox setting to be implemented later to CVoiceMailbox API and to UI, if future UI concepts still specify it.

- Use QT_TRAP_THROWING when qt 4.6 available, but do test then that qt throws and symbian leaves work ok together.

- Triple-check cleanup everywhere

- .pro file include paths are hard-coded, fix those for phonesrv_plat api folders.

test