Series 40 6th Edition SDK, Feature Pack 1 Installation Guide

F O R U M N O K I A Series 40 6th Edition SDK, Feature Pack 1 Installation Guide Version Final; December 2nd, 2010

Contents 1 Legal Notice...3 2 Series 40 6th Edition SDK, Feature Pack 1...4 3 About Series 40 6th Edition SDK, Feature Pack 1 installation and configuration...5 4 Installing the SDK...6 4.1 System Requirements...6 4.1.1 Hardware Requirements...6 4.1.2 Software Requirements...6 4.2 Downloading the SDK...6 4.3 Running the SDK Installer...7 4.4 Installing the SDK to use with an IDE...13 4.4.1 Installing the SDK to use with an IDE overview...13 4.4.2 Installing the SDK to use with Eclipse IDE...13 4.5 Running the installation wizard...13 4.6 Launching the SDK...14 4.6.1 Launching the SDK as a standalone application...14 4.6.2 Launching the SDK within an IDE...14 4.7 Adding languages to the SDK user interface...14 5 Uninstalling the SDK...15 5.1 Uninstalling the SDK...15 5.2 Uninstalling Nokia Connectivity Framework...15 6 What's Next?...16 7 Configuring your IDE for the SDK...17 7.1 Configuring for browser and message content development...17 7.1.1 Configurations for browser and message content development overview...17 7.1.2 Configuring Adobe GoLive CS2 to display WML and XHTML...17 7.1.3 Configuring Adobe Dreamweaver to display content on the SDK...17 7.2 Configuring for MIDP development...18 7.2.1 Configurations for MIDP development overview...18 7.2.2 Configuring Eclipse for the SDK...18 7.2.3 Configuring NetBeans for the SDK...21 8 Developer Resources...25 9 Discussion about this resource...26 Series 40 6th Edition SDK, Feature Pack 1 Installation Guide 2

