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. This document is provided for informational purposes only. 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. [. . . ] 3. 1. 1 ActivePerl installation ActivePerl 5. 6. 1 is required and must be installed before installing this SDK. You can download ActivePerl from the ActivePerl pages. See ActivePerl documentation for installation instructions. ActivePerl must be installed on your computer with administrator rights. Otherwise the PATH environment variable is not set correctly. 3. 1. 2 Java Run-Time installation Java Run-Time (JRE) 1. 5. 0 is required to use emulator Preferences and other Java components. Java Run-time can be downloaded from Sun Developer Network Downloads. (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. By following the steps below you will install the SDK to your PC and be able to start application development. Once you have downloaded the installation package (. zip file) on you PC, installing the OS20 SDK takes place through the SDK Installer, that is, the InstallShield Wizard. 6 The Ready to Copy Files dialog is displayed. Click Next to start the SDK 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. Click Next to start the SDK installation. 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. [. . . ] 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. Once an additional SDK has been installed, it is displayed in the Windows Start menu by, for example, opening the SDK Help by selecting Start > All Programs > OS20 Developer Tools > 5th Edition SDK > v1. 0 > SDK Documentation. [. . . ]