|
1 <HTML> |
|
2 <TITLE>README and RELEASE NOTES for Symbian OS Binary Access Kits</TITLE> |
|
3 |
|
4 <H1>README for Symbian OS Binary Access Kits</H1> |
|
5 <H2>Copyright (c) Symbian Software Ltd 2002 - 2008. All rights reserved.</H2> |
|
6 |
|
7 <H3>Introduction</H3> |
|
8 <P>This file provides a pre-installation point of reference for |
|
9 Symbian OS Kit installation and configuration information.</P> |
|
10 |
|
11 <H3>System Requirements</H3> |
|
12 |
|
13 <UL> |
|
14 <H4>Hardware</H4> |
|
15 |
|
16 <P>A PC with the minimum of a Pentium 1GHz processor (or |
|
17 equivalent) and 512MB of RAM running Microsoft Windows |
|
18 2000 or Windows XP. Drive space requirements |
|
19 depend on the number and size of Kit packages selected for |
|
20 installation. However, the following can be considered |
|
21 as a guide :</P> |
|
22 |
|
23 <UL> |
|
24 <H5>Symbian OS Development Kit Drive Space Requirements</H5> |
|
25 |
|
26 <P>500 MB in Temp directory for installation runtime, |
|
27 in addition to the following for a full installation :</P> |
|
28 |
|
29 <P>-Windows 2000/XP : 1.5 GB</P> |
|
30 </UL> |
|
31 |
|
32 <P>NOTE: Although a Symbian OS Kit may install and run on a |
|
33 system that is less powerful than the recommended |
|
34 specification, performance may be unacceptable for |
|
35 development purposes.</P> |
|
36 |
|
37 <P>To run and debug OS components and applications on target |
|
38 hardware a compatible reference board or target device |
|
39 is required.</P> |
|
40 |
|
41 <P>The following hardware reference boards are currently |
|
42 supported :</P> |
|
43 |
|
44 <UL> |
|
45 <LI>Intel DBPXA255</LI> |
|
46 <LI>Intel DBPXA250</LI> |
|
47 </UL> |
|
48 </UL> |
|
49 |
|
50 <UL> |
|
51 <H4>Software</H4> |
|
52 |
|
53 <P>For OS component and application development using an |
|
54 emulator, Metrowerks CodeWarrior Development Tools for |
|
55 Symbian OS Professional Edition is required.</P> |
|
56 |
|
57 <P>To browse the Symbian Developer Library, a web browser |
|
58 supporting tables is needed.</P> |
|
59 </UL> |
|
60 |
|
61 |
|
62 <H3>Starting Kit Installation</H3> |
|
63 |
|
64 <UL> |
|
65 <P>Symbian OS Kits have a comprehensive installation mechanism. |
|
66 If installing from CD-ROM, this should run automatically on |
|
67 disc insertion. However, if installation fails to begin :</P> |
|
68 |
|
69 <UL> |
|
70 <LI>ensure you have administrative privileges if running Windows NT or 2000<BR><BR></LI> |
|
71 |
|
72 <LI>select "Start|Run"</LI> |
|
73 <LI>enter "<CD-ROM DRIVE>\setup.exe " into the "Open" field</LI> |
|
74 <LI>click "OK"</LI> |
|
75 </UL> |
|
76 |
|
77 <P>If installing from a network, the root location of the Kit |
|
78 image must first be mapped to a drive on the target system - |
|
79 double-clicking the "setup.exe" on this drive will invoke |
|
80 the installation process.</P> |
|
81 |
|
82 </UL> |
|
83 |
|
84 |
|
85 <H3>Kit Installation Process</H3> |
|
86 |
|
87 <UL> |
|
88 <H4>Destination Location</H4> |
|
89 |
|
90 <P>On acceptance of the Kit license agreement, the |
|
91 installation mechanism will prompt for a destination folder |
|
92 - this is the root location to where the main Kit contents |
|
93 will eventually be copied via the Symbian OS Kit Installer.<P> |
|
94 |
|
95 <H4>Select Components</H4> |
|
96 |
|
97 <P>There are two mandatory, and two optional, installations |
|
98 that are made prior to selecting specific Symbian OS Kit |
|
99 components to install.</P> |
|
100 |
|
101 <UL> |
|
102 |
|
103 <H5>Symbian OS Kit Installer (mandatory)</H5> |
|
104 |
|
105 <P>A utility for managing the installation of Symbian Kit |
|
106 components - launched automatically as part of the |
|
107 initial installation process. This is the means by which |
|
108 the various component packages that form a Symbian OS Kit |
|
109 can be selected, installed, maintained and removed.</P> |
|
110 |
|
111 <H5>Java Runtime Environment (mandatory)</H5> |
|
112 |
|
113 <P>The Sun Java runtime required to run both the Symbian OS |
|
114 Kit Installer and a range of GUI developer tools that may |
|
115 be offered for installation. This Java runtime is of a |
|
116 specific version to support the installer and these tools |
|
117 - it is a mandatory requirement of Kit installation that |
|
118 this version is installed.</P> |
|
119 |
|
120 <P>NOTE: The Java Runtime Environment will not install and |
|
121 run successfully on a system running at less than a 256 |
|
122 colour depth.</P> |
|
123 |
|
124 <P>NOTE: The version currently specified and supplied is |
|
125 1.3.1 build 01. This is detected in the registry as key |
|
126 "HKLM\SOFTWARE\JavaSoft\Java Runtime Environment\1.3.1".</P> |
|
127 |
|
128 <H5>Perl (optional)</H5> |
|
129 |
|
130 <P>ActiveState Perl is required by the majority of Symbian |
|
131 developer tools. This interpreter is of a specific |
|
132 version to support these developer tools. If the Kit |
|
133 installation is for development, and the required version |
|
134 of Perl (or later) is not installed, it is recommended |
|
135 that this option is left checked.</P> |
|
136 |
|
137 <P>NOTE: Perl is supplied as a Microsoft Installer package; |
|
138 if the Microsoft Installer system is not present on the |
|
139 machine, this part of the installation may fail. (The |
|
140 Microsoft Installer is available from the Microsoft web |
|
141 site.) |
|
142 |
|
143 <P>NOTE: On completion of Perl and Java installations, the |
|
144 ActiveState and Sun installers may prompt for a system |
|
145 reboot in order to complete configuration - this should |
|
146 not be performed until the whole Kit has been installed.</P> |
|
147 |
|
148 <H5>CodeWarrior plug-ins (optional)</H5> |
|
149 |
|
150 <P>If a CodeWarrior IDE for Symbian OS development is |
|
151 installed, the option to update its development plug-ins |
|
152 with Kit supplied versions will be offered. It is advised |
|
153 that this option is left checked - if the Kit is supplying |
|
154 newer versions than those already present they will be |
|
155 installed - if the Kit is supplying older versions, the |
|
156 existing plug-ins will be left untouched.</P> |
|
157 </UL> |
|
158 |
|
159 <P>NOTE: The "Space Required" and "Space Available" figures |
|
160 displayed at this point only refer to the space requirements |
|
161 of the Symbian OS Kit Installer and, if selected, the |
|
162 installers for the Java Runtime Environment and Perl. The |
|
163 install locations and space requirements for the Java |
|
164 Runtime Environment and Perl are determined by their own |
|
165 installers. The space requirements for the actual content |
|
166 of the Kit are dealt with by the Symbian OS Kit Installer.</P> |
|
167 |
|
168 |
|
169 <H4>Symbian OS Kit Installer</H4> |
|
170 |
|
171 <P>After the initial installation process, the Symbian OS Kit |
|
172 Installer will be invoked to manage the selection and |
|
173 installation of the component packages that form the Kit's |
|
174 contents.</P> |
|
175 |
|
176 <UL> |
|
177 |
|
178 <H5>Package Selection</H5> |
|
179 |
|
180 <P>After clicking "Next" from the Kit Installer splash screen, |
|
181 a selectable list of the Kit's available installation |
|
182 packages will be displayed. Packages are ordered in a |
|
183 hierarchical fashion with 0 or more packages attached to |
|
184 high level categories. It is possible to select and |
|
185 de-select packages and whole categories at will - the OS |
|
186 Kit Installer will warn of any package dependency issues |
|
187 when "Next" is clicked.</P> |
|
188 |
|
189 <H5>Package Confirmation and Space Requirements</H5> |
|
190 |
|
191 <P>The OS Kit Installer will provide a list of the dependency |
|
192 compliant packages that have been selected for |
|
193 installation, together with an estimate of both the |
|
194 current space available on the destination folder's drive |
|
195 and the space available post-package installation.</P> |
|
196 |
|
197 <P>NOTE: Due to differences in the files systems used by |
|
198 different variants of Windows, it is only possible to |
|
199 supply an estimate of the space available after |
|
200 installation. The actual figure may vary from that |
|
201 displayed.</P> |
|
202 |
|
203 <H5>Package Retrieval, License Agreements and Installation</H5> |
|
204 |
|
205 <P>After confirmation of package selection and |
|
206 acknowledgement of space requirements, the OS Kit |
|
207 Installer will retrieve the selected packages from the |
|
208 installation media. Should any of the selected packages |
|
209 have specific license requirements, these will be |
|
210 displayed post-retrieval and must be acknowledged for |
|
211 installation to continue. On license acknowledgement, |
|
212 the selected packages will be installed to the destination |
|
213 folder, and the OS Kit Installer will undertake any system |
|
214 configuration (menu items, environment variables etc.) |
|
215 they require.</P> |
|
216 </UL> |
|
217 </UL> |
|
218 |
|
219 |
|
220 <H3>Kit Modification, Removal and Repair Process</H3> |
|
221 |
|
222 <UL> |
|
223 <P>The installed packages of a Symbian OS Kit can be modified by |
|
224 re-invoking the Symbian OS Kit Installer. To do this, go to |
|
225 "Start|Settings|Control Panel|Add/Remove Programs" and |
|
226 double-click the Kit's entry on the list. From the resultant |
|
227 dialog, select "Modify" and "Next >". The Symbian OS Kit |
|
228 Installer will be displayed and the same process used during |
|
229 installation can be repeated.</P> |
|
230 |
|
231 <P>NOTE: When adding packages to a previously installed kit, the |
|
232 original media must be used from the same location i.e. if |
|
233 the base install was from a CD-ROM, subsequent package |
|
234 additions should be made using this CD-ROM from the original |
|
235 install drive.</P> |
|
236 |
|
237 <P>To remove an entire Symbian OS Kit, follow the procedure for |
|
238 modification but select "Remove" from the dialog.</P> |
|
239 |
|
240 <P>NOTE: The "Repair" option is currently not supported.</P> |
|
241 </UL> |
|
242 |
|
243 </HTML> |
|
244 |