Sun Microsystems 1.2

viii Java ME TCK Framework Developer’s Guide • July 2007

Contents

Main Please Recycle Test suite developers guide for the Java ME TCK Framework. Contents Page Page Page Page Page Figures Page Page Page Code Examples Page Preface Before You Read This Book Intended Audience How This Book Is Organized Platform Commands Examples Typographic Conventions This guide uses the following typographic conventions: Related Documentation Page Page Introduction Getting Started Note Development Environment Use of the Framework Target Environment Connectivity Requirements Resource Limitations CLDC Target Device CDC Target Device Framework Bundle Note Framework Components Framework Components on the Harness Side Framework Components on the Device Side Test Types Automated Tests Distributed Tests Page Interactive Tests OTA Tests Page Writing a Simple Automated Test Writing an Automated Test To Create a Simple Automated Test Page Note Building an Updated Simple Test Suite To Build an Updated Test Suite Note Testing an Updated Simple Test Suite To Test an Updated Test Suite Note Page Page Test Suite Construction Test Suite Structure testsuite.jtt File lib Directory tests Directory Test Class Test Case Test Description file classes Directory doc Directory Creating a Test Suite Configuration Interview To Create a Configuration Interview Through the Interview Class Page Page Page Page Page Page Page Page Page Page Page Writing Tests Testing Devices With Automated Tests Automated Test Execution Testing Communications or Networking With Distributed Tests Client Test Component Remote Test Component Test Description for Distributed Tests Required Distributed Test Keyword remote Attribute remoteSource Attribute executeArgs Attribute Distributed Test Execution Page Testing User Interfaces With Interactive Tests Client Test Component Remote Test Component Test Description for Interactive Tests Required Interactive Test Keywords Interactive Test Execution Page Example of an Interactive Test Testing Application Provisioning With OTA Tests Server Component of an OTA Test Client Test Component of an OTA Test Test Description for OTA Tests Required OTA Test Keyword executeClass Attribute remote Attribute OTA Test Description Examples Page OTA Test Execution Page Example of OTA Test Testing Security-Constrained Functionality With Security Tests Types of Security Tests Untrusted Tests Trusted Tests Double-duty Tests Using Keywords to Mark Security Tests Marking Untrusted Tests Marking Trusted Tests Using an Attribute to Mark Double-Duty Tests Granting or Denying Security Permissions Granting Security Permissions Page Denying Security Permissions Adding Resource Files in Tests Page Page Enabling Test Selection Factors and Mechanisms for Test Selection selectIf Test Selection To Enable Test Selection with the selectIF Expression Page Page Page Page Note Test API Test Status MultiTest J2MEDistributedTest J2SEDistributedTest DistribInteractiveTest Page Framework Bundle lib Directory content). application signing. Core CLDC and MIDP Execution CLDC and MIDP Agents and Clients Plug-ins DTF CommService CommClients CommServers Messaging Test Export Support Libraries CDC Agents src Directory Framework Server Classes and Interfaces Page Communication Channel doc Directory Page Test Description Fields and Keywords Test Description Fields how their values are used by the harness when the tests are run. Page Keywords Page Page Glossary Page Page Page Page Page Page Page Page Page Index Symbols A B C I J K M N