Series 40 6th Edition SDK, Feature Pack 1 Installation Guide · To install the Series 40 6th Edition SDK, Feature Pack 1: Forum.Nokia.com Series 40 6th Edition SDK, Feature Pack 1

F O R U M N O K I A

Series 40 6th Edition SDK, Feature Pack 1 InstallationGuide

Version Final; December 2nd, 2010

Contents1 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

Forum.Nokia.com

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 writtenpermission of Nokia is prohibited.

Nokia, Series 40 6th Edition SDK, Feature Pack 1 and the Nokia Connecting People logo are trademarks orregistered trademarks of Nokia Corporation. Other product and company names mentioned herein may betrademarks 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 andimprovements 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, NOWARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, ARE MADE IN RELATION TO THEACCURACY, RELIABILITY OR CONTENTS OF THIS DOCUMENT. NOKIA RESERVES THE RIGHT TO REVISE THISDOCUMENT 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 nearestto you.

Visit Forum Nokia (http://www.forum.nokia.com), the site designed for developers using technologiessupported by Nokia.

Forum.Nokia.com


http://www.OpenSSL.org/

http://www.OpenSSL.org/

http://www.forum.nokia.com

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 wirelesscontent looks and works when it is deployed to a Nokia mobile handset that complies with the Series 406th Edition Feature Pack 1 Platform.

The SDK is available for download from www.Forum.nokia.com.

Forum.Nokia.com


http://www.forum.nokia.com/

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 tothe 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 ExplanationCode Ph Text that you enter (as opposed to system prompts and

responses ) ; for example, file paths, commands, and programcode

Italic • Names of books and documents• New terminology

Bold Names of Windows menus, commands, buttons, and icons

URL Link Active Link

Forum.Nokia.com


4 Installing the SDK

4.1 System Requirements

Before installing the SDK, verify that you have the minimum hardware and software requirements listedbelow. With these minimum requirements, you can run the SDK as a standalone application. If you plan touse 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 useyour normal logon ID (the one you will use to run the SDK). At a minimum, you need administrator privilegesassigned temporarily for the installation.

4.1.1 Hardware Requirements

The hardware requirements to install and run the SDK as a standalone tool are:

Minimum Recommended

PC with a 1-GHz Pentium-class processor

512 MB of RAM

Display capable of displaying 16-bit colorat 1,024 x 768 pixel resolution

400 MB of available hard disk space

PC with a 2.8-GHz Pentium-class processor

2 GB of RAM

Display capable of displaying 24-bit color at 1,024 x768 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 channelfor every SDK instance you run. If you do not have enough channels, SDK instances that you start after yourun 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 fromwww.forum.nokia.com.

The SDK is available from Forum Nokia at no cost. If you are not a registered member of Forum Nokia, youneed to register (also at no cost) before you can download the SDK. Registration involves providing a username, password, and E-mail address.

Forum.Nokia.com



4.3 Running the SDK Installer

This section provides the basic steps for installing the SDK. By following the steps below you will install theSDK 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 6thEdition SDK, Feature Pack 1 takes place through the SDK Installer, that is, the InstallShield Wizard. Thefollowing will take you through the steps needed to install the SDK.

1 Start the SDK installation by running the installation executableS40_6th_Edition_SDK_FP1_installer_em.exe located in the SDK delivery ZIP file. The Installshieldwizard panel appears:

2 Click the Next button to continue.

The License Agreement dialog is displayed:

Forum.Nokia.com


Read the license agreement carefully

3 After reading (and accepting) the license agreement, click the I accept the terms of the licenseeagreement 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:

Forum.Nokia.com


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:

Forum.Nokia.com


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 installedwith any of the Series 40 SDK.

8 The NCF selected gets installed

Forum.Nokia.com


9 Click Finish to complete the NCF installation.

It continues with the SDK installation.

10 The Choose Destination Location dialog is displayed:

Forum.Nokia.com


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

Forum.Nokia.com


The SDK is now fully installed on your PC. You can verify this through the Windows Start menu by, forexample, 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 6thEdition 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:



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:

Forum.Nokia.com


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 SDKfrom within the IDE interface. For this information, see:

• Documentation for your IDE:

• www.eclipse.org

• www.netbeans.org



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 onForum Nokia.

To add additional languages to your SDK, go to Tools > Preferences > General tab, and select Downloadlanguages. This takes you to the Series 40 Platform SDKs' World Languages Packs download page on ForumNokia. After downloading the package, launch the installer and follow the on-screen instructions tocomplete the installation.

Forum.Nokia.com


http://www.eclipse.org/

http://netbeans.org/

http://www.forum.nokia.com/info/sw.nokia.com/id/88cbbdf6-8667-4c35-b083-78f986af436e/Series_40_Platform_SDKs_World_Languages.html


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 connectivitybetween SDKs. NCF is installed when you install the SDK. Because more than one SDK can use NCF forconnectivity, 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 6thEdition SDK, Feature Pack 1 and other SDKs or simulate Bluetooth connectivity between SDKs.

Forum.Nokia.com


http://www.forum.nokia.com/info/sw.nokia.com/id/8b7443ac-66ee-4d47-9f25-1da664b23c9c/Nokia_Connectivity_Framework_1_2.html

http://www.forum.nokia.com/info/sw.nokia.com/id/8b7443ac-66ee-4d47-9f25-1da664b23c9c/Nokia_Connectivity_Framework_1_2.html

6 What's Next?

If you plan to work within an IDE, you need to configure some of the supporting applications to work withthe 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 developmentoverview on page 17

• MIDlets (Java Application Descriptor (JAD) and Java ARchive (JAR) files) - Games or applications that canbe downloaded from the Internet and used on a mobile phone. See Configurations for MIDP developmentoverview on page 18.

For information about using the SDK, see Series 40 6th Edition SDK, Feature Pack 1 Help.

Forum.Nokia.com


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 anddirectly display it on the SDK. Some applications automatically detect the SDK as a device. You need toconfigure other applications to recognize the SDK before you can use the SDK from within the application’sinterface.

You need to configure the following content authoring applications for use with the Series 40 SDK. For moreinformation, 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 moreinformation 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 AdobeGoLive 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 (<SDKInstallation 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.

Forum.Nokia.com


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 anddirectly test it on the SDK. Some applications automatically detect the SDK as a device. You need to configureother 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 inMIDP 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 DeviceManagement to highlight it.

4 Click Import

Forum.Nokia.com


5 Click Browse , try to locate the <SDK Installed folder>. E.g. Series 40 6th Edition SDK, Feature Pack1 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 maywant to try different values. When the values are too small, the SDK freezes when you try to debug aMIDlet.

The window now looks like this:

Forum.Nokia.com


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.

Forum.Nokia.com


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:

Forum.Nokia.com


2 Click Add Platform ... . The Add Java Platform window appears:

Select the Java Micro Edition Platform Emulator radio button.

Forum.Nokia.com


3 Click Next. The IDE detects the available platforms. The available platforms are displayed in the right-side pane:

4 Confirm that the box next to this version of the Series 40 SDK Feature Pack 1 is checked and uncheck theboxes next to other SDKs.

5 Click Next. The chosen SDK and its details are displayed in the right-side pane at the bottom:

Forum.Nokia.com


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.

Forum.Nokia.com


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 Helpmenu.

Additional documents about this product and related technologies may also be available atwww.Forum.Nokia.com.

Forum.Nokia.com



9 Discussion about this resource

You can provide feedback, comments and suggestions about the SDK to Nokia and other SDK users usingthe Forum Nokia Developer Discussion Boards: http://discussion.forum.nokia.com/forum/

Forum.Nokia.com


http://discussion.forum.nokia.com/forum/

Documents

Series 40 6th Edition SDK, Feature Pack 1 Installation Guide · To install the Series 40 6th Edition SDK, Feature Pack 1: Forum.Nokia.com Series 40 6th Edition SDK, Feature Pack 1