1 Legal Notice Copyright Nokia 2010. All rights reserved. This document is for use with the Series 40 6th Edition SDK, Feature Pack 1. Reproduction, transfer, distribution or storage of part or all of the contents in this document in any form without the prior written permission of Nokia is prohibited. Nokia, Series 40 6th Edition SDK, Feature Pack 1 and the Nokia Connecting People logo are trademarks or registered trademarks of Nokia Corporation. Other product and company names mentioned herein may be trademarks or trade names of their respective owners. Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit (http:// www.openssl.org/). Nokia operates a policy of on-going development. Nokia reserves the right to make changes and improvements to any of the products described in this document without prior notice. UNDER NO CIRCUMSTANCES SHALL NOKIA BE RESPONSIBLE FOR ANY LOSS OF DATA OR INCOME OR ANY SPECIAL, INCIDENTAL, CONSEQUENTIAL OR INDIRECT DAMAGES HOWSOEVER CAUSED. THE CONTENTS OF THIS DOCUMENT ARE PROVIDED "AS IS". EXCEPT AS REQUIRED BY APPLICABLE LAW, NO WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, ARE MADE IN RELATION TO THE ACCURACY, RELIABILITY OR CONTENTS OF THIS DOCUMENT. NOKIA RESERVES THE RIGHT TO REVISE THIS DOCUMENT OR WITHDRAW IT AT ANY TIME WITHOUT PRIOR NOTICE. The availability of particular phone products may vary by region. Please check with the Nokia dealer nearest to you. Visit Forum Nokia (http://www.forum.nokia.com), the site designed for developers using technologies supported by Nokia. Series 40 6th Edition SDK, Feature Pack 1 Installation Guide 3

2 Series 40 6th Edition SDK, Feature Pack 1 The Series 40 6th Edition SDK, Feature Pack 1 is a development tool that lets you preview how wireless content looks and works when it is deployed to a Nokia mobile handset that complies with the Series 40 6th Edition Feature Pack 1 Platform. The SDK is available for download from www.forum.nokia.com. Series 40 6th Edition SDK, Feature Pack 1 Installation Guide 4

3 About Series 40 6th Edition SDK, Feature Pack 1 installation and configuration This guide describes how to install and configure the Series 40 6th Edition SDK, Feature Pack 1. Target audience The guide is meant for developers who plan to create content for mobile phone handsets that conform to the Series 40 6th Edition SDK, Feature Pack 1. Scope The help contains the following main sections: Installing the SDK: System Requirements on page 6 Downloading the SDK on page 6 Installing the SDK to use with an IDE overview on page 13 Installing the SDK to use with Eclipse IDE on page 13 Running the installation wizard on page 13 Launching the SDK on page 14 Adding languages to the SDK user interface on page 14 Uninstalling the SDK on page 15 Uninstalling Nokia Connectivity Framework on page 15 What's Next? on page 16 Configuring your IDE for the SDK: Configuring for browser and message content development: Configurations for browser and message content development overview on page 17 Configuring Adobe GoLive CS2 to display WML and XHTML on page 17 Configuring Adobe Dreamweaver to display content on the SDK on page 17 Configuring for MIDP development: Configurations for MIDP development overview on page 18 Configuring Eclipse for the SDK on page 18 Configuring NetBeans for the SDK on page 21 Developer resources on page 25 Discussion about this resource on page 26 This help uses the following typographical conventions: Conversion Code Ph Italic Bold URL Link Explanation Text that you enter (as opposed to system prompts and responses ) ; for example, file paths, commands, and program code Names of books and documents New terminology Names of Windows menus, commands, buttons, and icons Active Link Series 40 6th Edition SDK, Feature Pack 1 Installation Guide 5

4 Installing the SDK 4.1 System Requirements Before installing the SDK, verify that you have the minimum hardware and software requirements listed below. With these minimum requirements, you can run the SDK as a standalone application. If you plan to use the SDK within an IDE, make sure you also have the requirements mandated by the IDE. To install the SDK properly, you must have administrator privileges on your computer. Also, be sure to use your normal logon ID (the one you will use to run the SDK). At a minimum, you need administrator privileges assigned temporarily for the installation. 4.1.1 Hardware Requirements The hardware requirements to install and run the SDK as a standalone tool are: Minimum PC with a 1-GHz Pentium-class processor 512 MB of RAM Display capable of displaying 16-bit color at 1,024 x 768 pixel resolution 400 MB of available hard disk space Recommended PC with a 2.8-GHz Pentium-class processor 2 GB of RAM Display capable of displaying 24-bit color at 1,024 x 768 pixel resolution 450 MB of available hard disk space Sound card If you plan to work with sound (from MIDlets, for instance), you need a sound card that has one channel for every SDK instance you run. If you do not have enough channels, SDK instances that you start after you run out of channels will not have sound. 4.1.2 Software Requirements The Software requirements to install and run the SDK as a standalone tool are: Microsoft Windows XP Professional Service Pack 3 Microsoft Windows 7 Enterprise Edition You also need to install Java SE Runtime Environment (JRE) 6 or higher before you install the SDK.. 4.2 Downloading the SDK Before installing the SDK, you must first download the Series_40_6th_Edition_SDK_FP1.zip file from www.forum.nokia.com. The SDK is available from Forum Nokia at no cost. If you are not a registered member of Forum Nokia, you need to register (also at no cost) before you can download the SDK. Registration involves providing a user name, password, and E-mail address. Series 40 6th Edition SDK, Feature Pack 1 Installation Guide 6

4.3 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 Series 40 6th Edition SDK, Feature Pack 1 takes place through the SDK Installer, that is, the InstallShield Wizard. The following will take you through the steps needed to install the SDK. 1 Start the SDK installation by running the installation executable S40_6th_Edition_SDK_FP1_installer_em.exe located in the SDK delivery ZIP file. The Installshield wizard panel appears: 2 Click the Next button to continue. The License Agreement dialog is displayed: Series 40 6th Edition SDK, Feature Pack 1 Installation Guide 7

Read the license agreement carefully 3 After reading (and accepting) the license agreement, click the I accept the terms of the licensee agreement radio button and click Next. Note: If you do not accept the license agreement, installation of the SDK is canceled. 4 The Choose Destination Location dialog is displayed: Series 40 6th Edition SDK, Feature Pack 1 Installation Guide 8

5 Review setting before copying files. 6 Click Next to start the SDK installation. The SDK installation status is displayed in the Setup Status dialog: Series 40 6th Edition SDK, Feature Pack 1 Installation Guide 9

7 Nokia Connectivity Framework (NCF) install shield starts : Click Next for the Installshield to install the NCF on your computer. Note: Nokia Connectivity Framework installation will not occur if you have already installed with any of the Series 40 SDK. 8 The NCF selected gets installed Series 40 6th Edition SDK, Feature Pack 1 Installation Guide 10

9 Click Finish to complete the NCF installation. It continues with the SDK installation. 10 The Choose Destination Location dialog is displayed: Series 40 6th Edition SDK, Feature Pack 1 Installation Guide 11

Define your Eclipse installation directory by clicking Browse and then Next. Note: You may also skip the Eclipse IDE document integration by clicking the Next button. 11 To complete the installation, click Finish in the Installation complete dialog Series 40 6th Edition SDK, Feature Pack 1 Installation Guide 12

The SDK is now fully installed on your PC. You can verify this through the Windows Start menu by, for example, opening the SDK Help by selecting Start > All Programs > Nokia Developer Tools > SDKs > Series 40 > Series 40 6th Edition SDK, Feature Pack 1 > SDK Help. 4.4 Installing the SDK to use with an IDE 4.4.1 Installing the SDK to use with an IDE overview In addition to using the SDK as a standalone tool, you can also use the SDK within an IDE. Series 40 6th Edition SDK, Feature Pack 1 has been tested with the following IDEs but may work with other IDEs as well: Adobe GoLive CS2 Adobe Dreamweaver 8 Eclipse pulsar Galileo Netbeans 6.8 or Later For more information, see: Configurations for browser and message content development overview on page 17 Configurations for MIDP development overview on page 18 4.4.2 Installing the SDK to use with an Eclipse IDE To use Eclipse pulsar with the SDK, install the applications below in the following order: 1 Java SE Development Kit (JDK) 2 Eclipse Pulsar Galileo 3 Series 40 6th Edition SDK, Feature Pack 1 4.5 Running the installation wizard To install the Series 40 6th Edition SDK, Feature Pack 1: Series 40 6th Edition SDK, Feature Pack 1 Installation Guide 13

1 Verify that: Your system meets the hardware and software requirements. See System Requirements on page 6. You have installed supported applications in the correct order so the applications can find the SDK. See Installing the SDK to use with an IDE overview on page 13. 2 Unzip the.zip file. 3 Double-click S40_6th_Edition_SDK_FP1.exe. The installation wizard starts the installation process. The default directory is: C:\Nokia\Devices\S40_6th_Edition_SDK_FP1. Note: You need to know the installation directory to integrate with other products such as an IDE. 4.6 Launching the SDK You can launch the SDK as either a standalone application or within an IDE. 4.6.1 Launching the SDK as a standalone application To launch the SDK standalone from Windows, select Start > Programs > Nokia Developer Tools > SDKs > Series 40 > Series 40 6th Edition SDK, FP1> Emulator. 4.6.2 Launching the SDK within an IDE You must configure some IDEs to recognize the SDK as a supported device before you can launch the SDK from within the IDE interface. For this information, see: Documentation for your IDE: www.eclipse.org www.netbeans.org Configurations for browser and message content development overview on page 17 Configurations for MIDP development overview on page 18 4.7 Adding languages to the SDK user interface You can view the SDK user interface in several languages. These languages are listed in the Tools > Preferences > General tab. To view the SDK user interface in additional languages, you must add the World Language pack to the SDK. The World Languages are available for free from Series 40 Platform SDKs World Languages Packs page on Forum Nokia. To add additional languages to your SDK, go to Tools > Preferences > General tab, and select Download languages. This takes you to the Series 40 Platform SDKs' World Languages Packs download page on Forum Nokia. After downloading the package, launch the installer and follow the on-screen instructions to complete the installation. Series 40 6th Edition SDK, Feature Pack 1 Installation Guide 14

5 Uninstalling the SDK 5.1 Uninstalling the SDK To uninstall the SDK: 1 Select Start > Settings > Control Panel > Add or Remove Programs. 2 Select Series 40 6th Edition SDK, Feature Pack 1 and select Remove. Note: Uninstalling the SDK automatically uninstalls the World Languages, if you have added them. You cannot uninstall the World Languages separately. 5.2 Uninstalling Nokia Connectivity Framework The SDK simulates wireless connectivity technology between SDKs with Nokia Connectivity Framework (NCF), a supporting application that enables Short Message Service (SMS) and Bluetooth connectivity between SDKs. NCF is installed when you install the SDK. Because more than one SDK can use NCF for connectivity, NCF is not uninstalled when you uninstall the SDK. To uninstall NCF : 1 Select Start > Settings > Control Panel > Add or Remove Programs. 2 Select Nokia Connectivity Framework and select Remove. Note: Be aware that without NCF, you cannot send SMS messages between the Series 40 6th Edition SDK, Feature Pack 1 and other SDKs or simulate Bluetooth connectivity between SDKs. Series 40 6th Edition SDK, Feature Pack 1 Installation Guide 15

6 What's Next? If you plan to work within an IDE, you need to configure some of the supporting applications to work with the SDK. To prepare an IDE in which to create: Browser and message content - Web content designed to be displayed on a mobile phone, such as DRM, MMS, WML, and XHTML content. See Configurations for browser and message content development overview on page 17 MIDlets (Java Application Descriptor (JAD) and Java ARchive (JAR) files) - Games or applications that can be downloaded from the Internet and used on a mobile phone. See Configurations for MIDP development overview on page 18. For information about using the SDK, see Series 40 6th Edition SDK, Feature Pack 1 Help. Series 40 6th Edition SDK, Feature Pack 1 Installation Guide 16

7 Configuring your IDE for the SDK 7.1 Configuring for browser and message content development 7.1.1 Configurations for browser and message content development overview You can work more efficiently by creating an IDE where you can develop content in an application and directly display it on the SDK. Some applications automatically detect the SDK as a device. You need to configure other applications to recognize the SDK before you can use the SDK from within the application s interface. You need to configure the following content authoring applications for use with the Series 40 SDK. For more information, see: Configuring Adobe GoLive CS2 to display WML and XHTML on page 17 Configuring Adobe Dreamweaver to display content on the SDK on page 17 For more information on installation, see documentation of the supporting application. For more information on developing content with the SDK, see the following sections in the SDK Help: Overview to using the SDK for message content development MMS messages overview DRM messages overview SMS messages overview 7.1.2 Configuring Adobe GoLive CS2 to display WML and XHTML By default, the WML module for content authoring is not accessible. You must add the module in Adobe GoLive CS2 preferences before you configure Adobe GoLive CS2 to recognize the SDK as a browser. To configure Adobe GoLive CS2 so you can create a new WML file using a standard WML template: 1 Select Edit > Preferences. 2 On the right panel, select Modules. 3 On the left panel, navigate to the bottom of the list to the Extend Scripts folder and check WML. 4 Click OK. To create a new WML file, select File > New Special > WML Deck. To add Series 40 6th Edition SDK, Feature Pack 1 as a recognized browser to Adobe GoLive CS2: 1 Select Edit > Preferences. 2 On the right panel, select Browser. 3 Click Add. The Choose Browser dialog box appears. 4 In the Choose Browser dialog box, navigate to the location of the SDK executable file (<SDK Installation directory>\bin\emulator.exe) and click OK. To display a WML or XHTML file within GoLive s content editor on the SDK, select File > Preview In > emulator.exe. 7.1.3 Configuring Adobe Dreamweaver to display content on the SDK To configure Adobe Dreamweaver to display content on the SDK: 1 From the Dreamweaver main window, select Edit/Preferences. The Preferences window appears. 2 On the Category column of the Preferences window, click Preview in Browser. Click the plus sign (+) to add a browser. Series 40 6th Edition SDK, Feature Pack 1 Installation Guide 17

3 From the Add Browser window, enter Series 40 6th Edition SDK, Feature Pack 1 as the name. 4 Click Browse. In the Select Browser dialog box, navigate to the location of the SDK executable file (<SDK Installation Directory>\bin\emulator.exe). 5 Optionally, select the Primary browser checkbox to set the SDK as the primary browser. Click OK. 6 From the Add Browser window, click OK. 7 From the Preferences window, click OK. You can develop content on Dreamweaver and display it on the SDK by selecting the SDK as the browser. The content type must be supported both by Dreamweaver and the SDK. For more information, see Adobe Dreamweaver documentation. 7.2 Configuring for MIDP development 7.2.1 Configurations for MIDP development overview You can work more efficiently by creating an IDE where you can develop a MIDlet in an application and directly test it on the SDK. Some applications automatically detect the SDK as a device. You need to configure other applications to recognize the SDK before you can start the SDK from within the application s interface. You need to configure the MIDP development applications to use the Series 40 SDK. For more information, see: Configuring Eclipse for the SDK on page 18 Configuring NetBeans for the SDK on page 21 For more information on installation, see IDE documentation. For more information on using the SDK in MIDP development, see Overview to creating and testing MIDlets with the SDK in the SDK Help.. 7.2.2 Configuring Eclipse for the SDK To configure Eclipse to recognize the SDK: 1 Run eclipse.exe. 2 From the Eclipse main window, select Window > Preferences.... The Preference window appears. 3 On the left column of the Preference window, click Java ME to expand it. Click Device Management to highlight it. 4 Click Import Series 40 6th Edition SDK, Feature Pack 1 Installation Guide 18

5 Click Browse, try to locate the <SDK Installed folder>. E.g. Series 40 6th Edition SDK, Feature Pack 1 and click Finish. 6 To save the definitions, click Ok 7 From the Eclipse main window, select Window > Preferences.... The Preference window appears. 8 On the left column of the Preference window, click Java to expand it. Click Debug to highlight it. 9 On the right side of the panel, de-select all the options under Suspend Execution. 10 On the right side of the panel under the Communication section, complete the following fields: Field Enter Debugger timeout (ms) 30000 Launch timeout (ms) 20000 The values you enter can be greater or smaller, depending on the speed of your computer. You may want to try different values. When the values are too small, the SDK freezes when you try to debug a MIDlet. The window now looks like this: Series 40 6th Edition SDK, Feature Pack 1 Installation Guide 19

11 On the left-side pane of the Preferences window, click Compiler. 12 Select Use default compliance settings. 13 In Classfile Generation section, select the options as shown in figure below. Series 40 6th Edition SDK, Feature Pack 1 Installation Guide 20

7.2.3 Configuring NetBeans for the SDK To configure the Series 40 SDK with Netbeans with Mobility Pack: 1 In the NetBeans main window, select Tools > Java Platform Manager. The following Java Platform Manager window appears: Series 40 6th Edition SDK, Feature Pack 1 Installation Guide 21

2 Click Add Platform.... The Add Java Platform window appears: Select the Java Micro Edition Platform Emulator radio button. Series 40 6th Edition SDK, Feature Pack 1 Installation Guide 22

3 Click Next. The IDE detects the available platforms. The available platforms are displayed in the rightside pane: 4 Confirm that the box next to this version of the Series 40 SDK Feature Pack 1 is checked and uncheck the boxes next to other SDKs. 5 Click Next. The chosen SDK and its details are displayed in the right-side pane at the bottom: Series 40 6th Edition SDK, Feature Pack 1 Installation Guide 23

6 Click Finish. The SDK is added to the Platforms field in the Java Platform Manager window. 7 Click Close to close the Java Platform Manager window. Series 40 6th Edition SDK, Feature Pack 1 Installation Guide 24

8 Developer Resources The following documents contain additional information about the SDK: Series 40 6th Edition SDK, Feature Pack 1 Help Series 40 6th Edition SDK, Feature Pack 1 Release Notes These documents are available in the doc directory of the SDK installation directory or using the SDK Help menu. Additional documents about this product and related technologies may also be available at www.forum.nokia.com. Series 40 6th Edition SDK, Feature Pack 1 Installation Guide 25

9 Discussion about this resource You can provide feedback, comments and suggestions about the SDK to Nokia and other SDK users using the Forum Nokia Developer Discussion Boards: http://discussion.forum.nokia.com/forum/ Series 40 6th Edition SDK, Feature Pack 1 Installation Guide 26