Summary of the content on the page No. 1
Basic Customization Guide
Wireless Toolkit, Version 2.1
TM
Java 2 Platform, Micro Edition
Sun Microsystems, Inc.
4159 Network Circle
Santa Clara, CA 95054
U.S.A. 650-960-1300
December 2003
Summary of the content on the page No. 2
Copyright © 2003 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, California 95054, U.S.A. All rights reserved. Sun Microsystems, Inc. has intellectual property rights relating to technology embodied in the product that is described in this document. In particular, and without limitation, these intellectual property rights may include one or more of the U.S. patents listed athttp://www.sun.com/patents and one or more additional patents or pending patent applications in the U.S. and in o
Summary of the content on the page No. 3
Contents Preface xi 1. Customizing the Wireless Toolkit 1 How to Customize the Wireless Toolkit 1 Customization Steps 2 Device Property Files and the Default Emulator 2 2. Creating Device Property Files 5 Make a Copy of an Existing Main Device Property File 5 Obtain and Enter Image Files 6 Obtain and Enter the Screen Properties 7 Screen Location 7 Total Screen Size 8 Display Area 8 Display Area in Full Screen Mode 9 Obtain and Enter the Button Properties 10 Obtain and Enter Soft Button Label Are
Summary of the content on the page No. 4
3. Examining Device Property Files 17 Device Property Files 18 Main Device Property File 19 Fonts 19 Fonts Used by the MIDP APIs 19 Default Font 20 System Fonts 20 Bitmap Fonts 20 Font Underlining 22 The Device Image 22 Image without Buttons Pressed 23 Image with Buttons Pressed 23 Image with Buttons Highlighted and Backlight On 23 Scaling 23 Screen Properties 24 Screen Location 25 Total Screen Size 26 Display Area 26 Display Area in Full Screen Mode 26 Screen Pixel Ratio 27 Screen Background Co
Summary of the content on the page No. 5
Assigning Abstract Commands to Buttons 33 Displayed Icons 38 Defining the Icon Location and States 38 Soft Button Label Display 39 Color 40 Sound Alerts 40 Device Software Capabilities 41 Locales 42 Character Encodings 42 Transparent Images 43 A. Default Emulator Device Property Files 45 Property Files 45 DefaultGrayPhone.properties 46 Device Image Files 53 Icon Image Files 53 B. Support for ByteCode Obfuscators 55 Adding a ByteCode Obfuscator 55 Example 56 C. Connecting to the Wireless Toolkit’
Summary of the content on the page No. 6
vi Wireless Toolkit Basic Customization Guide • December 2003
Summary of the content on the page No. 7
Figures FIGURE 1 Specifying Screen Properties 9 FIGURE 2 Specifying a Button Location 11 FIGURE 3 Soft Button Label Areas on the Emulated Device Display 13 FIGURE 4 Specifying Emulator Fonts 21 FIGURE 5 Specifying Screen Properties 25 FIGURE 6 Specifying a Button Location 31 FIGURE 7 Soft Button Labels on the Emulated Device Display 39 FIGURE 8 Images of Device Key Press States 53 vii
Summary of the content on the page No. 8
viii Wireless Toolkit Basic Customization Guide • December 2003
Summary of the content on the page No. 9
Tables TABLE 1 Example of Device Property Files and DefaultGrayPhone Property File 18 TABLE 2 Button Names Available 29 TABLE 3 Abstract Command Types in Order of Precedence 33 TABLE 4 Alert Type Values 41 TABLE 5 Example of Device Property Files 45 TABLE 6 Icon Image Files 53 ix
Summary of the content on the page No. 10
x Wireless Toolkit Basic Customization Guide • December 2003
Summary of the content on the page No. 11
Preface ™ The Java 2 Platform, Micro Edition, Wireless Toolkit Basic Customization Guide ™ describes how to customize the J2ME Wireless Toolkit by modifying device property files. Who Should Use This Book This guide is intended for developers who need to configure the J2ME Wireless Toolkit to accommodate device emulators other than the ones provided by the Wireless Toolkit. This document assumes that you are familiar with Java programming, Mobile Information Device Profile (MIDP) and the Connect
Summary of the content on the page No. 12
screen properties, button properties, soft button label areas, and icon properties. The tutorial also explains how to set color properties and how to run the emulator for the new device. Chapter 3 describes in depth the components of a device definition and explains how to create a device definition. Appendix A lists the property files for the default emulator, describes the properties for it, and lists the image and icon files for the default emulator. Appendix B explains how to add a bytecode
Summary of the content on the page No. 13
Typographic Conventions Typeface Meaning Examples AaBbCc123 The names of commands, files, Edit your .login file. and directories; on-screen Use ls -a to list all files. computer output % You have mail. AaBbCc123 What you type, when % su contrasted with on-screen Password: computer output AaBbCc123 Book titles, new words or terms, Read Chapter 6 in the User’s Guide. words to be emphasized These are called class options. You must be superuser to do this. Command-line variable; replace To delete a
Summary of the content on the page No. 14
Application Title CLDC - JSR 30, JSR 139 J2ME™ Connected Limited Device Configuration WMA - JSR 120 Wireless Messaging API (WMA) for Java™ 2 Micro Edition MMAPI - JSR 135 Mobile Media API JTWI - JSR 185 Java Technology for the Wireless Industry J2ME Web Services JSR 172 J2ME™ Web Services Specification Accessing Sun Documentation Online ™ SM The Java Developer Connection web site enables you to access Java platform technical documentation on the Web. http://developer.java.sun.com/developer/infod
Summary of the content on the page No. 15
CHAPTER 1 Customizing the Wireless Toolkit TM TM The Java 2 Platform, Micro Edition Wireless Toolkit (J2ME Wireless Toolkit) provides an emulation environment for the development of applications compliant with the Mobile Information Device Profile (MIDP). The Java 2 Platform, Micro Edition Wireless Toolkit Basic Customization Guide provides technical details for configuring the toolkit to accommodate new device emulators. This chapter gives an overview of customizing the J2ME Wireless Toolkit an
Summary of the content on the page No. 16
Customization Steps You customize the J2ME Wireless Toolkit for a new device in three simple steps: 1. Obtain the default J2ME Wireless Toolkit. The toolkit includes a default development environment and a Default Emulator. The Default Emulator is supplied with sets of device property files that enable the emulation of several generic wireless devices. 2. Create new device property files. A company that wants to have applications developed for specific devices using the toolkit can modify the de
Summary of the content on the page No. 17
For example, suppose the J2ME Wireless Toolkit is installed in the directory C:\WTK21. Then, the Main Device Property File for the device DefaultColorPhone is located at C:\WTK21\wtklib\devices\DefaultColorPhone\DefaultColorPhone.pro perties. For the remainder of this document, {j2mewtk.dir}, denotes the installation directory of the J2ME Wireless Toolkit. Chapter 1 Customizing the Wireless Toolkit 3
Summary of the content on the page No. 18
4 Wireless Toolkit Basic Customization Guide • December 2003
Summary of the content on the page No. 19
CHAPTER 2 Creating Device Property Files This chapter presents a simple tutorial that walks you through the procedures for creating a device property file. You will learn how to use the new device property files to enable the J2ME Wireless Toolkit to emulate applications for the device. See Chapter 3, “Examining Device Property Files” for a detailed reference on device properties, the custom-tailoring options available, and how to use them. In the following step-by-step tutorial, you will create
Summary of the content on the page No. 20
Note – All directory names in this chapter refer to the installation directory of the J2ME Wireless Toolkit. (If you chose the default option at installation, the directory is C:\WTK21.) 1. Copy the directory wtklib\devices\DefaultColorPhone and its contents as wtklib\devices\NewPhone. 2. Rename the main device property file wtklib\devices\NewPhone\DefaultColorPhone.properties to wtklib\devices\NewPhone\NewPhone.properties. Obtain and Enter Image Files You need to provide image files for the new
