Development Kit User's Guide
for the Binary Release
with Cryptography Extensions

Java CardTM Platform
Version 2.2.1

October, 2003

Contents Previous Next Index



Who Should Use This Book

Before You Read This Book

How This Book Is Organized

Related Books

Typographic Conventions

Accessing Sun Documentation Online

Sun Welcomes Your Comments

1. Introduction to the Development Kit for the Java Card Platform

CAP File Flow

2. Installation

Prerequisites for Installing the Binary Release

Installing the Development Kit Binaries

Files Installed for the Binary Release

Sample Programs and Demonstrations

3. Development Kit Samples and Demonstrations

The Demonstrations

Directories and Files in the demo Directory


Script File for Building Samples

Building the Sample Applets

Compiling the Sample Applets

Converting the Class Files

Running scriptgen to Generate Script Files

Running the Demonstrations

Demo 1

Demo 2

Demo 3

Java Card RMI Demo

Secure Java Card RMI Demo

Object Deletion Demo 1

Object Deletion Demo2

Logical Channels Demo

Demo 2 Cryptography Demo

Photo Card Demo

4. Running Applets in an Emulated Card Environment

Preparing to Run the Java Card WDE Tool

Setting Environment Variables

Configuring the Applets in the Java Card WDE Mask

Running the Java Card WDE Tool

5. Converting Java Class Files

Setting Java Compiler Options

Generating the CAP File’s Debug Component

Running the Converter

Command Line Arguments

Command Line Options

Using a Command Configuration File

File and Directory Naming Conventions

Input File Naming Conventions

Output File Naming Conventions

Verification of Input and Output Files

Creating a debug.msk Output File

Loading Export Files

Specifying an Export Map

6. Viewing an Export File

7. Verifying CAP and Export Files

Verifying CAP Files

Running verifycap

Verifying Export Files

Running verifyexp

Verifying Binary Compatibility

Running verifyrev

Command Line Options for Off-Card Verifier Tools

8. Generating a CAP File from a Java Card Assembly File

Running capgen

Command Line Options

9. Producing a Text Representation of a CAP File

Running capdump

10. Using the Java Card Reference Implementation

Running the Java Card Runtime Environment

Installer Mask

Runtime Environment Command Line

Obtaining Resource Consumption Statistics

Reference Implementation Limitations

Input and Output

Working with EEPROM Image Files

The Default ROM Mask

11. Using the Installer

Installer Components and Data Flow

Running scriptgen

Installer Applet AID

Downloading CAP Files and Creating Applets

Installer APDU Protocol

APDU Responses to Installation Requests

A Sample APDU Script

Deleting Packages and Applets

APDU Responses to Deletion Requests

Installer Limitations

12. Sending and Receiving APDU Commands

Running apdutool

apdutool Examples

Using APDU Script Files

13. Using Cryptography Extensions

Supported Cryptography Classes

Instantiating the Classes

Temporary RAM Usage by Cryptography Algorithms

14. Java Card RMI Client-Side Reference Implementation

The Java Card Remote Stub Object

A. Java Card Assembly Syntax Example

B. CAP File Manifest File Syntax

C. Using the Large Address Space

D. Reference Implementation of Java Card RMI Client-Side API

Package ocfrmiclientimpl

API Documentation










Contents Previous Next Index