core/com.nokia.carbide.cpp.doc.user/html/reference/MMP_Editor.html
author fturovic <frank.turovich@nokia.com>
Wed, 21 Jul 2010 13:50:58 -0500
changeset 1658 2a5c0df13bad
parent 1507 30441fd93226
child 1988 5b598b1fcc3e
permissions -rw-r--r--
renamed files for consistency in naming
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
1376
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     2
<html><head>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     3
<title>MMP Editor</title>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     4
<link rel="StyleSheet" href="../../book.css" type="text/css"/>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     5
</head>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     6
   <body>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     7
   <h2>MMP Editor</h2>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     8
   
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     9
   <p>
1487
9c8f013bc5e2 revised mmp pages and images
fturovic <frank.turovich@nokia.com>
parents: 1376
diff changeset
    10
   The MMP Editor <strong>Overview</strong> tab allows you to view and modify your project definitions.  Changes made in the MMP editor are automatically written to the project's .MMP file. You can view the .mmp file by selecting the <em>project_name</em>.mmp tab located along the bottom of the MMP editor.</p>
1376
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    11
   <p>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    12
	  The MMP Editor is shown when an MMP  file is
1658
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1507
diff changeset
    13
   opened from the <a href="view_proj_explorer.htm">Project Explorer</a> or <a href="view_sym_proj_nav.htm">Symbian Project Navigator</a> views. The MMP Editor is shown in Figure 1. MMP editor fields are validated for existing or correct entries. For example, if the UID 2 field is blank the label is highlighted in red. If an error exists in the mmp file, the line where the error occurs is marked and also displayed in the Problems view.</p>
1487
9c8f013bc5e2 revised mmp pages and images
fturovic <frank.turovich@nokia.com>
parents: 1376
diff changeset
    14
   <p align="center"><img src="images/mmp_editor.png" width="675" height="406" /></p>
9c8f013bc5e2 revised mmp pages and images
fturovic <frank.turovich@nokia.com>
parents: 1376
diff changeset
    15
   <p align="left" class="figure">Figure 1 - MMP Editor Overview tab</p>
1376
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    16
   <table cellpadding="2" cellspacing="0"
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    17
border="0">
1487
9c8f013bc5e2 revised mmp pages and images
fturovic <frank.turovich@nokia.com>
parents: 1376
diff changeset
    18
	 <tr valign="top"><th width="190" class="Cell">Name</th><th width="955" class="Cell">Function</th></tr><tr valign="top"><td class="Cell">
1376
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    19
		    <p>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    20
			   <b>Target name</b></p></td><td class="Cell">
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    21
			 <p>
1487
9c8f013bc5e2 revised mmp pages and images
fturovic <frank.turovich@nokia.com>
parents: 1376
diff changeset
    22
				Enter the name of the target file.			 </p></td></tr><tr valign="top"><td class="Cell">
1376
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    23
			 <p>
1487
9c8f013bc5e2 revised mmp pages and images
fturovic <frank.turovich@nokia.com>
parents: 1376
diff changeset
    24
				<b>Target type</b>			 </p></td><td class="Cell">
1376
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    25
			 <p>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    26
				Select the type of target file from the dropdown list.</p></td></tr><tr valign="top"><td class="Cell">
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    27
			 <p>
1487
9c8f013bc5e2 revised mmp pages and images
fturovic <frank.turovich@nokia.com>
parents: 1376
diff changeset
    28
				<b>UID 2</b>			 </p></td><td class="Cell">
1376
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    29
			 <p>UID 2 is a unique identifier number that identifies the type of interface that the project implements. The values are defined by Symbian:</p>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    30
			 <ul>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    31
			   <li>For GUI applications, it is always 0x100039CE</li>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    32
			   <li>For static interface DLLs, the UID 2 is always 0x1000008d</li>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    33
			   <li>For polymorphic DLLs, the UID2 is defined by the framework which is being implemented</li>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    34
			 </ul>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    35
			 </td></tr><tr valign="top"><td class="Cell">
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    36
			 <p>
1487
9c8f013bc5e2 revised mmp pages and images
fturovic <frank.turovich@nokia.com>
parents: 1376
diff changeset
    37
				<b>UID 3</b>			 </p></td><td class="Cell">
