Nokia Asha SDK InstallationGuide

Document created on 19 Mar 2014Version 1.2.0

About SDK installationThis guide describes how to install Nokia Asha SDK 1.2. It also explains how to configure different IDEs(such as Nokia IDE for Java ME (Eclipse), Eclipse, and NetBeans) for Nokia Asha SDK 1.2.

Nokia Asha SDK 1.2 is a development tool that enables you to preview how mobile application looks andworks when it is deployed to a Nokia mobile handset.

The Nokia Asha SDK can be downloaded from the Nokia Developer website.

Target audienceThis guide is intended for developers who want to create and test applications for mobile devices thatconform to the Java Runtime for Nokia Asha software platform (1.2.0) family of devices. To know aboutthe devices that conform to Java Runtime for Nokia Asha software platform (1.2.0), refer to DeviceSpecifications at Nokia Developer website.

Where to startWhat do you want to do? Begin here

I want to know about the system requirements toinstall the SDK

System requirements

I want to download the SDK. Downloading SDK

I want to install the SDK Running SDK installer

I want to integrate the SDK with an IDE Integrating SDK with an IDE

I want to learn how to launch the SDK emulator. Launching SDK emulator

I want to update or remove the SDK components, oruninstall the SDK.

Managing SDK components

I want to configure Eclipse IDE for the SDK. Configuring Eclipse for SDK

I want to configure NetBeans IDE for the SDK. Configuring NetBeans for SDK

Typographical conventionsThis 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

About SDK installation 2

Installing SDK

System requirementsBefore installing the SDK, verify that you have the minimum system requirements listed below. Withthese minimum requirements, you can run the SDK as a standalone application. If you plan to use theSDK 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 touse your normal logon ID (the one you use to run the SDK). At a minimum, you need administratorprivileges assigned temporarily for the installation.

Hardware requirementsThe recommended hardware requirements to install and run the SDK as a standalone tool are:

– PC with a 2.8 GHz Pentium-class processor

– 4 GB of memory

– Display monitor capable of displaying 24-bit color at 1280x1024 pixel resolution

– Approximately 10 GB of free hard disk space

– Network interface card

– Sound card

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

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

– Microsoft Windows 7 Professional/Enterprise/Ultimate Service Pack 1 (32/64-bit) - Recommended.

– Microsoft Windows 8 Pro/Enterprise (32/64-bit).

– Java SE Development Kit (JDK) 7 or 6 (32–bit). The JDK can be downloaded and installed from java.oracle.com.

Note:

– JDK is required, as an installation of Java Runtime Environment (JRE) can only help to run and notdevelop Java applications.

– This release of the Nokia Asha SDK is not tested on Microsoft Surface tablets.

Installing SDK 3

Downloading SDKBefore installing the SDK, you must first download the SDK installer on your computer from http://www.developer.nokia.com/Develop/Java/Tools/. This link allows you to download two types ofinstallers:

– Nokia_Asha_SDK_1_2_installer_em (online installer).

– Nokia_Asha_SDK_1_2_installer_offline_em (offline installer).

The online installer requires an internet connection to download the contents required for installation,while the offline installer does not require an internet connection.

Note: The SDK is available from the Nokia Developer website at no cost. If you are not a registeredmember of Nokia Developer, you need to register (also at no cost) before you can download the SDK.

Running SDK installerBefore you install the SDK, verify that you have installed the supported applications in the correct orderto ensure the applications can find the SDK. For more information refer to Integrating SDK with anIDE.

Perform the following steps to install the SDK.

1 Start the installation process by running the executable file Nokia_Asha_SDK_1_2_installer_em.exefor online installation, and Nokia_Asha_SDK_1_2_installer_offline_em.exe for offline installation. Inthe Welcome page, click Next to begin the Setup Wizard.

Installing SDK 4

Note: The online installer requires an internet connection to download the contents required forinstallation, while the offline installer does not require an internet connection.

2 In the Installation Path page, the default path to install the SDK is displayed. Click Next to continue.

Installing SDK 5

Note: The installation path must be <Drive>:\Nokia\Devices\Nokia_Asha_SDK_1_2.Only the <Drive> name is configurable.

3 In the SDK Components page, select the components you want to install, and then click Next.

Installing SDK 6

Note: By default, all components are selected.

