Development Kit for the Java Card™ Platform
These release notes describe the Development Kit for the Java Card™ Platform, Version 2.2.2. This binary release is available in separate bundles for the Solaris™, Linux, and Microsoft Windows operating systems. These release notes pertain to both the development kit binary release and the development kit binary release with cryptography extensions. Issues that are marked (Development Kit with Cryptography Extensions only) pertain only to the Development Kit Binary Release with Cryptography Extensions, Version 2.2.2.
The development kit runs on a workstation using a Java™ Virtual Machine (VM). The virtual machine for the Java Card platform, version 2.2.2, is written in the "C" programming language. For more details on the reference implementation (RI), please refer to the User's Guide that is installed with this kit.
Java Development Kit software: Java™ 2 Standard Edition (J2SE™) SDK, version 1.5. You can download the supported SDK from here.
This release was built using gcc version 3.2.3 on Windows, 3.2.2 on Linux, and the Sun™ Studio 10: C 5.7 Compiler on Solaris. The GNU Compiler Collection, gcc, can be obtained at http://gcc.gnu.org .
NOTE: The Linux platform version was tested on the English language SuSE Linux, kernel 2.6.5-7.139, and gcc version 3.2.2. The Linux platform version is unsupported; Sun Microsystems may choose not to address problems or bug reports submitted against the Linux platform version.
No specific card readers are supported.
For detailed instructions on installing the binary release, see Chapter 2, "Installation" in the Development Kit User's Guide that is included with this development kit. That chapter also describes any additional tools you might need for setting up your environment, such as Apache Ant. See the Development Kit User's Guide or Ant Tasks User's Guide for more information on Apache Ant installation and setup.
These release notes are at the base of a hierarchy of files in the unzipped download bundle. Within the subdirectory java_card_kit-2_2_2 you will find several additional bundles: the Java Card specifications, the development kit documentation, the Ant Tasks, and the Java Card platform binary code itself. You must unzip all these bundles in the subdirectory java_card_kit-2_2_2 to have full use of this development kit.
Documentation for version 2.2.2 of the Java Card platform binary release can be found in the development kit documentation bundle, the Ant tasks bundle, and the specification bundle. Note that the specifications within this download bundle are identical to the specifications available for separate download from the Java Card technology download web site.
Most documents are available in both HTML and PDF formats. HTML can be viewed with any CSS-compliant browser, such as:
PDF files can be viewed in your web browser with an appropriate plugin or in Adobe® Acrobat Reader. Most recent browsers include the PDF reader plugin. If your browser does not, you can download the plugin from the browser vendor's web site or the Adobe web site at
Documentation files packaged in the release were current when the release shipped. See any updates for the Java Card technology web site at
The following table lists the main binary release documentation, which is in the subdirectory java_card_kit-2_2_2/doc.
|Development Kit User’s Guide, Version 2.2.2||
The Javadoc™ tool files for the Java Card remote method invocation (Java Card RMI) client-side API are also included in HTML format and in PDF format.
|Application Programming Notes, Version 2.2.2
||Contains tips and guidelines for the applet developer who is using the Java Card Application Programming Interface for the Java Card Platform, Version 2.2.2, to implement applet management, multiselectable applets, logical channels and Java Card RMI. It is also for developers who are considering creating a vendor-specific framework based on any of the version 2.2.2 Java Card technology specifications.
The Javadoc tool files for the APDU I/O API are also included in HTML format and in PDF format.
The development kit tools require the use of Apache Ant. However, the Ant tasks in the Ant tasks bundle are not part of the development kit and their use is optional and unsupported. See the Apache web site at http://ant.apache.org for information on Ant.
The Ant tasks bundle unzips within the binary release bundle at java_card_kit-2_2_2/ant-tasks. When you unzip the Ant tasks bundle, the Ant tasks' Java Archive (JAR) file is extracted into the subdirectory java_card_kit-2_2_2/ant-tasks/lib/jctasks.jar. The user's guide for the Ant tasks is extracted into the subdirectory java_card_kit-2_2_2/ant-tasks /docs. For more information, see Ant Tasks User's Guide.NOTE:Ant Tasks User's Guide
|Ant Tasks User's Guide, Version 2.2.2||Describes how to use the Ant tasks in the development kit to create your own, customized Ant tasks. The Javadoc tool files for the Ant tasks API are also included in HTML format and in PDF format.|
|Ant Tasks Release Notes, Version 2.2.2||Describes the purpose and limitations of the Ant tasks provided with the development kit. While the Ant tasks are necessary to run the development kit, they are unsupported for use outside the development kit.|
These documents are included in the specification bundle that is included with this binary release, as well as in the separately downloadable specification bundle. The specification bundle unzips into the subdirectory java_card_kit-2_2_2/jc_specification.
|Release Notes for the Java Card Specifications, Version 2.2.2||Describes changes to the specifications since Version 2.2.1 of the specifications.|
|Application Programming Interface for the Java Card Platform, Version 2.2.2||Provides the documentation for the Java Card API in PDF and HTML formats.|
|Virtual Machine Specification for the Java Card Platform, Version 2.2.2||Assists developers in creating an implementation, developing a specification to extend the Java Card technology specifications, or in creating an extension to the Java Card runtime environment. The specification is provided in PDF and HTML formats.|
|Runtime Environment Specification for the Java Card Platform, Version 2.2.2||Assists Java Card runtime environment implementers in creating an implementation, developing a specification to extend the Java Card technology specifications, or in creating an extension to the Java Card runtime environment. The specification is provided in PDF and HTML formats.|
The development kit documentation references the following white papers. You can obtain these white papers from the Java Card technology web site at here.
|Off-Card Verifier White Paper||This white paper describes the off-card verifier for the Java Card platform. The off-card verifier provides the functionality for verifying that Java Card applets (CAP files) and export files conform to the Java Card specifications and platform interoperability standards.|
|Java Card RMI Client Application Programming Interface||This white paper describes a sample client-side API to be used in client applications which access a Java Card Remote Method Invocation (RMI) server applet executing on the smart card. This API is presented as an aid to developers who are writing their own client-side API.|
|6301113||Error T=0 CASE 2 APDU with Le > 0xF9 : CadT0Client.isoOut only supports Le up to 249.|
|6316626||Apdutool script must follow ISO format.|
|6324856||Apduio/apdutool cannot handle T=0, Case 4 with Lc < 256, Le > 256.|
|6322909||T=0, CASE 4 with Le=00 (256) should be short case (4S).|
|6393099||Maskgen builds mask with negative remaining ROM space.|
|6395309||In T=0 apdu.setOutgoingNoChaining() does not return 256, applet implements ExtendedLength interface.|
|6357521||Contactless interface activation before contacted interface activation is not supported in the C-language Java Card Runtime Environment ( cref) or the Java Card WDE at this time.|
Visit the product web site at:
For the most up-to-date information on: