Nokia 9210 Service Manual 9210JavaHowTo_v1.1

How to develop Java

Nokia 9210 Communicator

Version 1.1

09-08-01

Applications for the

How to develop JavaTM Applications for the Nokia 9210 Communicator Version 1.1

Table of contents

1. INTRODUCTION.................................................................................................................................................................... 4

2. JAVA IMPLEMENTATION ON THE NOKIA 9210 COMMUNICATOR.............................................................................. 4

3. DEVELOPMENT GUIDELINES.............................................................................................................................................. 5

3.1 U

SER INTERFACE PRINCIPLES.............................................................................................................................................................................5

BSTRACT WINDOW TOOLKIT (AWT) INTERFACES............................................................................................................................................6

3.2 A

OMMAND BUTTON AREA API..........................................................................................................................................................................6

3.3 C

TATUS PANE API..............................................................................................................................................................................................7

3.4 S

IRTUAL CURSOR API........................................................................................................................................................................................7

3.5 V

4. SHORT CODE EXAMPLE...................................................................................................................................................... 7

4.1 T

HE SOURCE CODE.............................................................................................................................................................................................9

YMBIAN PLATFORM SPECIFIC PROCESSES........................................................................................................................................................9

4.2 S

4.2.1 Making an installation package for the target device..........................................................................................................14

5. FURTHER INFORMATION.......................................................................................................... ........................................15

Change history 09-08-01 Version 1.1 Document updated by Forum Nokia 03-01-01 Version 1.0 Document created by Forum Nokia

How to develop JavaTM Applications for the Nokia 9210 Communicator Version 1.1

Disclaimer:

The software or the copyrighted document is provided "as is", without warranties of any kind, and specifically excluding all implied warranties, for example of merchantability, fitness for purpose, title and noninfringement. In no event shall nokia be liable for any special, indirect or consequential damages, or any damages whatsoever resulting from loss of use, data or profits, arising out of or in connection with the use or performance of the software or the copyrighted document.

Nokia Mobile Phones Ltd retains the right to make changes to this specification at any time without notice.

Licence:

You need a license from Nokia to use this document. The license terms will determine your rights and obligations. Without the prior written permission of Nokia, reproduction of the copyrighted document to any other server or location for further reproduction or redistribution is expressly prohibited.

How to develop JavaTM Applications for the Nokia 9210 Communicator Version 1.1

1. INTRODUCTION

language is a general-purpose, concurrent, class-based, object-oriented programming

Java language. It is designed to be simple enough that many programmers can achieve fluency in the language. Java is related to C and C++ but is organized rather differently, with a number of aspects of C and C++ omitted and a few ideas from other languages included.

The PersonalJava

Application Environment (PJAE) is a Java application environment that executes software written in the Java programming language. The PJAE addresses the software needs of networked applications running on personal consumer devices such as set-top boxes and smart phones rather than desktop computers.

The PersonalJava Application Environment with JavaPhone

1.0 APIs is included in the Nokia

9210 Communicator. The Nokia 9210 Communicator has the following features:

• Both PDA and CMT sides

• PersonalJava implemented only to the PDA side, with JavaPhone access also to

the CMT side

• PDA screen properties: Color depth 12-bits, which is 4096 colors at a time PDA screen resolution 640x200 No pointing device, different UI design (Virtual Cursor API) Common Button Area (CBA) on the right-hand side of the screen with four soft buttons

• A QWERTY keyboard with a menu key

• GSM data transports: HSCSD 2+2 / 3+1 / 1+1 with either 9600 bps or 14400

bps channel coding, SMS service with about 300 bps.

• Nokia 9210 Communicator hardware: 16 MB memory card in the sales package

2. JAVA IMPLEMENTATION ON THE NOKIA 9210 COMMUNICATOR

The Nokia 9210 Communicator is the first Java-capable Nokia phone. At a general level, the objectives of using Java in the Nokia 9210 Communicator are:

• To start fulfilling the promises of Java language: ease of programming, portability and safety. A simpler and safer language means easier programming, less errors, less testing and less debugging.

• Applet support: The Nokia 9210 Communicator's web browser doesn't supports applets, but appletviewer application is included. (An applet is a program written in the Java

How to develop JavaTM Applications for the Nokia 9210 Communicator Version 1.1

programming language that can be included in an HTML page, much in the same way as an image is included.)

• Getting more 3rd party software: the Nokia 9210 Communicator has enough power for pJava applications, at least for games and utilities.

• Downloadable applets and applications: Java is a safe technology for it. A key feature of the current PC Internet industry is downloading the applications free of charge from the web.

• JavaPhone implementation: JavaPhone API is a vertical extension to the PersonalJava platform developed through an open process by Sun Microsystems in collaboration with other key expert groups in the telecommunications engineering community. JavaPhone APIs can only be used in applications, not in applets because of security reasons.

Nokia 9210 Communicator Java implementation is based on Sun Personal Java reference implementation (1.1.1 spec). It includes all optional functionality except printing. Java applications and applets can be run on both MARM (devices) and WINS (PC emulator). Customisation is needed only for the "look and feel" of the DFRDs (Device Family Reference Design).

3. DEVELOPMENT GUIDELINES

Developers can create add-on applications for the Nokia 9210 Communicator by registering on the Forum Nokia developer site and ordering "Nokia 9210 SDK for the Symbian Platform" on the Forum Nokia web site (www.forum.nokia.com). Both C++ and Java SDK are included on the CDROM.

The Java SDK contains an emulator for Windows NT4/95/98 (Win2000 not supported), documentation with examples and tools and additional tools to support native method development using JNI. Java compiler/IDE is not included in the SDK. One must download free JDKTM 1.1.8 + Personal Java compatibility classes from the Sun web site (java.sun.com/products/personaljava). The PersonalJava compatibility classes are additional classes available in the PersonalJava API which are not available in the corresponding Java Development Kit. For JNI development Microsoft Visual C++TM, v.6 is also needed.

The SDK documentation contains a Quick Start tutorial for creating a simple Hello World application and detailed information about developing Java applications for the Crystal platform. The Crystal platform is one of the Symbian's three EPOC DFRDs and it is designed for communicator-like devices.

3.1 User Interface Pri n ciples

The Nokia 9210 Style Guide is included in the SDK. It contains details on how the Crystal platform looks in the device. Certain aspects should be considered when developing applications for the Nokia 9210 Communicator. The interactive elements in the Crystal Platform consist of four command buttons, a menu and a PDA keyboard. No real pointing device or touch screen exist, but it's possible to use Pointer instead. The UI of the cellular telephone cannot be programmed.

+ 11 hidden pages