core/com.nokia.carbide.cpp.doc.user/html/tasks/sdks/sdk_platform_filter.htm
author fturovic <frank.turovich@nokia.com>
Tue, 31 Aug 2010 22:58:09 -0500
changeset 1934 4f0cd256d26c
parent 1920 b6a66d85e102
child 2116 754589b0b7b4
permissions -rw-r--r--
BUG 11531 - fixed reported issues from Rooney and Stephen for SDK section
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
152
9e83cc047260 bug 8066 - revised image and option description for dynamic variants
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
9e83cc047260 bug 8066 - revised image and option description for dynamic variants
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     2
<html>
9e83cc047260 bug 8066 - revised image and option description for dynamic variants
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     3
<head>
9e83cc047260 bug 8066 - revised image and option description for dynamic variants
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     4
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
9e83cc047260 bug 8066 - revised image and option description for dynamic variants
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     5
<meta http-equiv="Content-Style-Type" content="text/css" />
9e83cc047260 bug 8066 - revised image and option description for dynamic variants
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     6
<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
1893
e29df1745269 removed old SDK pref page and fixed link, then added new cheatsheet
fturovic <frank.turovich@nokia.com>
parents: 1791
diff changeset
     7
<title>Build Configuration Filtering</title>
152
9e83cc047260 bug 8066 - revised image and option description for dynamic variants
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     8
<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
9e83cc047260 bug 8066 - revised image and option description for dynamic variants
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
     9
<script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js"></script>
9e83cc047260 bug 8066 - revised image and option description for dynamic variants
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    10
</head>
1791
727385d8e2b3 added new customize carbide section and some relinking done for deleted duplicate page
fturovic <frank.turovich@nokia.com>
parents: 1767
diff changeset
    11
<body >
1893
e29df1745269 removed old SDK pref page and fixed link, then added new cheatsheet
fturovic <frank.turovich@nokia.com>
parents: 1791
diff changeset
    12
<h2> Build Configuration Filtering </h2>
e29df1745269 removed old SDK pref page and fixed link, then added new cheatsheet
fturovic <frank.turovich@nokia.com>
parents: 1791
diff changeset
    13
<p> Use the <img src="../../images/command_link.png" border="0" alt="" /> <a class="command-link" href='javascript:executeCommand("org.eclipse.ui.window.preferences(preferencePageId=com.nokia.carbide.cpp.sdk.ui.sdk_platform_filter_page)")'>
1920
b6a66d85e102 BUG 11531 - update to build configuration items --DRAFT--
fturovic <frank.turovich@nokia.com>
parents: 1893
diff changeset
    14
Build Configuration Filtering</a> preference panel in the <b>Preferences</b> window to select which platforms are visible when creating new projects or build configurations. The results of this preference panel are used to populate the </p>
1696
38df3a235147 fixed broken TOC links, updated platform filtering pref panel, and reduced font size of manual
fturovic <frank.turovich@nokia.com>
parents: 1658
diff changeset
    15
<h3>SBSv2 tab</h3>
38df3a235147 fixed broken TOC links, updated platform filtering pref panel, and reduced font size of manual
fturovic <frank.turovich@nokia.com>
parents: 1658
diff changeset
    16
<p>Use the <strong>SBSv2</strong> tab to select  configurations for that build system. SBSv2 is the prefered build system for the most current SDKs.</p>
1893
e29df1745269 removed old SDK pref page and fixed link, then added new cheatsheet
fturovic <frank.turovich@nokia.com>
parents: 1791
diff changeset
    17
<p align="center"><img src="images/wnd_sdk_platform_filter_sbsv2.png" alt="SBSv2 tab" width="719" height="646"></p>
1696
38df3a235147 fixed broken TOC links, updated platform filtering pref panel, and reduced font size of manual
fturovic <frank.turovich@nokia.com>
parents: 1658
diff changeset
    18
<p align="center" class="figure">Figure 1. Platform Filtering Preferences page (SBSv2 tab)</p>
38df3a235147 fixed broken TOC links, updated platform filtering pref panel, and reduced font size of manual
fturovic <frank.turovich@nokia.com>
parents: 1658
diff changeset
    19
<h5>Table 1 <span class="figure">Platform Filtering Preferences</span> &mdash; SBSv2 items</h5>
38df3a235147 fixed broken TOC links, updated platform filtering pref panel, and reduced font size of manual
fturovic <frank.turovich@nokia.com>
parents: 1658
diff changeset
    20
<table width="100%"  border="0" cellpadding="2" cellspacing="0">
38df3a235147 fixed broken TOC links, updated platform filtering pref panel, and reduced font size of manual
fturovic <frank.turovich@nokia.com>
parents: 1658
diff changeset
    21
    <tr>
38df3a235147 fixed broken TOC links, updated platform filtering pref panel, and reduced font size of manual
fturovic <frank.turovich@nokia.com>
parents: 1658
diff changeset
    22
        <th width="29%" scope="col">Item</th>
38df3a235147 fixed broken TOC links, updated platform filtering pref panel, and reduced font size of manual
fturovic <frank.turovich@nokia.com>
parents: 1658
diff changeset
    23
        <th width="57%" scope="col">Explanation</th>
38df3a235147 fixed broken TOC links, updated platform filtering pref panel, and reduced font size of manual
fturovic <frank.turovich@nokia.com>
parents: 1658
diff changeset
    24
    </tr>
38df3a235147 fixed broken TOC links, updated platform filtering pref panel, and reduced font size of manual
fturovic <frank.turovich@nokia.com>
parents: 1658
diff changeset
    25
    <tr>
1893
e29df1745269 removed old SDK pref page and fixed link, then added new cheatsheet
fturovic <frank.turovich@nokia.com>
parents: 1791
diff changeset
    26
        <td><b>Default Configurations</b></td>
1920
b6a66d85e102 BUG 11531 - update to build configuration items --DRAFT--
fturovic <frank.turovich@nokia.com>
parents: 1893
diff changeset
    27
        <td><p>The result of a Raptor query (<span class="code">--query=aliases</span>) to show every supported aliases in every installed SDK. The aliases marked with a checkmark are available immediately as a selectable build configuration.</p>
b6a66d85e102 BUG 11531 - update to build configuration items --DRAFT--
fturovic <frank.turovich@nokia.com>
parents: 1893
diff changeset
    28
        </td>
1893
e29df1745269 removed old SDK pref page and fixed link, then added new cheatsheet
fturovic <frank.turovich@nokia.com>
parents: 1791
diff changeset
    29
    </tr>
e29df1745269 removed old SDK pref page and fixed link, then added new cheatsheet
fturovic <frank.turovich@nokia.com>
parents: 1791
diff changeset
    30
    <tr>
e29df1745269 removed old SDK pref page and fixed link, then added new cheatsheet
fturovic <frank.turovich@nokia.com>
parents: 1791
diff changeset
    31
        <td><strong>Product Variant Configurations</strong></td>
1920
b6a66d85e102 BUG 11531 - update to build configuration items --DRAFT--
fturovic <frank.turovich@nokia.com>
parents: 1893
diff changeset
    32
        <td>The result of the a Raptor query (<span class="code">--query=product</span>) to show the supported product variants available for the selected configuration. This list is not displayed if none of the installed SDKs support variant builds.</td>
1893
e29df1745269 removed old SDK pref page and fixed link, then added new cheatsheet
fturovic <frank.turovich@nokia.com>
parents: 1791
diff changeset
    33
    </tr>
e29df1745269 removed old SDK pref page and fixed link, then added new cheatsheet
fturovic <frank.turovich@nokia.com>
parents: 1791
diff changeset
    34
    <tr>
e29df1745269 removed old SDK pref page and fixed link, then added new cheatsheet
fturovic <frank.turovich@nokia.com>
parents: 1791
diff changeset
    35
        <td><strong>Rescan Default Configurations</strong></td>
1920
b6a66d85e102 BUG 11531 - update to build configuration items --DRAFT--
fturovic <frank.turovich@nokia.com>
parents: 1893
diff changeset
    36
        <td>Click to rescan for sbs and build configurations in all installed SDKs.</td>
1893
e29df1745269 removed old SDK pref page and fixed link, then added new cheatsheet
fturovic <frank.turovich@nokia.com>
parents: 1791
diff changeset
    37
    </tr>
e29df1745269 removed old SDK pref page and fixed link, then added new cheatsheet
fturovic <frank.turovich@nokia.com>
parents: 1791
diff changeset
    38
    <tr>
e29df1745269 removed old SDK pref page and fixed link, then added new cheatsheet
fturovic <frank.turovich@nokia.com>
parents: 1791
diff changeset
    39
        <td><strong>Add Variant</strong></td>
1920
b6a66d85e102 BUG 11531 - update to build configuration items --DRAFT--
fturovic <frank.turovich@nokia.com>
parents: 1893
diff changeset
    40
        <td>Opens the <strong>Add a custom product configuration</strong> dialog to create a variant build for the selected build configuration. The SDK must support variant builds for this to work.</td>
1893
e29df1745269 removed old SDK pref page and fixed link, then added new cheatsheet
fturovic <frank.turovich@nokia.com>
parents: 1791
diff changeset
    41
    </tr>
e29df1745269 removed old SDK pref page and fixed link, then added new cheatsheet
fturovic <frank.turovich@nokia.com>
parents: 1791
diff changeset
    42
    <tr>
e29df1745269 removed old SDK pref page and fixed link, then added new cheatsheet
fturovic <frank.turovich@nokia.com>
parents: 1791
diff changeset
    43
        <td><strong>Remove Variant</strong></td>
e29df1745269 removed old SDK pref page and fixed link, then added new cheatsheet
fturovic <frank.turovich@nokia.com>
parents: 1791
diff changeset
    44
        <td>Removes the selected variant from the list of available variants.</td>
1696
38df3a235147 fixed broken TOC links, updated platform filtering pref panel, and reduced font size of manual
fturovic <frank.turovich@nokia.com>
parents: 1658
diff changeset
    45
    </tr>
38df3a235147 fixed broken TOC links, updated platform filtering pref panel, and reduced font size of manual
fturovic <frank.turovich@nokia.com>
parents: 1658
diff changeset
    46
    <tr>
38df3a235147 fixed broken TOC links, updated platform filtering pref panel, and reduced font size of manual
fturovic <frank.turovich@nokia.com>
parents: 1658
diff changeset
    47
        <td><strong>Refresh</strong></td>
38df3a235147 fixed broken TOC links, updated platform filtering pref panel, and reduced font size of manual
fturovic <frank.turovich@nokia.com>
parents: 1658
diff changeset
    48
        <td><p>Select this button to obtain a fresh list of configurations from SBSv2. The list is refreshed each time Carbide  starts up, but this button will allow users to add configuration xml files and  get those new configurations  without restarting Carbide.c++. </p></td>
38df3a235147 fixed broken TOC links, updated platform filtering pref panel, and reduced font size of manual
fturovic <frank.turovich@nokia.com>
parents: 1658
diff changeset
    49
    </tr>
38df3a235147 fixed broken TOC links, updated platform filtering pref panel, and reduced font size of manual
fturovic <frank.turovich@nokia.com>
parents: 1658
diff changeset
    50
</table>
38df3a235147 fixed broken TOC links, updated platform filtering pref panel, and reduced font size of manual
fturovic <frank.turovich@nokia.com>
parents: 1658
diff changeset
    51
<h3>SBSv1 tab</h3>
38df3a235147 fixed broken TOC links, updated platform filtering pref panel, and reduced font size of manual
fturovic <frank.turovich@nokia.com>
parents: 1658
diff changeset
    52
<p>Use the <strong>SBSv1</strong> tab to select  configurations for that build system.</p>
38df3a235147 fixed broken TOC links, updated platform filtering pref panel, and reduced font size of manual
fturovic <frank.turovich@nokia.com>
parents: 1658
diff changeset
    53
<p align="center"><img src="images/wnd_sdk_platform_filter.png" width="501" height="387" alt="" /></p>
38df3a235147 fixed broken TOC links, updated platform filtering pref panel, and reduced font size of manual
fturovic <frank.turovich@nokia.com>
parents: 1658
diff changeset
    54
<p class="figure">Figure 2. Platform Filtering Preferences page (SBSv1 tab) </p>
38df3a235147 fixed broken TOC links, updated platform filtering pref panel, and reduced font size of manual
fturovic <frank.turovich@nokia.com>
parents: 1658
diff changeset
    55
<h5>Table 2 <span class="figure">Platform Filtering Preferences</span> &mdash;SBSv1 items</h5>
152
9e83cc047260 bug 8066 - revised image and option description for dynamic variants
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    56
<table width="100%"  border="0" cellpadding="2" cellspacing="0">
9e83cc047260 bug 8066 - revised image and option description for dynamic variants
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    57
  <tr>
9e83cc047260 bug 8066 - revised image and option description for dynamic variants
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    58
    <th width="29%" scope="col">Item</th>
9e83cc047260 bug 8066 - revised image and option description for dynamic variants
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    59
    <th width="57%" scope="col">Explanation</th>
9e83cc047260 bug 8066 - revised image and option description for dynamic variants
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    60
  </tr>
9e83cc047260 bug 8066 - revised image and option description for dynamic variants
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    61
  <tr>
9e83cc047260 bug 8066 - revised image and option description for dynamic variants
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    62
    <td><b>EKA2 Platforms</b></td>
9e83cc047260 bug 8066 - revised image and option description for dynamic variants
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    63
    <td><p>Select platform build targets to be displayed for OS 9.x and 8.1b when creating new projects and build configurations.</p>
9e83cc047260 bug 8066 - revised image and option description for dynamic variants
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    64
    <p>Build targets include:</p>
9e83cc047260 bug 8066 - revised image and option description for dynamic variants
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    65
    <ul>
9e83cc047260 bug 8066 - revised image and option description for dynamic variants
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    66
      <li>Emulation (WINSCW)</li>
9e83cc047260 bug 8066 - revised image and option description for dynamic variants
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    67
      <li>GCCE</li>
9e83cc047260 bug 8066 - revised image and option description for dynamic variants
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    68
      <li>ARMV5</li>
9e83cc047260 bug 8066 - revised image and option description for dynamic variants
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    69
      <li>ARMV5_ABIV2 (OS 9.1-9.3) </li>
9e83cc047260 bug 8066 - revised image and option description for dynamic variants
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    70
      <li>ARMV5_ABIV1 (OS 9.4+) </li>
9e83cc047260 bug 8066 - revised image and option description for dynamic variants
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    71
    </ul></td>
9e83cc047260 bug 8066 - revised image and option description for dynamic variants
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    72
  </tr>
9e83cc047260 bug 8066 - revised image and option description for dynamic variants
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    73
  <tr>
9e83cc047260 bug 8066 - revised image and option description for dynamic variants
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    74
    <td><b>Discover customization (.bsf) and Symbian Binary Variant (.var) platforms dynamically</b></td>
9e83cc047260 bug 8066 - revised image and option description for dynamic variants
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    75
    <td><p>Select this option to scan for customized platform extensions and binary variations. The variant files searched for include:</p>
9e83cc047260 bug 8066 - revised image and option description for dynamic variants
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    76
      <ul>
9e83cc047260 bug 8066 - revised image and option description for dynamic variants
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    77
        <li>.bsf files, located in the <span class="code">\epoc32\root</span> directory</li>
9e83cc047260 bug 8066 - revised image and option description for dynamic variants
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    78
        <li>Symbian Binary Variant (.var) files, located in the <span class="code">\epoc32\tools</span> directory</li>
1696
38df3a235147 fixed broken TOC links, updated platform filtering pref panel, and reduced font size of manual
fturovic <frank.turovich@nokia.com>
parents: 1658
diff changeset
    79
      </ul>    </td>
152
9e83cc047260 bug 8066 - revised image and option description for dynamic variants
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    80
  </tr>
9e83cc047260 bug 8066 - revised image and option description for dynamic variants
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    81
</table>
1920
b6a66d85e102 BUG 11531 - update to build configuration items --DRAFT--
fturovic <frank.turovich@nokia.com>
parents: 1893
diff changeset
    82
<p align="left" class="note"><strong>NOTE</strong> EKA1 platform configurations are not supported by Carbide.</p>
302
8ad872e05db4 Merge SDK Support page with Working with SDKs and cleaned up broken links and references to deleted page
fturovic <frank.turovich@nokia.com>
parents: 152
diff changeset
    83
<h4>Related references </h4>
152
9e83cc047260 bug 8066 - revised image and option description for dynamic variants
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    84
<ul>
302
8ad872e05db4 Merge SDK Support page with Working with SDKs and cleaned up broken links and references to deleted page
fturovic <frank.turovich@nokia.com>
parents: 152
diff changeset
    85
  <li><a href="../WorkingwithSDKs.html">Working with SDKs</a></li>
1934
4f0cd256d26c BUG 11531 - fixed reported issues from Rooney and Stephen for SDK section
fturovic <frank.turovich@nokia.com>
parents: 1920
diff changeset
    86
  <li><a href="../../reference/pref_carb_symbian_sdk.htm">Symbian SDKs panel </a> </li>
152
9e83cc047260 bug 8066 - revised image and option description for dynamic variants
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    87
</ul>
1376
120480c02651 BUG 10758 - copyright revised date to 2010
fturovic <frank.turovich@nokia.com>
parents: 302
diff changeset
    88
<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>
152
9e83cc047260 bug 8066 - revised image and option description for dynamic variants
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    89
9e83cc047260 bug 8066 - revised image and option description for dynamic variants
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    90
</body>
9e83cc047260 bug 8066 - revised image and option description for dynamic variants
fturovic <frank.turovich@nokia.com>
parents: 0
diff changeset
    91
</html>