The available components are tabulated below:

Component Name Description

Nokia Asha SDK 1.2 This component installs the complete Nokia Asha Software Development Kit (SDK).

Libraries This component installs the Nokia Asha software platform Java API libraries, whichinclude supported APIs and Javadocs.

Emulator This component installs the Nokia Asha software platform emulator, which helps totest and run developed MIDlets on a virtual device.

Nokia IDE for Java ME(Eclipse) v3.1

This component installs the Nokia Integrated Development Environment (IDE) forJava Platform, Micro Edition (Java ME) based on Eclipse IDE, which helps to developMIDlets for Nokia devices. For more information on the benefits of Nokia IDE forJava ME (Eclipse) v3.1, refer to Integrating SDK with an IDE.

Note:

– If you have selected Nokia IDE for Java ME (Eclipse) v3.1, then theEclipse Documentation gets automatically installed.

Installing SDK 7

Component Name Description

– If Nokia IDE for Java ME (Eclipse) v3.1 is selected, then the Installerdoes not prompt for the Eclipse IDE integration. You can view thedocumentation from Nokia IDE for Java ME (Eclipse) v3.1.

Nokia Asha On-Device Debugger v1.2

This component installs the Nokia Asha On-Device Debugger, which helps to debugMIDlets on the device.

Nokia Plug-ins This component installs the complete Nokia plug-ins, which help to enhanceMIDlets. By default, both the library and the documentation are selected forinstallation.

Nokia plug-ins included with this release includes:

– Nokia LWUIT - for creating rich user interfaces

– HERE Maps API for Java ME - for building interactive maps

– Tantalum - for creating concurrent networked applications

– Nokia In-App Payment - for creating Nokia In-App Payment enabled MIDlets

Note: Plug-in documentation depends on the standalone documentationcomponent. By default, the standalone DocBrowser is installed and theplug-in documentation files are copied to the %Root Dir%doc\docbrowser\eclipse\plugins\ folder.

Documentation This component installs the complete Nokia Asha SDK documentation.

Documentation included with this release includes:

– Eclipse — for integrating documentation with Eclipse IDE

– Standalone — for integrating documentation with DocBrowser

Note: By default, the documentation is installed for the standaloneDocBrowser. Documentation is also installed for Eclipse IDE, if foundinstalled, during the SDK installation.

SDK Manager This component installs the SDK Manager, which helps to update and removeinstalled components.

4 In the License Agreement page, read the license agreement and accept to continue with theinstallation. To accept the license agreement, select I have read and accept the licenseagreement, and then click Next.

Installing SDK 8

5 In the Start Menu Shortcuts page, select the Start menu folder where you want to create theprogram's shortcuts, and then click Next.

Installing SDK 9

Note: By default, a new folder — Nokia Asha SDK 1.2 is created for the program's shortcuts.

6 In the SDK Installation page, click Install to begin installing the SDK.

Installing SDK 10

Installing SDK 11

Note: Click Show Details to show detailed information, and click Hide Details to hide detailedinformation, during the installation.

7 In the Thank You page, click Finish to complete the setup wizard.

Installing SDK 12

Note: In the Thank You page, select View Release notes to view the release notes, and selectLaunch Nokia IDE for Java ME (Eclipse) v3.1 to run the IDE, after closing the Setup Wizard. Bydefault, both options are selected.

Integrating SDK with an IDEIn addition to using the SDK as a standalone tool, you can use the SDK within an IDE. Nokia Asha SDK1.2 has been tested with the following IDEs but may work with other IDEs as well:

– Nokia IDE for Java ME (Eclipse) v3.1

– Eclipse Indigo with Mobile Tools for Java (MTJ)

– Netbeans 7.0 or Later

Nokia Asha SDK 1.2 Installer provides an option to install Nokia IDE for Java ME (Eclipse).

Nokia IDE for Java ME (Eclipse) is designed to develop Java applications for Nokia devices based on theNokia Asha software platform 1.4. It is based on Eclipse Mobile Toolkit for Java (MTJ) and provides thefollowing additional features:

Installing SDK 13

– Automatically detects and integrates with the Nokia Asha software platform 1.4 SDK installed onyour system.

– Enables you to install Nokia Asha software platform 1.4 SDK on your system using Device SDKManager feature of the IDE.

