Nokia SDK 1.0 Beta for Java Installation Guide · 3 About Nokia Java SDK installation and configuration This guide describes how to install and configure the Nokia SDK for Java. Target

Nokia SDK 1.0 Beta for Java Installation GuideSpecification

3

This material, including documentation and any related computer programs, is protected by copyrightcontrolled by Nokia. All rights are reserved. Copying, including reproducing, storing, adapting or translating,any or all of this material requires the prior written consent of Nokia. This material also contains confidentialinformation, which may not be disclosed to others without the prior written consent of Nokia.

Version 3 APPROVED 16 Mar 2011COMPANY CONFIDENTIAL

1 (25)

Nokia SDK 1.0 Beta for Java Installation Guide Copyright © 2011 Nokia. All rights reserved.GUID-9B9E8A29-D908-4173-8CA3-052C85824B05

Contents1 Legal Notice .............................................................................................................................................................32 Nokia SDK for Java ...................................................................................................................................................43 About Nokia Java SDK installation and configuration .........................................................................................54 Installing the SDK ....................................................................................................................................................6

4.1 System Requirements.....................................................................................................................................64.1.1 Hardware Requirements........................................................................................................................64.1.2 Software Requirements .........................................................................................................................6

4.2 Downloading the SDK .....................................................................................................................................64.3 Running the SDK Installer...............................................................................................................................74.4 Integrating the SDK with an IDE..................................................................................................................12

4.4.1 Integrating the SDK with an IDE overview.........................................................................................124.4.2 Integrating the SDK with Eclipse IDE ..................................................................................................12

4.5 Running the installation wizard..................................................................................................................124.6 Launching the SDK ........................................................................................................................................13

4.6.1 Launching the SDK as a standalone application................................................................................134.6.2 Launching the SDK within an IDE ........................................................................................................13

4.7 Adding languages to the SDK user interface..............................................................................................135 Uninstalling the SDK..............................................................................................................................................14

5.1 Uninstalling the SDK .....................................................................................................................................145.2 Uninstalling Nokia Connectivity Framework .............................................................................................14

6 What's Next? ..........................................................................................................................................................157 Configuring your IDE for the SDK .........................................................................................................................16

7.1 Configuring for browser and message content development .................................................................167.1.1 Configurations for browser and message content development overview ...................................167.1.2 Configuring Adobe GoLive CS2 to display WML and XHTML ..............................................................167.1.3 Configuring Adobe Dreamweaver to display content on the SDK ...................................................16

7.2 Configuring for MIDP development.............................................................................................................177.2.1 Configurations for MIDP development overview...............................................................................177.2.2 Configuring Eclipse for the SDK ...........................................................................................................177.2.3 Configuring NetBeans for the SDK.......................................................................................................20

8 Developer Resources.............................................................................................................................................249 Discussion about this resource ............................................................................................................................25


2 (25)


1 Legal NoticeCopyright © Nokia 2011. All rights reserved.

This document is for use with the Nokia SDK 1.0 for Java. Reproduction, transfer, distribution or storage ofpart or all of the contents in this document in any form without the prior written permission of Nokia isprohibited.

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

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 THIS DOCUMENTOR 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.


3 (25)


http://www.OpenSSL.org/

http://www.OpenSSL.org/

http://www.forum.nokia.com

2 Nokia SDK for JavaThe Nokia SDK for Java is a development tool that lets you preview how wireless content and mobileapplication looks and works when it is deployed to a Nokia mobile handset.

The SDK is available for download from Forum Nokia (http://www.forum.nokia.com/).


4 (25)


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

3 About Nokia Java SDK installation and configurationThis guide describes how to install and configure the Nokia SDK for Java.

Target audienceThe guide is meant for developers who plan to create content and application for mobile phone handsetsthat conform to the Nokia SDK for Java.

ScopeThe help contains the following main sections:

• Installing the SDK:

• System Requirements (page 6)

• Downloading the SDK (page 6)

• Integrating the SDK to use with an IDE overview (page 12)

• Integrating the SDK to use with Eclipse IDE (page 12)

• Running the installation wizard (page 12)

• Launching the SDK (page 13)

• Adding languages to the SDK user interface (page 13)

• Uninstalling the SDK (page 14)

• What's Next? (page 15)

• Configuring your IDE for the SDK:

• Configuring for browser and message content development:

• Configurations for browser and message content development overview (page 16)

• Configuring Adobe GoLive CS2 to display WML and XHTML (page 16)

• Configuring Adobe Dreamweaver to display content on the SDK (page 16)

• Configuring for MIDP development:

• Configurations for MIDP development overview (page 17)

• Configuring Eclipse for the SDK (page 17)

• Configuring NetBeans for the SDK (page 20)

• Developer resources (page 24)

• Discussion about this resource (page 25)

This help uses the following typographical conventions:

Conversion Explanation

Code Ph Text that you enter (as opposed to system prompts and responses ) ;for example, file paths, commands, and program code

Italic • Names of books and documents

• New terminology

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

URL Link Active Link


5 (25)


4 Installing the SDK

4.1 System RequirementsBefore 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 use to run the SDK). At a minimum, you need administrator privilegesassigned temporarily for the installation.

