# README for Symbian OS Binary Access Kits

## Copyright (c) Symbian Software Ltd 2002 - 2008. All rights reserved.

### Introduction

This file provides a pre-installation point of reference for Symbian OS Kit installation and configuration information.

### System Requirements

#### Hardware

A PC with the minimum of a Pentium 1GHz processor (or equivalent) and 512MB of RAM running Microsoft Windows 2000 or Windows XP. Drive space requirements depend on the number and size of Kit packages selected for installation. However, the following can be considered as a guide :

##### Symbian OS Development Kit Drive Space Requirements

500 MB in Temp directory for installation runtime, in addition to the following for a full installation :

-Windows 2000/XP : 1.5 GB

NOTE: Although a Symbian OS Kit may install and run on a system that is less powerful than the recommended specification, performance may be unacceptable for development purposes.

To run and debug OS components and applications on target hardware a compatible reference board or target device is required.

The following hardware reference boards are currently supported :

- Intel DBPXA255
- Intel DBPXA250

#### Software

For OS component and application development using an emulator, Metrowerks CodeWarrior Development Tools for Symbian OS Professional Edition is required.

To browse the Symbian Developer Library, a web browser supporting tables is needed.

### Starting Kit Installation

Symbian OS Kits have a comprehensive installation mechanism. If installing from CD-ROM, this should run automatically on disc insertion. However, if installation fails to begin :

- ensure you have administrative privileges if running Windows NT or 2000
- select "Start|Run"
- enter "<CD-ROM DRIVE>\setup.exe " into the "Open" field
- click "OK"

If installing from a network, the root location of the Kit image must first be mapped to a drive on the target system - double-clicking the "setup.exe" on this drive will invoke the installation process.

### Kit Installation Process

#### Destination Location

On acceptance of the Kit license agreement, the installation mechanism will prompt for a destination folder - this is the root location to where the main Kit contents will eventually be copied via the Symbian OS Kit Installer.

#### Select Components

There are two mandatory, and two optional, installations that are made prior to selecting specific Symbian OS Kit components to install.

##### Symbian OS Kit Installer (mandatory)

A utility for managing the installation of Symbian Kit components - launched automatically as part of the initial installation process. This is the means by which the various component packages that form a Symbian OS Kit can be selected, installed, maintained and removed.

##### Java Runtime Environment (mandatory)

The Sun Java runtime required to run both the Symbian OS Kit Installer and a range of GUI developer tools that may be offered for installation. This Java runtime is of a specific version to support the installer and these tools - it is a mandatory requirement of Kit installation that this version is installed.

NOTE: The Java Runtime Environment will not install and run successfully on a system running at less than a 256 colour depth.

NOTE: The version currently specified and supplied is 1.3.1 build 01. This is detected in the registry as key "HKLM\SOFTWARE\JavaSoft\Java Runtime Environment\1.3.1".

##### Perl (optional)

ActiveState Perl is required by the majority of Symbian developer tools. This interpreter is of a specific version to support these developer tools. If the Kit installation is for development, and the required version of Perl (or later) is not installed, it is recommended that this option is left checked.

NOTE: Perl is supplied as a Microsoft Installer package; if the Microsoft Installer system is not present on the machine, this part of the installation may fail. (The Microsoft Installer is available from the Microsoft web site.)

NOTE: On completion of Perl and Java installations, the ActiveState and Sun installers may prompt for a system reboot in order to complete configuration - this should not be performed until the whole Kit has been installed.

##### CodeWarrior plug-ins (optional)

If a CodeWarrior IDE for Symbian OS development is installed, the option to update its development plug-ins with Kit supplied versions will be offered. It is advised that this option is left checked - if the Kit is supplying newer versions than those already present they will be installed - if the Kit is supplying older versions, the existing plug-ins will be left untouched.

NOTE: The "Space Required" and "Space Available" figures displayed at this point only refer to the space requirements of the Symbian OS Kit Installer and, if selected, the installers for the Java Runtime Environment and Perl. The install locations and space requirements for the Java Runtime Environment and Perl are determined by their own installers. The space requirements for the actual content of the Kit are dealt with by the Symbian OS Kit Installer.

#### Symbian OS Kit Installer

After the initial installation process, the Symbian OS Kit Installer will be invoked to manage the selection and installation of the component packages that form the Kit's contents.

##### Package Selection

After clicking "Next" from the Kit Installer splash screen, a selectable list of the Kit's available installation packages will be displayed. Packages are ordered in a hierarchical fashion with 0 or more packages attached to high level categories. It is possible to select and de-select packages and whole categories at will - the OS Kit Installer will warn of any package dependency issues when "Next" is clicked.

##### Package Confirmation and Space Requirements

The OS Kit Installer will provide a list of the dependency compliant packages that have been selected for installation, together with an estimate of both the current space available on the destination folder's drive and the space available post-package installation.

NOTE: Due to differences in the files systems used by different variants of Windows, it is only possible to supply an estimate of the space available after installation. The actual figure may vary from that displayed.

##### Package Retrieval, License Agreements and Installation

After confirmation of package selection and acknowledgement of space requirements, the OS Kit Installer will retrieve the selected packages from the installation media. Should any of the selected packages have specific license requirements, these will be displayed post-retrieval and must be acknowledged for installation to continue. On license acknowledgement, the selected packages will be installed to the destination folder, and the OS Kit Installer will undertake any system configuration (menu items, environment variables etc.) they require.

### Kit Modification, Removal and Repair Process

The installed packages of a Symbian OS Kit can be modified by re-invoking the Symbian OS Kit Installer. To do this, go to "Start|Settings|Control Panel|Add/Remove Programs" and double-click the Kit's entry on the list. From the resultant dialog, select "Modify" and "Next >". The Symbian OS Kit Installer will be displayed and the same process used during installation can be repeated.

NOTE: When adding packages to a previously installed kit, the original media must be used from the same location i.e. if the base install was from a CD-ROM, subsequent package additions should be made using this CD-ROM from the original install drive.

To remove an entire Symbian OS Kit, follow the procedure for modification but select "Remove" from the dialog.

NOTE: The "Repair" option is currently not supported.