User manual FOSSIL OS20

[. . . ] Disclaimer The information in this document is provided "as is, " with no warranties whatsoever, including any warranty of merchantability, fitness for any particular purpose, or any warranty otherwise arising out of any proposal, specification, or sample. Nokia Corporation disclaims all liability, including liability for infringement of any proprietary rights, relating to implementation of information presented in this document. Nokia Corporation does not warrant or represent that such use will not infringe such rights. Nokia Corporation retains the right to make changes to this document at any time, without notice. [. . . ] 6 3. 1. 1 ActivePerl installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . · Active Perl version 5. 6. 1 (see Section 3. 1. 1 "ActivePerl installation" for details); - 'perl -v' command can be used to find existing perl versions · Java Runtime version 1. 5. 0 (see Section 3. 1. 2 "Java Run-Time installation" for details); -'java -version' command can be used to find existing java versions · ARM RVCT compiler 2. 2 build 593 or newer is supported for ARMV5 compilation. The following operating systems are supported: · Microsoft Windows XP Professional SP2 · Microsoft Windows Vista Business (For limitations refer to release notes) 2. 3 Additional Installation Requirements · All installations must be performed using an administrator account. · The SDK must be installed in a path that does not contain any whitespace characters. · The SDK, IDE and your project files must be located on the same logical drive as build tools to work correctly in all situations. Version 1. 0 | January 2nd, 2009 OS20 5th Edition SDK Installation Guide | 6 3 Installing the SDK 3. 1 Prerequisites Before installing the SDK you should have installed and configured: · Perl (see Section 3. 1. 1 "ActivePerl installation" for details) · Java (see Section 3. 1. 2 "Java Run-Time installation" for details) · All peripherals you are going to use (see Appendix B: Supported Accessories on page 22) All installations should be performed with an account that belongs to local administrators group. You should close all other applications before starting the installer. 3. 1. 1 ActivePerl installation ActivePerl 5. 6. 1 is required and must be installed before installing this SDK. ActivePerl must be installed on your computer with administrator rights. 3. 1. 2 Java Run-Time installation Java Run-Time (JRE) 1. 5. 0 is required to use emulator Preferences and other Java components. (JRE is included in J2SE. ) JRE must be installed on your computer with administrator rights. Otherwise the PATH environment variable is not set correctly. 3. 2 Running the SDK Installer This section provides the basic steps for installing the SDK. 5 The Choose Destination Location dialog is displayed: Figure 5: Choose Destination Location dialog Define your Eclipse installation directory by clicking Browse and then Next C++ users may skip this stage by clicking NEXT button, as JAVA documentation is not relevant for C++ developers Note: This dialog is only displayed if you selected the Typical installation option or selected IDE integration in the Custom installation. (If you want to modify the installation settings, click Back and modify them as needed. ) The SDK installation status is displayed in the Setup Status dialog: Version 1. 0 | January 2nd, 2009 OS20 5th Edition SDK Installation Guide | 11 Figure 6: Ready to Copy Files 7 The Start Copying Files dialog is displayed. The SDK installation status is displayed in the Setup Status dialog: Figure 7: Setup Status dialog 8 If you already have other SDKs installed on your PC, the InstallShield Wizard will prompt you to select one of them as the default SDK. Select the appropriate SDK in the following dialog and click Next. Version 1. 0 | January 2nd, 2009 OS20 5th Edition SDK Installation Guide | 12 Figure 8: Select default device dialog 9 If you do not have the CSL ARM Toolchain installed on your PC, the following dialog will appear, prompting you to install it: Figure 9: CSL ARM Toolchain installation prompt As the CSL ARM Toolchain contains for example the GCCE compiler needed to build OS20 applications for real devices, click Yes to the question and follow the instructions of the CSL ARM Toolchain installation wizard. The build script starts the make command that will both compile and link the application for the emulator. 7 If your environment has been set up correctly, the build goes through without errors and you can run the Hello World Basic application in the emulator by issuing the epoc command. (Notice that it may take a while for the emulator to open. ) The emulator starts and displays the application grid. To verify that the Hello World Basic application has been properly compiled and can be run on the emulator, do the following: · Use the five-way navigation key of the emulator to navigate to the Installed folder in the emulator's application grid. · Open the Installed folder by clicking the center of the five-way navigation key. · Once the Installed folder has been opened, use the five-way navigation key to locate the Hello World Basic application icon. · Open the Hello World Basic application by clicking the left soft key under Options and by selecting Open from the list of menu options that are displayed. [. . . ] Note: Always uninstall the SDK through the Add/Remove Programs application, as described above. However, if you have used the emulator prior to uninstalling the SDK there may remain some SDK-related files and folders in the C:\OS20\devices \OS20_5th_Edition_SDK_v1. 0 directory even after removing the SDK through the Add/Remove Programs application. These files and folders need to be removed manually by, for example, deleting them in the Windows Explorer. Version 1. 0 | January 2nd, 2009 OS20 5th Edition SDK Installation Guide | 18 7 Multiple SDKs on the Same Computer 7. 1 Multiple SDK instances on the same computer Installing multiple instances of the SDK is supported in the OS20 5th Edition SDK. To install additional instances of the SDK, follow normal installation steps, as described in Installing the SDK. [. . . ]