4.1.1 Hardware RequirementsThe 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 color at1,024 x 768 pixel resolution

500 MB of available hard disk space

Network interface card

PC with a 2.8-GHz Pentium-class processor

2 GB of RAM

Display capable of displaying 24-bit color at 1,024 x 768pixel resolution

550 MB of available hard disk space

Sound card

If you plan to work with sound (from MIDlets, for example), you need a sound card that has one channel foreach SDK instance you run. If you do not have enough channels, SDK instances that you start after you runout of channels do not have sound.

4.1.2 Software RequirementsThe software requirements to install and run the SDK as a standalone tool are:

• Microsoft Windows 7 Enterprise Edition (32–bit and 64–bit)

• Microsoft Windows XP Professional Service Pack 3

You also need to install Java SE Runtime Environment (JRE) 6 or higher before you install the SDK.

4.2 Downloading the SDKBefore installing the SDK, you must first download the Nokia_SDK_1_0_Java.zip file from Forum Nokia(http://www.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.


6 (25)



4.3 Running the SDK InstallerThis section provides the basic steps for installing the SDK. By following the steps below you install the SDKto your PC and are able to start application development. Once you have downloaded the installation package(.zip file) on your PC, installing the Nokia SDK for Java takes place through the SDK Installer. The zip file containstwo types of installer files: Nokia_SDK_1_0_Java_installer_em.exe (online installer) andNokia_SDK_1_0_Java_installer_offline_em.exe (offline installer). The online installer needs aninternet connection for downloading the contents required for installation. The following takes you throughthe steps needed to install the SDK.

1 Start the SDK installation process by running the executable fileNokia_SDK_1_0_Java_installer_em.exe for online installation andNokia_SDK_1_0_Java_installer_offline_em.exe for offline installation.

The welcome widget appears :

2 Click the Next button to continue. The Installation Folder Widget appears. Specify the folder where youwant to install Nokia SDK for Java.


7 (25)


3 Click the Next button to continue. The Component Selection page is displayed. Please select thecomponents you want to install .

Note: At least one component must be selected for the installation to continue.

4 Click the Next button to continue. The license agreement dialog is displayed. Read the license agreementcarefully. After reading (and accepting) the license agreement, click the I have read and accept the licenseeagreement radio button and click Next.


8 (25)


5 Click Next to continue. The Start Menu shortcuts page is displayed. By default the page shows the NokiaDeveloper Tools shortcut

Note: The Names below are taken from C:\Documents and Settings\User\Start Menu\Programs and either of them can be selected as a start menu shortcut.

6 Click the Next button to continue. The Ready to Install page is displayed. Click Install to start theinstallation of the selected components.


9 (25)


7 Wait while the installation is in progress.


10 (25)


8 For offline installation, wait while the installation is in progress.

9 Installation Done. Click Finish to exit.


11 (25)


4.4 Integrating the SDK with an IDE

4.4.1 Integrating the SDK with an IDE overviewIn addition to using the SDK as a standalone tool, you can also use the SDK within an IDE. Nokia SDK for Javahas been tested with the following IDEs but may work with other IDEs as well:

• Adobe GoLive CS2

• Adobe Dreamweaver 9

• Eclipse Pulsar Helios

• Netbeans 6.9.1 or Later

For more information, see:



4.4.2 Integrating the SDK with an Eclipse IDETo use Eclipse pulsar with the SDK, install the applications below in the following order:

1 Java SE Development Kit (JDK)

2 Eclipse Pulsar Helios

3 Nokia SDK for Java

4.5 Running the installation wizardTo install the Nokia SDK for Java:

1 Verify that:


12 (25)


• Your system meets the hardware and software requirements. See System Requirements (page 6).

• You have installed supported applications in the correct order so the applications can find the SDK. SeeInstalling the SDK to use with an IDE overview (page 12).

2 Unzip the Nokia_SDK_1_0_Java.zip file.

3 Double-click Nokia_SDK_Java_1.0_installer_em.exe. The installation wizard starts theinstallation process.

The default directory is:

C:\Nokia\Devices\Nokia_SDK_1_0_Java

Note: You need to know the installation directory to integrate with other products such as an IDE.

4.6 Launching the SDKYou can launch the SDK as either a standalone application or within an IDE.

4.6.1 Launching the SDK as a standalone applicationTo launch the SDK standalone from Windows, select Start>Programs>Nokia Developer Tools>Nokia SDK 1.0for Java>emulator

4.6.2 Launching the SDK within an IDEYou 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:

• Eclipse (http://www.eclipse.org/)

• Netbeans (http://netbeans.org/)



4.7 Adding languages to the SDK user interfaceYou can view the SDK emulator content texts in several languages. These languages are listed in the Tools> Preferences > General tab. Language of Preference window and others cannot be changed.

The World Language Pack (supports 65 languages) is now integrated into the SDK.


13 (25)


http://www.eclipse.org/

http://netbeans.org/

5 Uninstalling the SDK

5.1 Uninstalling the SDKTo uninstall the SDK:

1 Select Start > Settings > Control Panel > Add or Remove Programs.

2 Select Nokia SDK for Java and select Remove.

5.2 Uninstalling the Nokia Connectivity FrameworkThe SDK simulates wireless connectivity technology between SDKs with Nokia Connectivity Framework (NCF)(http://www.forum.nokia.com/info/sw.nokia.com/id/8b7443ac-66ee-4d47-9f25-1da664b23c9c/Nokia_Connectivity_Framework_1_2.html), a supporting application that enables Short Message Service (SMS)and Bluetooth connectivity between SDKs. NCF is installed when you install the SDK. The NCF is not uninstalledwhen 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 Nokia SDK for Java andother SDKs or simulate Bluetooth connectivity between SDKs.


14 (25)


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 (page 16)

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

For information about using the SDK, see Nokia SDK 1.0 for Java Help.


15 (25)


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 overviewYou can work more efficiently by creating an IDE where you can develop content in an application and directlydisplay it on the SDK. Some applications automatically detect the SDK as a device. You need to configure otherapplications 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 SDK. For moreinformation, see:

• Configuring Adobe GoLive CS2 to display WML and XHTML (page 16)

• Configuring Adobe Dreamweaver to display content on the SDK (page 16)

For more information on installation, see documentation of the supporting application. For more informationon 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 XHTMLBy default, the WML module for content authoring is not accessible. You must add the module in Adobe GoLiveCS2 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 > WML Deck.

To add Nokia SDK 1.0 for Java 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 SDKTo 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 (+) toadd a browser.

3 From the Add Browser window, enter Nokia SDK 1.0 for Java as the name.


16 (25)


4 Click Browse. In the Select Browser dialog box, navigate to the location of the SDK executable file (<SDKInstallation 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. Thecontent 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 overviewYou can work more efficiently by creating an IDE where you can develop a MIDlet in an application and directlytest it on the SDK.

Some IDEs automatically detect the SDK as a device. You need to configure other IDEs to recognize the SDKbefore you can start the SDK from within the application’s interface.

You need to configure the MIDP development applications to use the SDK. For more information, see:

• Configuring Eclipse for the SDK (page 17)

• Configuring NetBeans for the SDK (page 20)

For more information on installation, see IDE documentation. For more information on using the SDK in MIDPdevelopment, see Overview to creating and testing MIDlets with the SDK in the SDK Help..

7.2.2 Configuring Eclipse for the SDKTo 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 tohighlight it.

4 Click Import


17 (25)


5 Click Browse , try to locate the <SDK Installed folder>-. For example, Nokia SDK 1.0 for Java and clickFinish.

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.


18 (25)


The window now looks like this:

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 and press OK.


19 (25)


7.2.3 Configuring NetBeans for the SDKTo configure the SDK with Netbeans with Mobility Pack:

1 In the NetBeans main window, select Tools > Java Platform Manager.

The following Java Platform Manager window appears:


20 (25)


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

Select the Java Micro Edition Platform Emulator radio button.


21 (25)


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

4 Confirm that the box next to this version of the Nokia SDK 1.0 for Java is checked and uncheck the boxesnext to other SDKs.

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


22 (25)


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.


23 (25)


8 Developer ResourcesThe following documents contain additional information about the SDK:

• Nokia SDK 1.0 for Java Help

• Nokia SDK 1.0 for Java 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 at Forum Nokia(http://www.forum.nokia.com/).


24 (25)



9 Discussion about this resourceYou can provide feedback, comments and suggestions about the SDK to Nokia and other SDK users using theForum Nokia Developer Discussion Boards: http://discussion.forum.nokia.com/forum/.


25 (25)


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