1 

     2 22-Oct-2009 Tommi Kenakkala

     3 

     4 HOW TO INTEGRATE:

     5 - This version uses MCLwk32+QtOrbitDeltawk37+QtControlPanelwk38

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

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

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

     9 - Copy Qt control panel to root 

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

    11 by adding:

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

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

    14   </plugin>

    15 (remember to check that uid matches to implementation)

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

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

    18 "lineEditTextChanged" is mistyped as "lineEditTextChangge"

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

    20 - After above is done compile qtcontrolpanel:

    21            qmake -spec symbian-abld

    22            bldmake bldfiles

    23            abld build winscw udeb

    24 - Copy vmbxcpplugin to root and compile similarly

    25 

    26 - If you want to avoid carbide:

    27  - Install DebugView (debug traces are printed there)

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

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

    30 

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

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

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

    34 loading failed because linking to vmbxengine.dll had problems.

    35 Here is an ok trace from qtcontrolpanel:  

    36     "[1876]  diplayname =  "displayname"  

    37     [1876]  dll =  "vmbxcpplugin.dll"  

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

    39 

    40 HOW TO USE QT CONTROL PANEL ON UI: 

    41 - launch by selecting applications > qtcontrolpanel 

    42 or applications > eshell and type qtcontrolpanel

    43 - Click the "+" to open communications group

    44 - Click the "+" to open vmbx group

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

    46 

    47 ABOUT DESIGN & FEATURES:

    48 

    49 - TODO: update VmbxCpGroup to class VmbxCpGroup : public CpSettingFormItemData 

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

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

    52 

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

    54 - UI editing permit checking must be implemented

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

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

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

    58 - Triple-check cleanup everywhere

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

    60 

    61 test

    62