Summary of the content on the page No. 1
™
Java ME TCK Framework
Developers Guide
Version 1.2
Sun Microsystems, Inc.
www.sun.com
July 2007
Summary of the content on the page No. 2
Copyright 2007 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, California 95054, U.S.A. All rights reserved. Test suite developer’s guide for the Java ME TCK Framework. THIS PRODUCT CONTAINS CONFIDENTIAL INFORMATION AND TRADE SECRETS OF SUN MICROSYSTEMS, INC. USE, DISCLOSURE OR REPRODUCTION IS PROHIBITED WITHOUT THE PRIOR EXPRESS WRITTEN PERMISSION OF SUN MICROSYSTEMS, INC. U.S. Government Rights—Commercial software. Government users are subject to the Sun Microsystems, Inc. standard l
Summary of the content on the page No. 3
Contents Preface xv 1. Introduction 1 Getting Started 1 Development Environment 3 Use of the Framework 3 Target Environment 3 Connectivity Requirements 4 Resource Limitations 5 Framework Bundle 6 Framework Components 6 Framework Components on the Harness Side 7 Framework Components on the Device Side 7 Test Types 8 Automated Tests 9 Distributed Tests 10 Interactive Tests 12 OTA Tests 13 2. Writing a Simple Automated Test 15 iii
Summary of the content on the page No. 4
Writing an Automated Test 15 ▼ To Create a Simple Automated Test 16 Building an Updated Simple Test Suite 19 ▼ To Build an Updated Test Suite 19 Testing an Updated Simple Test Suite 20 ▼ To Test an Updated Test Suite 20 3. Test Suite Construction 23 Test Suite Structure 23 testsuite.jtt File 24 lib Directory 25 tests Directory 25 Test Class 26 Test Case 26 Test Description file 27 classes Directory 27 doc Directory 28 Creating a Test Suite Configuration Interview 28 ▼ To Create a Configuration I
Summary of the content on the page No. 5
remote Attribute 44 remoteSource Attribute 45 executeArgs Attribute 45 Distributed Test Execution 46 Testing User Interfaces With Interactive Tests 48 Client Test Component 49 Remote Test Component 49 Test Description for Interactive Tests 49 Required Interactive Test Keywords 50 Interactive Test Execution 50 Example of an Interactive Test 52 Testing Application Provisioning With OTA Tests 53 Server Component of an OTA Test 53 Client Test Component of an OTA Test 53 Test Description for OTA Test
Summary of the content on the page No. 6
Marking Trusted Tests 62 Using an Attribute to Mark Double-Duty Tests 63 Granting or Denying Security Permissions 64 Granting Security Permissions 64 Denying Security Permissions 66 Adding Resource Files in Tests 67 Enabling Test Selection 70 Factors and Mechanisms for Test Selection 70 selectIf Test Selection 71 ▼ To Enable Test Selection with theselectIF Expression 71 A. Test API 77 Test 77 Status 78 MultiTest 78 J2MEDistributedTest 79 J2SEDistributedTest 79 DistribInteractiveTest 79 OTATest 8
Summary of the content on the page No. 7
CommServers 85 Messaging 85 Test Export Support Libraries 85 CDC Agents 85 src Directory 86 Framework Server Classes and Interfaces 86 Agent Classes 87 Digital Signer 87 Preverification Script 87 Java ME Technology Version of Harness Classes 87 Basic Interview Classes Containing General Questions 87 Communication Channel 88 doc Directory 89 C. Test Description Fields and Keywords 91 Test Description Fields 91 Keywords 94 Glossary 97 Index 107 Contents vii
Summary of the content on the page No. 8
viii Java ME TCK Framework Developer’s Guide • July 2007
Summary of the content on the page No. 9
Figures FIGURE 1-1 Framework Configuration for Standard Automated Tests 10 FIGURE 1-2 Framework Configuration for Distributed Tests 11 FIGURE 1-3 Framework Configuration for Interactive Tests 13 FIGURE 1-4 Framework Configuration for OTA Tests 14 FIGURE 4-1 Automated Test Execution 42 FIGURE 4-2 Distributed Test Execution 47 FIGURE 4-3 Interactive Test Execution 51 FIGURE 4-4 OTA Test Execution 58 ix
Summary of the content on the page No. 10
x Java ME TCK Framework Developer’s Guide • July 2007
Summary of the content on the page No. 11
Tables TABLE 1-1 Configurations and Supported Test Types 8 TABLE C-1 Framework Test Description Fields 92 TABLE C-2 Framework Keywords 94 xi
Summary of the content on the page No. 12
xii Java ME TCK Framework Developer’s Guide • July 2007
Summary of the content on the page No. 13
Code Examples CODE EXAMPLE 3-1 Simple Test Suitetestsuite.jtt File 24 CODE EXAMPLE 3-2 Simple Test Class 26 CODE EXAMPLE 4-1 Required Distributed Test Keyword 44 CODE EXAMPLE 4-2 remote Attribute 45 CODE EXAMPLE 4-3 remoteSource Attribute 45 CODE EXAMPLE 4-4 executeArgs Attribute With Multiple Environment Variables 46 CODE EXAMPLE 4-5 Required Interactive Test Keywords 50 CODE EXAMPLE 4-6 Required OTA Test Keyword 54 CODE EXAMPLE 4-7 executeClass Attribute Entry 54 CODE EXAMPLE 4-8 remote Attrib
Summary of the content on the page No. 14
CODE EXAMPLE 4-19 Test Description That Grants Permissions for a Security Test 65 CODE EXAMPLE 4-20 deny Attribute in the Test Description 66 CODE EXAMPLE 4-21 Test Description That Denies Permissions for a Security Test 66 CODE EXAMPLE 4-22 Test That Requires an Image Resource 68 CODE EXAMPLE 4-23 resources Attribute in the Test Description 68 CODE EXAMPLE 4-24 Test Description That Includes Resources 69 CODE EXAMPLE A-1 run Method 77 CODE EXAMPLE A-2 Definition of main 78 CODE EXAMPLE A-3 Test
Summary of the content on the page No. 15
Preface This guide describes how to use resources from the Java™ Platform, Micro Edition Technology Configuration Kit Framework (Framework) to develop and configure test suites and tests for Java Platform, Micro Edition (Java ME platform) technologies. Before You Read This Book To fully use the information in this document, you must read and understand the topics discussed in the following books: ■ TCK Project Planning Guide A high-level planning guide that describes a process for developing a T
Summary of the content on the page No. 16
■ JavaTest Harness User’s Guide: Graphical User Interface This guide provides a description of using the harness Graphical-User Interface (GUI). This guide is available from the Java ME Technology APIs and Docs web site at http://java.sun.com/javame/reference/apis.jsp. ■ JavaTest Harness User’s Guide: Command-Line Interface This guide provides a description of using the harness command-line interface. This guide is available from the Java ME Technology APIs and Docs web site at http://java.sun.c
Summary of the content on the page No. 17
Platform Commands This document does not contain information about basic platform 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 at http://docs.sun.com Examples Examples in this guide might contain the following shell prompts: Shell Prompt C shell machine-name% C shell superuser machine-name# Bou
Summary of the content on the page No. 18
Typographic Conventions This guide uses the following 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. Replace command-lin
Summary of the content on the page No. 19
Accessing Sun Documentation Online The Java Developer Connection™ program web site enables you to access Java platform technical documentation at http://java.sun.com/. Sun Welcomes Your Comments We are interested in improving our documentation and welcome your comments and suggestions. Provide feedback to Sun at http://java.sun.com/docs/forms/sendusmail.html Preface xix
Summary of the content on the page No. 20
xx Java ME TCK Framework Developer’s Guide • July 2007