– Provides additional Nokia-specific JAD attributes to manage and describe MIDlets for Nokia devices.

To use other IDEs with the SDK, install the applications in the following order:

1 Java SE Development Kit (JDK)

2 IDE

– For Eclipse, install Eclipse Indigo from http://www.eclipse.org/downloads/ and then installMobile Toolkit for Java (MTJ) plugin.

– For NetBeans, install NetBeans from http://www.netbeans.org/downloads/.

3 Nokia Asha SDK

For more information, see Configuring your IDE for SDK.

Launching SDK emulatorYou can launch the Nokia Asha SDK 1.2 Emulator directly, or from an IDE.

Launching the SDK emulator directlyTo launch the SDK emulator directly, click Start > All Programs > Nokia Asha SDK 1.2 > Nokia AshaSDK 1.2 Emulator.

Launching the SDK emulator from an IDEYou must configure some IDEs to recognize the SDK as a supported device before you can launch theSDK emulator from within the IDE interface. For more information on how to configure your IDE for theSDK, refer to Configuring your IDE for SDK.

For more information on how to launch the SDK within an IDE, refer to the help of the correspondingIDE:

– Nokia IDE for Java ME (Eclipse): To launch an SDK emulator from Nokia IDE for Java ME (Eclipse),refer to Nokia IDE for Java ME (Eclipse) v3.1 User Guide > Getting Started > Running a MIDlet inNokia IDE for Java ME (Eclipse) help.

– Eclipse: To launch an SDK emulator from Eclipse, refer to Java ME development user guide > GettingStarted > Basic tutorial > Running your programs in Eclipse help. Alternatively, see http://help.eclipse.org/galileo/topic/org.eclipse.mtj.doc.user/html/gettingstarted/run.html.

– NetBeans: To launch SDK emulator from NetBeans, refer to Java ME Applications > Running MIDPApplications > Running MIDP Applications in NetBeans help. Alternatively, see http://netbeans.org/kb/docs/javame/quickstart.html.

Installing SDK 14

Managing SDK componentsYou can manage SDK components using Nokia Asha SDK Manager.

To launch Nokia Asha SDK Manager, click Start > All Programs > Nokia Asha SDK 1.2 > Nokia Asha SDKManager.

Nokia Asha SDK Manager enables you to perform the following:

Updating SDK componentsPerform the following steps to update the SDK components:

1 Click Start > All Programs > Nokia Asha SDK 1.2 > Nokia Asha SDK Manager to launch the SDKManager.

2 Select Updates to scan the repository for updated components.

Note: The SDK Manager requires an Internet connection to check, download, and install updates.By default, all components available for update are selected. Click Collapse/Expand All to expand

Managing SDK components 15

or collapse the SDK package-component tree. For individual packages, click Down Arrow to expandand Up Arrow to collapse, the SDK package-component tree.

3 Select components you want to update, and then click Update.

Note: The status of the update is shown in the progress bar. For detailed information clickTriangle, next to the progress bar, to expand the information view.

4 Click Finish to close the SDK Manager.

Managing SDK components 16

Note: Nokia Asha SDK Manager also supports update notifications. When a component is availablefor update, you are notified about it via a notification.

In the notification area, click Nokia Asha SDK Manager notification area icon or Nokia Asha SDKManager notification, if available, to launch the SDK Manager.

Removing SDK componentsPerform the following steps to remove the SDK components:

Managing SDK components 17

1 Click Start > All Programs > Nokia Asha SDK 1.2 > Nokia Asha SDK Manager to launch the SDKManager.

2 Select Installed to scan the repository for installed components.

Note: By default, all components installed on your computer are selected. Click Collapse/ExpandAll to expand or collapse the SDK package-component tree. For individual packages, click DownArrow to expand and Up Arrow to collapse, the SDK package-component tree.

3 Clear components you want to remove, and then click Update.

Managing SDK components 18

Note: The status of the update is shown in the progress bar. For detailed information clickTriangle, next to the progress bar, to expand the information view.

4 Click Finish to close the SDK Manager.

Managing SDK components 19

Uninstalling SDKPerform the following steps to uninstall the SDK.

1 Click Start > All Programs > Nokia Asha SDK 1.2 > Nokia Asha SDK Uninstaller to launch theUninstaller.

