author | fturovic <frank.turovich@nokia.com> |
Thu, 20 May 2010 10:32:00 -0500 | |
changeset 1376 | 120480c02651 |
parent 0 | fb279309251b |
child 1487 | 9c8f013bc5e2 |
permissions | -rw-r--r-- |
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 Options</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 Options Window</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> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
10 |
The MMP editor options window allows you to edit compiler, linker, and runtime settings. The MMP editor options window is shown in Figure 1.</p> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
11 |
<p align="center"><img src="images/mmp_editor_options.png" width="939" height="450" /></p> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
12 |
<p align="left" class="figure">Figure 1 - MMP Editor Options window</p> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
13 |
<p></p> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
14 |
<table cellpadding="2" cellspacing="0" |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
15 |
border="0"> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
16 |
<tr valign="top"><th width="173" class="Cell">Name</th><th width="516" class="Cell">Function</th></tr><tr valign="top"><td class="Cell"> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
17 |
<p> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
18 |
<b>Runtime</b></p></td><td class="Cell"> |
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 |
This group allows you to define various runtime options.</p> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
21 |
<p><b>Capabilities</b> - Click the Choose... button to select Capabilities. A capability is an access token that corresponds to permission to access sensitive system resources. Platform security permits access to sensitive APIs according to capabilities. Capabilities are used to specify what functionality an application is trusted to use; they are allocated to the application at build time and are policed at run time. Once the capabilities are assigned to the application, they cannot be changed. Thus an application has a set of unalterable capabilities that describe what access the application has to the APIs.</p> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
22 |
<p>There are three suggested ways to establish which capabilities an application requires.</p> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
23 |
<ul> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
24 |
<li>The first method is initially to allocate capabilities based on the general operations that the application performs. For example, an instant messaging application would probably require NetworkServices to access the Internet and ReadUserData to read the user’s contacts.</li> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
25 |
<li>The second method is to use the Symbian Developer Library, which lists the capabilities required by each API. Note that some APIs may be marked as “Dependent”, meaning that the need for the capability depends on the parameters being passed. For example, accessing a file in an application’s private data area requires no capabilities, but accessing a file in \sys\bin requires the <span class="code">AllFiles</span> capability.</li> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
26 |
<li>The third method is to run the application in the emulator, analyzing the debug file (in the system temporary directory) for capability violations. The output will state the API that caused the violation and what capability was expected.</li> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
27 |
</ul> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
28 |
<p><b>Minimum heap size</b> - Set the heap size that you need.</p> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
29 |
<p><b>Maximum heap size</b> - Set the heap size that you need.</p> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
30 |
<p><b>Stack size</b> - Set the stack size that you need.</p> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
31 |
<p><b>Process priority </b> - Select the process priority from the dropdown list.</p> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
32 |
<p><b>Secure ID</b> - Enter the Secure ID. The SID is used to determine which private directory a process can access. It is also used to identify the caller applications. An application's SID is defined within its .mmp file, and is used to uniquely identify the application. SID values are requested from the Symbian Signed Web site (www.symbiansigned.com). The Software Installer (SWI) is responsible for ensuring that SIDs are locally unique, i.e., that no two applications have the same SID value on a particular target device.</p> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
33 |
<p><b>Vendor ID</b> - Enter the Vendor ID. This ID uniquely identifies the source of the application. If an application needs a VID, it must be certified. Noncertified applications must use a VID of 0 (KNullUid), which is the value applied by default.</p> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
34 |
<p><b>Enable debugging (Symbian OS 9.4+) </b>- Activate to enable on-device debugging for Symbian OS 9.4 and later. When activated, the <span class="code">DEBUGGABLE_UDEBONLY</span> flag is added to the project .MMP file. </p> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
35 |
<p><b>Paging Mode (Symbian OS 9.3+)</b> - specify the paging mode to: not specified, paged, or unpaged. </p></td> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
36 |
</tr><tr valign="top"><td class="Cell"> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
37 |
<p> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
38 |
<b>Compiler Settings</b></p></td><td class="Cell"> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
39 |
<p> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
40 |
<b>User includes</b> - Use the Add, Edit, and Remove buttons to add, edit, or remove the paths to the user header files used to compile source files. Use the Up and Down buttons to arrange the list of paths. </p> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
41 |
<p><b>System includes</b> - Use the Add, Edit, and Remove buttons to add, edit, or remove the paths to the system header files used to compile source files. Use the Up and Down buttons to arrange the list of paths.</p> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
42 |
<p><b>Macros</b> - Use the Add, Edit, and Remove buttons to add, edit, or remove a macro identifier. Use the Up and Down buttons to arrange the list of macro identifiers.</p> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
43 |
<p><b>Compiler options</b> - Use the Add, Edit, and Remove buttons to add, edit, or remove compiler options. In the Edit Compiler Options dialog, select the tool chain (for example: ARMCC, CW, GCC, GCCE, or MSVC) and enter your custom options.</p> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
44 |
<p><b>Linker options</b> - Use the Add, Edit, and Remove buttons to add, edit, or remove linker options. In the Edit Linker Options dialog, select the tool chain (for example: ARMCC, CW, GCC, GCCE, or MSVC) and enter your custom options.</p> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
45 |
<p><b>Per-variant include dependencies</b> - Check this option to include dependencies for a specific variant when building a target. For example build a release variant with optimized code, a debug variant with debugging info and a profiling variant with timing hooks.</p> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
46 |
<p><b>Disable optimizations in debug builds</b> - Check this option to disable optimizations when building a debug version of your application. Since optimization changes the code created by the compiler, it is best to optimize your code after you have fully tested and debugged it. If a program works in a debug build, but fails in a release build, it is likely that one of the compiler optimizations is exposing a defect in your source code. To isolate the problem, you should disable selected optimizations for each source code file, until you locate the file and the optimization that is causing the problem.</p></td> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
47 |
</tr> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
48 |
<tr valign="top"> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
49 |
<td class="Cell"><b>Linker</b></td> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
50 |
<td class="Cell"><p><b>Linker definition file</b> - Select a linker definition file or click Browse... to locate a definition file.</p> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
51 |
<p><b>Export unfrozen</b> - Check this option to tell the build process that exports are not yet frozen.</p> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
52 |
<p><b>Don't export library</b> - Check this option to not export a copy of the library. </p> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
53 |
<p><b>No strict .def file</b> - Check this option to specify no strict linker definition file.</p> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
54 |
<p><b>Compress target executable</b> - Check this option to compress the target executable. </p> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
55 |
<p><b>Link as internal name</b> - Specify an internal name.</p> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
56 |
<p><b>Win32 base address</b> - Specify the Win32 base address.</p></td> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
57 |
</tr> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
58 |
<tr valign="top"> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
59 |
<td class="Cell"><b>Kernel</b></td> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
60 |
<td class="Cell"><p><b>ASSP ABI </b>- Check this option to build the ASSP application binary interface. </p> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
61 |
<p><b>ASSP exports</b> - Check this option to enable ASSP exports. </p></td> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
62 |
</tr> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
63 |
</table> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
64 |
<h5>Related references</h5> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
65 |
<ul> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
66 |
<li><a href="MMP_Editor.html">MMP Editor</a></li> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
67 |
<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
|
68 |
<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
|
69 |
<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
|
70 |
</ul> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
71 |
|
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
72 |
|
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
73 |
<div id="footer">Copyright © 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
|
74 |
|
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
75 |
</body> |
120480c02651
BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
76 |
</html> |
0
fb279309251b
DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff
changeset
|
77 |