Preface

The Java Device Test Suite Developer’s Guide describes how to develop test packs that can integrate with the Java Device Test Suite.

Before You Read This Book

To fully use the information in this document, you must have moderate knowledge of the online help and topics discussed in these books:

Java Device Test Suite Tester’s Guide

Java Device Test Suite Administration Guide

You must also have thorough knowledge of the specification and API of the technology such as MIDP, CLDC, MMAPI, OTA, or WMA for which you are writing tests.

In addition, a familiarity with the Ant build utility (see http://ant.apache.org/) can be useful.

How This Book Is Organized

Part 1, “P A R T I - Getting Started” gives an overview of concepts and provides hands-on experience building test packs included with this distribution.

Part 2, “P A R T II - Essentials” gets deeper into essential topics of test pack development.

Part 3, “P A R T III - Advanced Topics” covers more advanced topics of test pack development, concepts and procedures that are used in special cases.

Part 4, “P A R T IV - Legacy” covers topics and procedures that are maintained for backwards compatibility with previous versions of Java Device Test Suite.

Part 5, “P A R T V - Appendices” contains supplementary information about this release.

Using Operating System Commands

This document does not contain information on basic Solaris trademark operating system or Windows commands and procedures such as shutting down the system, booting the system, and configuring devices. Refer to the following for this information:

Software documentation that you received with your system

Solaris operating system documentation, which is at http://docs.sun.com

Typographic Conventions

Typeface	Meaning	Examples
`AaBbCc123`	The names of commands, files, and directories; on-screen computer output	Edit your `.login` file. Use `ls -a` to list all files. `% You have mail.`
`AaBbCc123`	What you type, when contrasted with on-screen computer output	`%` `su` `Password:`
AaBbCc123	Book titles, new words or terms, words to be emphasized Command-line variable; replace with a real name or value	Read Chapter 6 in the Developer’s Guide. These are called test packs. You must be an administrator to do this. To delete a file, type `rm` filename.

Typeface

Meaning

Examples

AaBbCc123

The names of commands, files, and directories; on-screen computer output

Edit your .login file.

Use ls -a to list all files.

% You have mail.

AaBbCc123

What you type, when contrasted with on-screen computer output

% su

Password:

AaBbCc123

Book titles, new words or terms, words to be emphasized

Command-line variable; replace with a real name or value

Read Chapter 6 in the Developer’s Guide.

These are called test packs.

You must be an administrator to do this.

To delete a file, type rm filename.

Terminology Conventions

The Java Device Test Suite 2.0 introduces the term test pack to describe a container of test packages. Previously, this container was known as a test suite. The term suite still appears in some directory names, file names, and property names. This was done for backward compatibility.

Shell Prompts

Shell	Prompt
C shell	machine_name`%`
C shell superuser	machine_name`#`
Bourne shell and Korn shell	`$`
Bourne shell and Korn shell superuser	`#`

Application	Title
Test Development	This guide
Test Execution	Online help Java Device Test Suite Tester’s Guide Java Device Test Suite Test Notes
Administration	Online help (administrator harness edition) Java Device Test Suite Administration Guide

Accessing Sun Documentation Online

The Sun Developer Network program web site enables you to access Java platform technical documentation on the web at http://java.sun.com/reference/docs/index.html.

Third-Party Web Sites

Sun is not responsible for the availability of third-party web sites mentioned in this document. Sun does not endorse and is not responsible or liable for any content, advertising, products, or other materials that are available on or through such sites or resources. Sun will not be responsible or liable for any actual or alleged damage or loss caused by or in connection with the use of or reliance on any such content, goods, or services that are available on or through such sites or resources.

Sun Welcomes Your Comments

We are interested in improving our documentation and welcome your comments and suggestions. Send us your comments at http://java.sun.com/docs/forms/sendusmail.html.