2 In the Welcome page, select Uninstall SDK , and then click Next to begin the Setup Wizard.

Managing SDK components 20

3 In the SDK Uninstallation page, click Uninstall to begin uninstalling the SDK.

Managing SDK components 21

Managing SDK components 22

Note: The installation folder will be deleted completely, including all content in the folder.

Click Show Details to show detailed information, and click Hide Details to hide detailed information,during the uninstallation.

4 In the SDK Uninstallation page, click Next to complete the uninstallation.

Managing SDK components 23

5 In the Thank You page, click Finish to end the Setup Wizard.

Managing SDK components 24

Note: A few files in the installation folder could not be removed. However, you can safely deletethem.

Managing SDK components 25

What's next?If you plan to work within an IDE, you need to configure the supporting applications to work with theSDK.

To prepare an IDE in which to create:

– MIDlets (Java Application Descriptor (JAD) and Java ARchive (JAR) files) - Games or applications thatcan be downloaded from the Internet and used on a mobile phone. See Configuring your IDE forSDK.

If you have installed the documentation (see Step 3 in Running SDK Installer), click Start > All Programs> Nokia Asha SDK 1.2 > SDK Help to learn about Nokia Asha SDK 1.2.

What's next? 26

Configuring your IDE for SDKYou can work more efficiently by configuring an IDE to develop a MIDlet and test it on the SDK.

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

Note:

– For more information on installation of IDEs, see the respective IDE documentation.

– For more information on using the SDK in MIDP development, see Overview under Creating andtesting MIDlets in Nokia Asha SDK User Guide.

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

Configuring Nokia IDE for Java ME (Eclipse)Nokia IDE for Java ME (Eclipse) v3.1 gets installed with the default installation of Nokia Asha SDK 1.2(see Step 3 in Running SDK Installer). It automatically detects the Nokia Asha SDKs. Therefore, noconfiguration is required for Nokia IDE for Java ME (Eclipse).

Configuring Eclipse for SDKDownload Eclipse IDE from http://www.eclipse.org/downloads. To configure the SDK for Eclipse withMobile Tools for Java (MTJ):

1 In Eclipse, click Window > Preferences. In the Preferences window, click Java ME > DeviceManagement, and then click Manual Install.

Configuring your IDE for SDK 27

2 In the Manual Device Installation window, click Browse to select the folder where you want to searchfor installed SDKs. Select the required SDK, and click Finish.

3 The selected SDK is now available in the Device Management page. Click OK to complete theconfiguration.

Configuring your IDE for SDK 28

Configuring NetBeans for SDKDownload NetBeans IDE from http://www.netbeans.org/downloads/. To configure the SDK forNetbeans with Mobility Pack:

1 In NetBeans, click Tools > Java Platforms. In the Java Platform Manager window, click AddPlatform to begin the Add Java Platform wizard.

2 In the Select platform type page, select Java ME MIDP Platform Emulator, and then click Next.

Configuring your IDE for SDK 29

3 In the Platform Folders page, select the required version of Nokia Asha SDK, ensure other SDKsare deselected, and then click Next.

4 In the Detected Platforms page, click Next, and then click Finish to end the Add Java Platformwizard.

Configuring your IDE for SDK 30

5 The selected SDK is now available in the Java Platform Manager. Click Close to complete theconfiguration.

Configuring your IDE for SDK 31

Developer resourcesThe following documents contain additional information about the SDK:

– Nokia Asha SDK 1.2 Help

– Nokia Asha SDK 1.2 Release Notes

The Nokia Asha SDK 1.2 Help documents are available at:

– Nokia Asha SDK 1.2 installation folder (for a default installation, the doc folder is located at C:\Nokia\Devices\Nokia_Asha_SDK_1_2\doc\).

– Nokia IDE for Java ME (Eclipse) v3.1 from Help > Help Contents .

– Nokia Asha SDK 1.2 Emulator from Help > SDK Help.

– Start menu from Start > All Programs > Nokia Asha SDK 1.2 > SDK Help.

Additional documents about this product and related technologies may also be available at NokiaDeveloper website.

Developer resources 32

Discussion about this resourceYou can provide feedback, comments, and suggestions about the SDK to Nokia and other SDK usersusing the Nokia Developer Discussion Boards: http://www.developer.nokia.com/Community/Discussion/.

Discussion about this resource 33