core/com.nokia.carbide.cpp.doc.user/html/reference/build_properties/pane_build_config_sis.htm
author fturovic <frank.turovich@nokia.com>
Wed, 06 Oct 2010 10:31:32 -0500
changeset 2131 ff0156b93599
parent 2087 617a89f9dffc
permissions -rw-r--r--
moved inf, mmp, remote conn, and views to project folder
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
1658
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
     1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
     2
<html>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
     3
<head>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
     4
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
     5
<meta http-equiv="Content-Style-Type" content="text/css" />
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
     6
<meta name="LASTUPDATED" content="06/17/05 11:09:43" />
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
     7
<title>SIS Builder</title>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
     8
<link rel="StyleSheet" href="../../../book.css" type="text/css"/>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
     9
</head>
1791
727385d8e2b3 added new customize carbide section and some relinking done for deleted duplicate page
fturovic <frank.turovich@nokia.com>
parents: 1658
diff changeset
    10
<body >
1658
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    11
<h2>SIS Builder </h2>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    12
<p>The<b> SIS Builder</b> pane is used to specify one or more .PKG  and .SIS file options to create  application and patch .SIS files. These settings apply to the currently selected Configuration. </p>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    13
<p>The SIS Builder list includes these columns:</p>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    14
<ul>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    15
  <li><b>Enabled</b> - a checkmark indicates  the SIS file is built during the build process, an unchecked file is not built </li>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    16
  <li><b>Partial upgrade</b> - a checkmark indicates that a partial upgrade .SIS  file should be built. Left unchecked, no partial upgrade .SIS file is generated. See <a href="#PUAnchor">Partial Upgrades Files</a> below for more information on this feature.</li>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    17
  <li><b>Unsigned SIS file</b> - names of the unsigned SIS files used by the project </li>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    18
  <li><b>Signed SIS file</b>  - names of the signed SIS files created by the project  </li>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    19
</ul>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    20
<p align="center"><img src="../images/carbide_build_config.png" width="795" height="692" /></p>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    21
<p class="figure">Figure 1 - SIS Builder pane</p>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    22
<h5>Table 1 <span class="figure">SIS Builder</span> items </h5>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    23
<table width="100%"  border="0" cellpadding="2" cellspacing="0">
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    24
  <tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    25
    <th width="20%" scope="col">Item</th>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    26
    <th width="71%" scope="col">Explanation</th>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    27
  </tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    28
  <tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    29
    <td><b>Add</b></td>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    30
    <td> Opens the <a href="wnd_sis_properties.htm">SIS Properties</a> window to add a  PKG file to the list. </td>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    31
  </tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    32
  <tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    33
    <td><b>Edit</b></td>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    34
    <td> Opens the selected SIS file in the <a href="wnd_sis_properties.htm">SIS Properties</a> window for editing.</td>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    35
  </tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    36
  <tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    37
    <td><b>Remove</b></td>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    38
    <td>Removes the selected SIS file from the list.</td>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    39
  </tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    40
  <tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    41
    <td><b>Move Up </b></td>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    42
    <td>Moves the selected SIS file up in the list order.</td>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    43
  </tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    44
  <tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    45
    <td><b>Move Down</b></td>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    46
    <td>Moves the selected SIS file down in the list order.</td>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    47
  </tr>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    48
</table>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    49
<h3><a name="PUAnchor" id="PUAnchor"></a>Partial Upgrade Files</h3>
2131
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents: 2087
diff changeset
    50
<p>The SIS Builder supports the generation of partial upgrade .SIS files. A dialog appears when a SIS file exceeds 250k in size that describes the partial upgrade feature with a link to the SIS Builder page. Partial upgrade files enable Carbide to generate and download to the device only those portions of the application that have changed, enabling faster debug cycles. It does this using the SIS partial upgrade (PU) flag to mark the SIS file as a replacement or addition to the original SIS file. Debugging of large applications using Symbian Device (Install SIS) is enhanced as the entire application no longer needs to be installed on the device each time a change is made. </p>
ff0156b93599 moved inf, mmp, remote conn, and views to project folder
fturovic <frank.turovich@nokia.com>
parents: 2087
diff changeset
    51
<p>When the Partial update option is checked for a SIS file, both a complete and partial SIS files are generated. This ensures that the full SIS file is kept in sync with the partial upgrade SIS file. The partial upgrade SIS files are placed in the same folder as the full SIS file when stored in a project directory, or in the root of the project directory when the SIS file exists outside of the project. You can see where a partial upgrade file is created by examining the <b>Partial upgrade sis/sisx path</b> in the <a href="../../projects/launch/page_installation.htm">Installation</a> tab of the launch configuration. Links to the partial upgrade files are added to the project within the <a href="../../projects/views/view_proj_explorer.htm">Project Explorer</a> view.</p>
1658
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    52
<p class="note"><b>NOTE</b> Internally, the .PKG file format of a partial upgrade file is identical to a complete .PKG file with two exceptions, 1) the file list only includes the names of files changed, and 2) the PU flag is set.</p>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    53
<p>Partial upgrade files are deleted and only full SIS/SISX files are generated when:</p>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    54
<ul>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    55
  <li>the full SIS/SISX files do not already exist</li>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    56
  <li>the PKG file is changed</li>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    57
  <li>the Partial upgrade option is disabled</li>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    58
</ul>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    59
<h5>Other references</h5>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    60
<ul>
1934
4f0cd256d26c BUG 11531 - fixed reported issues from Rooney and Stephen for SDK section
fturovic <frank.turovich@nokia.com>
parents: 1791
diff changeset
    61
  <li><a href="prop_carb_build_config.htm">Carbide Build Configurations </a><a href="../../tasks/projects/working_with_sis_pkg_files.htm"></a></li>
1658
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    62
  <li><a href="pane_build_config_sbsv2.htm">SBSv2</a></li>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    63
  <li><a href="pane_build_config_env.htm">Environment</a></li>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    64
  <li><a href="pane_build_config_paths.htm">Paths and Symbols</a></li>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    65
  <li><a href="../ROM_build_settings.html">ROM Builder</a></li>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    66
</ul>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    67
<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>
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    68
2a5c0df13bad renamed files for consistency in naming
fturovic <frank.turovich@nokia.com>
parents: 1248
diff changeset
    69
</body>
0
fb279309251b DP tools release version Revision: 200912
Deepak Modgil <Deepak.Modgil@Nokia.com>
parents:
diff changeset
    70
</html>