core/com.nokia.carbide.cpp.doc.user/html/tasks/sdks/sdk_platform_filter.htm
author fturovic <frank.turovich@nokia.com>
Wed, 13 Oct 2010 14:01:23 -0500
changeset 2154 5dd5b87d0ddf
parent 2133 bf6117909093
permissions -rw-r--r--
BUG 12342 - Added notes about SBSvX tabs presence based on SDKs used by project

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
<title>Build Configuration Filtering</title>
<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
<script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js"></script>
</head>
<body >
<h2> Build Configuration Filtering </h2>
<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=org.eclipse.debug.ui.LaunchConfigurations)")'>
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. </p>
<p class="note"><b>NOTE</b> Based on which SDKs the project uses, one or both of the SBSvX tabs are shown.</p>
<h3>SBSv2 tab</h3>
<p>Use the <strong>SBSv2</strong> tab to select  configurations for the build system. SBSv2 is the prefered build system for the most current SDKs.</p>
<p>The SBSv2 configurations and variants available on this page represent the pool of all available configurations for discovered Symbian SDKs. Not all configurations apply to all SDKs; Carbide will filter configurations appropriate for each SDK in the SDK/Configuration tree selection.</p>
<p align="center"><img src="images/wnd_sdk_platform_filter_sbsv2.png" alt="SBSv2 tab" width="719" height="646"></p>
<p align="center" class="figure">Figure 1. Platform Filtering Preferences page (SBSv2 tab)</p>
<h5>Table 1 <span class="figure">Platform Filtering Preferences</span> &mdash; SBSv2 items</h5>
<table width="100%"  border="0" cellpadding="2" cellspacing="0">
    <tr>
        <th width="29%" scope="col">Item</th>
        <th width="57%" scope="col">Explanation</th>
    </tr>
    <tr>
        <td><b>Default Configurations</b></td>
        <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>
        </td>
    </tr>
    <tr>
        <td><strong>Product Variant Configurations</strong></td>
        <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>
    </tr>
    <tr>
        <td><strong>Rescan Default Configurations</strong></td>
        <td>Click to rescan for sbs and build configurations in all installed SDKs.</td>
    </tr>
    <tr>
        <td><strong>Add Variant</strong></td>
        <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>
    </tr>
    <tr>
        <td><strong>Remove Variant</strong></td>
        <td>Removes the selected variant from the list of available variants.</td>
    </tr>
    <tr>
        <td><strong>Refresh</strong></td>
        <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>
    </tr>
</table>
<h3>SBSv1 tab</h3>
<p>Use the <strong>SBSv1</strong> tab to select  configurations for that build system.</p>
<p align="center"><img src="images/wnd_sdk_platform_filter.png" width="501" height="387" alt="" /></p>
<p class="figure">Figure 2. Platform Filtering Preferences page (SBSv1 tab) </p>
<h5>Table 2 <span class="figure">Platform Filtering Preferences</span> &mdash;SBSv1 items</h5>
<table width="100%"  border="0" cellpadding="2" cellspacing="0">
  <tr>
    <th width="29%" scope="col">Item</th>
    <th width="57%" scope="col">Explanation</th>
  </tr>
  <tr>
    <td><b>EKA2 Platforms</b></td>
    <td><p>Select platform build targets to be displayed for OS 9.x and 8.1b when creating new projects and build configurations.</p>
    <p>Build targets include:</p>
    <ul>
      <li>Emulation (WINSCW)</li>
      <li>GCCE</li>
      <li>ARMV5</li>
      <li>ARMV5_ABIV2 (OS 9.1-9.3) </li>
      <li>ARMV5_ABIV1 (OS 9.4+) </li>
    </ul></td>
  </tr>
  <tr>
    <td><b>Discover customization (.bsf) and Symbian Binary Variant (.var) platforms dynamically</b></td>
    <td><p>Select this option to scan for customized platform extensions and binary variations. The variant files searched for include:</p>
      <ul>
        <li>.bsf files, located in the <span class="code">\epoc32\root</span> directory</li>
        <li>Symbian Binary Variant (.var) files, located in the <span class="code">\epoc32\tools</span> directory</li>
      </ul>    </td>
  </tr>
</table>
<p align="left" class="note"><strong>NOTE</strong> EKA1 platform configurations are not supported by Carbide.</p>
<h4>Related references </h4>
<ul>
  <li><a href="../WorkingwithSDKs.html">Working with SDKs</a></li>
  <li><a href="../../reference/pref_carb_symbian_sdk.htm">Symbian SDKs panel </a> </li>
</ul>
<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>

</body>
</html>