Symbian3/PDK/Source/GUID-328F3DB6-D956-5854-A81A-6B98DC3FA6DC.dita
changeset 1 25a17d01db0c
child 3 46218c8b8afa
equal deleted inserted replaced
0:89d6a7a84779 1:25a17d01db0c
       
     1 <?xml version="1.0" encoding="utf-8"?>
       
     2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
       
     3 <!-- This component and the accompanying materials are made available under the terms of the License 
       
     4 "Eclipse Public License v1.0" which accompanies this distribution, 
       
     5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
       
     6 <!-- Initial Contributors:
       
     7     Nokia Corporation - initial contribution.
       
     8 Contributors: 
       
     9 -->
       
    10 <!DOCTYPE task
       
    11   PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
       
    12 <task xml:lang="en" id="GUID-328F3DB6-D956-5854-A81A-6B98DC3FA6DC"><title>Create an MMP file for the PSY </title><shortdesc>This section describes how to create the MMP file for a PSY. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody><context><p>The MMP file for the PSY must declare it as an ECOM plugin and specify the resources it requires. </p> </context> <steps-unordered><step id="GUID-F5907612-5E43-501F-99CF-402DEFE88642"><cmd>Create an MMP file for the PSY </cmd> <info>The MMP file has the format shown in the example below. </info> <stepxmp><codeblock id="GUID-5AA30AE6-270C-5C68-A36B-1A30C1A99625" xml:space="preserve">TARGET          examplepsy.dll 
       
    13 TARGETTYPE      PLUGIN
       
    14 UID             0x10009d8d 0x10001234
       
    15 
       
    16 CAPABILITY      CAP_ECOM_PLUGIN
       
    17 SOURCEPATH      ..\src
       
    18 SOURCE          EPos_ExampleMain.cpp
       
    19 SOURCE          EPos_CPosExamplePositioner.cpp
       
    20 
       
    21 USERINCLUDE     ..\src
       
    22 USERINCLUDE     ..\resource
       
    23 
       
    24 SYSTEMINCLUDE   \Epoc32\Include
       
    25 SYSTEMINCLUDE   \Epoc32\Include\oem
       
    26 SYSTEMINCLUDE   \Epoc32\Include\ecom
       
    27 
       
    28 SOURCEPATH      ..\resource
       
    29 
       
    30 START RESOURCE  exampleresource.rss   // uid of dll
       
    31 TARGET          examplepsy.rsc
       
    32 TARGETPATH      \resource
       
    33 END
       
    34 
       
    35 LIBRARY         euser.lib
       
    36 LIBRARY         lbs.lib
       
    37 LIBRARY         eposservercommon.lib
       
    38 </codeblock> </stepxmp> <info>The second UID must be <codeph>0x10009d8d </codeph> and the third UID is the PSY DLL UID (allocated from Symbian). The PSY ECOM implementation must have a trust level of <codeph>CAP_ECOM_PLUGIN</codeph> to be loaded by the Location Framework. If the trust level is less than <codeph>CAP_ECOM_PLUGIN</codeph> then the PSY cannnot be used by Location Framework. </info> <info>The MMP file must specify \epoc32\include, \epoc32\include\oem, and \epoc32\include\ecom as system includes and <filepath>euser.lib</filepath>, <filepath>lbs.lib</filepath> and <filepath>eposservercommon.lib</filepath> as libraries. </info> </step> </steps-unordered> <postreq><p>A developer must create a subclass of <xref href="GUID-0CA8AEC1-FF5E-3556-ACBD-0D4277CF1350.dita"><apiname>CPositioner</apiname></xref> to implement a PSY. </p> <p>See <xref href="GUID-0B4D4675-2CFB-5964-A869-7275202AC71D.dita">Implement a subclass of CPositioner</xref> for more information. </p> </postreq> </taskbody><related-links><link href="GUID-86AD79A5-E18D-56C6-997A-5E2B24FEE80D.dita"><linktext>Positioning
       
    39                 Plug-in API Tutorial</linktext> </link> </related-links></task>