Contents

Java Device Test Suite Developer’s Guide

Version 2.4 Java ME Platform

Contents

Part I Getting Started

Test Pack Types

Automated Tests

Interactive Tests

Distributed Tests

Benchmark Tests

Over-the-Air Tests

OTA Interactive Tests

OTA Semi-Automated Tests

2. Setting Up the Developer’s Kit

Acquire and Install the Prerequisite Software

Unzip and Configure the Developer’s Kit

Build and Install the Sample Test Packs

3. Introducing the Developer’s Kit

Developer’s Kit Structure

tests/common/

tests/runtime/

Editing and Building a Test Pack

Files Generated by the Build

Packaging a Test Pack

Part II Essentials

4. Test Class and Case Comment Blocks

Comment Block Overview

Test Class Comment Block Tags

Test Case Comment Block Tags

@card.property

@card.specialproperty

@card.requires

@card.attribute

5. Writing Online Documentation

Documenting a Test Pack

Documenting a Test Package

6. Writing the testsuite.info File

File Format and Syntax

Read-only Properties

Property Value Validation Attributes

Online Documentation for a Property

${TS_DIR} Reserved Word

Required Properties

Optional Properties

7. The build.properties Files

8. Using Common Services

Obtaining a Property Value

Learning if a Case is Selected

9. Writing Runtime Tests

Writing an Automated Test

Writing an Interactive Test

Writing Network Tests

Writing the Client Part

Writing the Server Part

Writing Push Tests

Architecture of a Push Test

Writing the Client Package

Writing a Main MIDlet

Writing a Push MIDlet

Writing a Server

Using $IPFILTER

10. Writing Benchmark Test Packages

Benchmark Test Directory Structure

Benchmark Test Types

Writing a System Load Test

Writing a Unit Rate Test

11. Developing an Over-the-Air Test Package

OTA Test Pack Development

Writing an OTA Test

Writing OTA Source Files

Security Certificates for a Test Class

Writing Application Files

Directory Structure

Application Logging

Additional Facilities for Interactive OTA Tests

Part III Advanced Topics

12. Checking Card Files

small space Running the Card File Checker

13. Updating a Test Pack

Test Pack Identifiers

Test Pack Version Identifier

Test Rename File

Test Pack Property Rename File

14. Reconfigure Environment Settings for Special Test Pack Installation

small space Reconfiguring the Environment

15. Defining New Security Permissions

16. Properties and Parameter Expansion

Parameter Expansion

Predefined Parameters for OTA Test Packs

17. Customizing the Test Pack Zip File

18. Multiple Test Packs in a Directory

19. Using TestPackInstallerMain for Faster Test Installation Cycles

Customizing the tpim Script

20. Test Pack Versioning Alternative

21. Build Targets

22. Tests and Device Features

Package and Feature Concepts

Package-based Selection and Reporting

Feature-based Selection and Reporting

Package and Feature Implementation

Feature Definition File

23. Relevance Filtering

24. Classless Card Files

Naming, Scope, and Syntax

25. Writing Card Files Manually

Test Case Definitions

Required File Definitions

Property Definitions

Class and Case Keyword Definitions

Special Property Definitions

Choosing Between Card File and testsuite.info Properties

26. Writing packages.list Files

27. Writing Evaluation Files

small space Procedure for Editing an Evaluation File

Example Evaluation File Text

small space Including Reference Images in an Evaluation File

An Evaluation File Rendered by the Harness

28. Writing Conditional Output

Part V Appendices

A. Adapting the WMA Test Emulator

Implementing CBSServer

small space Deploying the Implementation

B. Exclude Lists

New in Release 2.4

New in Release 2.3

New in Release 2.2

New in Release 2.1.2

New in Release 2.1.1

New in Release 2.1