## SIS Builder

The SIS Builder 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.

The SIS Builder list includes these columns:

- Enabled - a checkmark indicates the SIS file is built during the build process, an unchecked file is not built
- Partial upgrade - a checkmark indicates that a partial upgrade .SIS file should be built. Left unchecked, no partial upgrade .SIS file is generated. See Partial Upgrades Files below for more information on this feature.
- Unsigned SIS file - names of the unsigned SIS files used by the project
- Signed SIS file - names of the signed SIS files created by the project

Figure 1 - SIS Builder pane

##### Table 1 SIS Builder items

Item | Explanation
--- | ---
Add | Opens the SIS Properties window to add a PKG file to the list.
Edit | Opens the selected SIS file in the SIS Properties window for editing.
Remove | Removes the selected SIS file from the list.
Move Up | Moves the selected SIS file up in the list order.
Move Down | Moves the selected SIS file down in the list order.

### Partial Upgrade Files

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 OS Device (Install SIS) is enhanced as the entire application no longer needs to be installed on the device each time a change is made.

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 Partial upgrade sis/sisx path in the Installation tab of the launch configuration. Links to the partial upgrade files are added to the project within the Project Explorer view.

NOTE 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.

Partial upgrade files are deleted and only full SIS/SISX files are generated when:

- the full SIS/SISX files do not already exist
- the PKG file is changed
- the Partial upgrade option is disabled

##### Other references

- Carbide Build Configurations
- SBSv2
- Environment
- Paths and Symbols
- ROM Builder