Nokia 3510i User Manual
Hide thumbs Also See for 3510i:
Table of Contents

Advertisement

Quick Links

Nokia 3510i MIDP SDK
User's Guide
February, 2003

Advertisement

Table of Contents
loading

Summary of Contents for Nokia 3510i

  • Page 1 Nokia 3510i MIDP SDK User’s Guide February, 2003...
  • Page 2 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.
  • Page 3: Table Of Contents

    Configuring Nokia 3510i MIDP SDK with Sun One Studio ........20 Using Nokia 3510i MIDP SDK With JBuilder ............22 Creating a MIDlet and Running It on Nokia 3510i MIDP SDK ......22 Running a MIDlet and Displaying Trace Information........... 23 Understanding Nokia 3510i MIDP SDK Life Cycle..........
  • Page 4 About Options ..................... 30 Options for Starting the SDK................30 Options for Managing SDK Instances ..............32 About Parameters ....................33 Working With a CLI Shell ..................33 Keyboard Shortcuts ....................34 QWERTY Text Input ..................... 35 Nokia 3510i MIDP SDK User’s Guide...
  • Page 5: Document Overview

    Preface Document Overview This manual describes how to use the Nokia 3510i MIDP SDK. The Nokia 3510i MIDP SDK is a phone simulation software that simulates those features of a Nokia 3510i mobile handset that are related to the running of Java applications (MIDlets).
  • Page 6: Related Forum Nokia Documents

    The following documents, in addition to many others, are created and maintained by Forum Nokia. They are freely available at http://www.forum.nokia.com/. • How to Write a Mobile Java Program and Run it in a Nokia Phone • Nokia Developer’s Suite for the Java 2 Platform, Micro Edition: User’s Guide and Installation Guide •...
  • Page 7: Introduction To Nokia 3510I Midp Sdk

    What is the Nokia 3510i MIDP SDK? Nokia 3510i MIDP SDK is a simulation of a real Nokia 3510i phone handset and is based on a close copy of the actual phone software. The SDK consists of a menu bar, a phone image whose keys map to functions in the phone software identical to the functions available in the actual phone handset, and a Command Line Interface (CLI) through which the SDK can be started.
  • Page 8: Using The Sdk As A Standalone Product

    3510i handsets in the following ways: • To run applications and play games that are already loaded on their 3510i handset. • To browse to Internet sites from which they may download games and other applications.
  • Page 9: Running Midlets Immediately

    SDK closes. This behavior is necessary to enforce a closer parallel between the behavior of the SDK in MIDlet provisioning and the behavior of the 3510i Nokia handset: that is, installed MIDlets are removed between invocations of the SDK and so therefore must their associated records be removed.
  • Page 10: Running Midlets Through Midlet Provisioning

    SDK. For MIDlet provisioning, network connections must always occur through a WAP gateway both in the SDK and in the 3510i mobile handset. (For this reason, MIDlet provisioning is available only for WAP-enabled mobile phones.) If you have a WAP gateway, you can a make a WAP connection to a WAP gateway or server simulator in order to load a MIDlet.
  • Page 11: Provisioning Process

    Provisioning Process After configuring the WAP connection to the SDK, you may provision the MIDlet in an identical manner to that used on the 3510i mobile handset. The following steps describe the provisioning process: 1 Using the mobile handset browser, the user navigates to the URL of the site hosting the MIDlet and requests it be downloaded.
  • Page 12: Screen Attributes, Colors, Soft Keys

    • Image formats: PNG Available Memory Can be set from 0 to ~1 MB in the SDK; default value is ~200 • Heap memory size KB (same as the Nokia 3510i handset) ~64 KB • OTA download limit Java APIs Supported •...
  • Page 13: Configuring Nokia 3510I Midp Sdk With Ides

    Configuring JBuilder to Recognize Nokia 3510i MIDP SDK Before you begin to configure JBuilder to recognize the SDK, make sure you have installed JBuilder, MobileSet, and the SDK as described in Nokia 3510i MIDP SDK Installation Guide. To configure JBuilder to recognize the SDK: 1 In JBuilder, choose Tools>Configure JDKs.
  • Page 14: Configuring Nokia 3510I Midp Sdk For A Jbuilder Project

    JBuilder’s JDK list. Note that you can also specify which JDK is used by the SDK by entering the desired JDK version in the Emulator JDK text box. Configuring Nokia 3510i MIDP SDK for A JBuilder Project After configuring JBuilder to recognize the SDK as an installed JDK, as described in the previous section, you must instruct JBuilder to use the SDK as the target JDK for the particular project you are working on.
  • Page 15 Configuring JBuilder to Recognize Nokia 3510i MIDP SDK 1 In JBuilder, choose the project and display its project properties (for example, by right- clicking the project name). The project properties dialog is displayed as shown below. On the Paths tab of the Properties dialog, in the JDK field, select the SDK from the list of installed JDKs, using the navigation button to the right.
  • Page 16: Configuring Jbuilder To The Sdk With J2Me Wireless Toolkit

    Configuring Nokia 3510i MIDP SDK With IDEs 3 In Runtime Properties (shown below), configure the runtime parameters to be used when your MIDlet starts on the SDK:. • Ensure that the SDK is selected in the Emulator Device drop-down list.
  • Page 17: Configuring The Sdk With Nds For J2Me 1.0 Through Jbuilder

    Configuring JBuilder to Recognize Nokia 3510i MIDP SDK If you have already installed the SDK but did not install it in the above directory, you can copy the entire the SDK directory structure to this directory. To make the SDK the active device emulator within J2MEWTK: 1 Choose Tools>Configure JDKs.
  • Page 18 As shown below, it is recommended to specify JBuilder’s root directory: 3 After completing the NDS installation, start JBuilder. In JBuilder’s Tools menu, you should now see a new Nokia Developer’s Suite for J2ME menu item, as shown below: Nokia 3510i MIDP SDK User’s Guide...
  • Page 19 The following dialog is displayed: 5 Click New in the dialog above, and then in the Select emulator’s configuration file dialog box (shown below), navigate to the SDK’s configuration file (Nokia 3510i MIDP SDK.xml), which is an file in the root directory of the SDK. Then click Select.
  • Page 20: Configuring The Sdk With Nds For J2Me 1.1 Through Jbuilder

    Configuring Nokia 3510i MIDP SDK With IDEs 2 In JBuilder, choose Tools>Nokia Developer’s Suite for J2ME>Create Application Package. The NDS Create Application Package dialog is displayed. Enter the necessary information (see the NDS for J2ME User’s Guide) and click Finish. You now have a file.
  • Page 21 Configuring JBuilder to Recognize Nokia 3510i MIDP SDK 3 After completing the NDS installation, start JBuilder. In JBuilder’s Tools menu, you should now see a new Nokia Developer’s Suite for J2ME menu item, as shown below: 4 In JBuilder, choose Tools>Nokia Developer’s Suite for J2ME>Configure Emulators.
  • Page 22: Configuring Nokia 3510I Midp Sdk With Sun One Studio

    Configuring Nokia 3510i MIDP SDK with Sun One Studio When you run the Nokia MIDP SDK Installer program to install the SDK, choose the Manual Selection option to select the folder into which you want the SDK to be installed. Then, to run the SDK with Sun One Studio, you install the SDK into the following folder: <your-SunOne-install directory>\emulator\J2MEWTK-1_0_4-win\wtklib\devices...
  • Page 23 Configuring Nokia 3510i MIDP SDK with Sun One Studio 1 Launch Sun One Studio Mobile Edition. The following dialog is displayed: Nokia 3510i MIDP SDK User’s Guide...
  • Page 24: Using Nokia 3510I Midp Sdk With Jbuilder

    After you have installed and configured JBuilder, you can begin to use the SDK within its environment. Creating a MIDlet and Running It on Nokia 3510i MIDP SDK Use the following procedure to create a MIDlet from scratch and then run it on the SDK.
  • Page 25: Running A Midlet And Displaying Trace Information

    Using Nokia 3510i MIDP SDK With JBuilder 1 In JBuilder, choose File>New Project to create a new project. Complete the dialogs in JBuilder’s Project Wizard. Note that, in the second dialog, you must specify the SDK as a JDK using the unique JDK name you entered earlier.
  • Page 26 Configuring Nokia 3510i MIDP SDK With IDEs Nokia 3510i MIDP SDK User’s Guide...
  • Page 27: Using Nokia 3510I Midp Sdk

    Using Nokia 3510i MIDP SDK This chapter provides a reference for using the SDK graphical user interface (GUI), which closely replicates the user interface (UI) of the Nokia 3510i phone handset with respect to: • General look • Display and rendering •...
  • Page 28: Tools Menu

    SDK’s phone menus. This setting affects only phone menus. Local files and Internet documents are displayed in the language used when the document was created. You must restart the SDK after changing the language setting. Nokia 3510i MIDP SDK User’s Guide...
  • Page 29 URL is stored there and if the content has not yet expired, and if so, it is used. If not checked, each URL request is routed over the Internet, bypassing the cache. Nokia 3510i MIDP SDK User’s Guide...
  • Page 30: Help Menu

    Choose Play phone sounds to direct the SDK to send supported sound content to the computer’s sound card. Only sounds specified by a MIDlet are played. Help Menu About... Displays the product name and version, as well as Nokia copyright information. Nokia 3510i MIDP SDK User’s Guide...
  • Page 31: Phone Menus

    Running the SDK Through a Command Line Interface Phone Menus The phone menu structure displayed in the instance GUI is identical to that of the 3510i phone handset, which is to say that no menus have been omitted from the SDK GUI. However, not all menus in the SDK function similarly to their 3510i handset counterpart because the SDK is not a phone but a tool for developers of Internet content.
  • Page 32: About Options

    If the value specified is out of range, the SDK uses the default value (~200 KB). Specifies that the MIDlet be run in debugging mode. -debugger Specifies the TCP/IP port number between the emulator 2800 -vm_port KVM and the debug proxy. Nokia 3510i MIDP SDK User’s Guide...
  • Page 33 Replaces the number of the instance you specify with a -title name you specify. For example, you can rename the window (1) 3510i SDK to TEST 3510i SDK by entering . This option does not affect the 3510i.exe -title TEST...
  • Page 34: Options For Managing Sdk Instances

    Displays the numbers of all running instances. This -qinst option always returns the instance numbers, even if you rename an instance with . Use as the sole -title -qinst option in a command line. Nokia 3510i MIDP SDK User’s Guide...
  • Page 35: About Parameters

    (parameters) to the one instance without having to recreate the instance with every parameter. You can attach a shell to an instance that was created through a standalone SDK or through an application such as JBuilder. In this example, more than one instance is running: Nokia 3510i MIDP SDK User’s Guide...
  • Page 36: Keyboard Shortcuts

    Enter Right soft key Backspace Cursor Up <Up arrow> Cursor Down <Down arrow> Send key NumPad / (slash) End key. NumPad - (minus) # (pound) key NumPad . (period) * (asterisk) key. NumPad * Nokia 3510i MIDP SDK User’s Guide...
  • Page 37: Qwerty Text Input

    SDK. The effect of this is quite similar to simply pressing the alphanumeric keys on a 3510i mobile handset when its browser is not active, as if you were entering a phone number to be dialed.
  • Page 38 Using Nokia 3510i MIDP SDK Nokia 3510i MIDP SDK User’s Guide...

Table of Contents