1376
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    38
			 <p>
1487
9c8f013bc5e2 revised mmp pages and images
fturovic <frank.turovich@nokia.com>
parents: 1376
diff changeset
    39
				Application UID (or UID3) is used to uniquely identify the binary (EXE or DLL) within the system. The purpose of UID 3 is to prevent one executable from interfering the operation of another executable.</p></td></tr>
9c8f013bc5e2 revised mmp pages and images
fturovic <frank.turovich@nokia.com>
parents: 1376
diff changeset
    40
			 <tr valign="top">
9c8f013bc5e2 revised mmp pages and images
fturovic <frank.turovich@nokia.com>
parents: 1376
diff changeset
    41
			     <td class="Cell"><p> <b>Common tasks</b> </p></td>
9c8f013bc5e2 revised mmp pages and images
fturovic <frank.turovich@nokia.com>
parents: 1376
diff changeset
    42
			     <td class="Cell"><p> This group provides links to the User and System include path options located in the Options window. </p></td>
9c8f013bc5e2 revised mmp pages and images
fturovic <frank.turovich@nokia.com>
parents: 1376
diff changeset
    43
       </tr>
9c8f013bc5e2 revised mmp pages and images
fturovic <frank.turovich@nokia.com>
parents: 1376
diff changeset
    44
			 <tr valign="top"><td class="Cell">
1376
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    45
			 <p>
1487
9c8f013bc5e2 revised mmp pages and images
fturovic <frank.turovich@nokia.com>
parents: 1376
diff changeset
    46
				<b>Project definition</b>			 </p></td><td class="Cell">
9c8f013bc5e2 revised mmp pages and images
fturovic <frank.turovich@nokia.com>
parents: 1376
diff changeset
    47
			 <p>
9c8f013bc5e2 revised mmp pages and images
fturovic <frank.turovich@nokia.com>
parents: 1376
diff changeset
    48
				The Project definition group provides links to the Sources, Libraries, and Options windows. You can also select the Sources, Libraries, and Options tabs to open the related window. </p></td></tr>
1376
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    49
   </table>
1487
9c8f013bc5e2 revised mmp pages and images
fturovic <frank.turovich@nokia.com>
parents: 1376
diff changeset
    50
   <p>Any changes made to the MMP file either in Carbide or using an external editor are detected. If the build is for emulation, these changes are detected and used automatically. </p>
1376
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    51
	 <p>For other build types like GCCE you are  presented with the <b>Modified MMP Files Detected</b> dialog (Figure 2) and asked which build action to take for each MMP file that has changed. Set the build option for each listed MMP file and click <b>OK</b>.</p>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    52
	 <p align="center"><img src="images/wnd_modified_mmp_files.png" width="617" height="300"></p>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    53
	 <p align="left" class="figure">Figure 2 - Modified MMP Files Detected dialog </p>
1658
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1507
diff changeset
    54
	 <p align="left">The options  are  identical to the workspace setting <b>Default action to take when MMP files are modified </b>option in the <b>Build</b> preference panel. Click the <b>Configure Workspace Settings...</b> to open the <a href="pref_carb_build.htm">Build</a><b> </b>preference panel to set the default build options for the workspace. The options  can also be modified at the  project level in the <b>Properties for &lt;<i>project</i>&gt; &gt; </b><a href="build_properties/prop_carb_project_settings.htm">Carbide Project Settings</a> panel. </p>
1376
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    55
	 <h5>Related references</h5>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    56
       <ul>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    57
      <li><a href="MMP_Editor_sources.html">MMP Editor Sources window</a></li>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    58
      <li><a href="MMP_Editor_libraries.html">MMP Editor Libraries window</a></li>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    59
      <li><a href="MMP_Editor_options.html">MMP Editor Options window</a></li>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    60
      <li><a href="MMP_Editor_mmp_tab.html">MMP File Window</a></li>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    61
    </ul>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    62
  
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    63
   
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    64
<div id="footer">Copyright &copy; 2010 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    65
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    66
   </body>
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    67
</html>
0
fb279309251b DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff changeset
    68