Introduction
Java Card enables secure elements, such as smart cards and other tamper-resistant security chips, to host applications, called applets, which employ Java technology.
Java Card technology offers a secure and interoperable execution platform that can store and update multiple applications on a single resource constrained device, while retaining the highest certification levels and compatibility with standards. Java Card developers can build, test, and deploy applications and services rapidly and securely. This accelerated process reduces development costs, increases product differentiation, and enhances value to customers.
The Java Card Development Kit is a suite of tools for designing implementations of Java Card technology and developing applets based on the Java Card Specifications. It is available as two independent downloads:
- The Java Card Development Kit Tools are used to convert and verify Java Card applications.
- The Java Card Development Kit Simulator offers a testing and debugging reference for Java Card applications. It includes a Java Card simulation environment and Eclipse plug-in.
Together, these two downloads provide a complete, stand-alone development environment in which applications written for the Java Card platform can be developed and tested.
These release notes describe the Java Card Development Kit Tools for the Java Card Platform. The Java Card Development Kit Tools convert and verify Java Card applications. You can use the Java Card Development Kit Tools with products based on version 3.2, 3.1, 3.0.5, and 3.0.4 of the Java Card Specification Classic Edition, as a stand-alone, or in conjunction with the Java Card Development Kit Simulator.
What's New
This topic contains the new features and changes in the Java Card Development Kit Tools.
- New features
- Updated tools to use version 1.6 of Apache
commons-cli
library
- Updated tools to use version 1.6 of Apache
- Issues Fixed
- Fixed a converter issue when using older export file format
than the format v2.3 defined in Java Card 3.1. This issue was triggered
by the following:
- a java package is updated to a newer version and a new method is added to a class of the java package for this update
- and the corresponding export file used to assign
tokens (
-exportmap
parameter) has a format older than 2.3
- Added in verifyrev tool a missing verification when using
older export file format than the format v2.3 defined in Java Card 3.1
to check that the
class_info.CAP22_inheritable_public_method_token_count
matches the number of public virtual methods defined in the previous version of the class. - Fixed a converter issue causing an incorrect mapping of the
implicit abstract methods declared by the implemented interfaces to
their corresponding token defined in the export file specified by
exportmap
parameter - Fixed a converter error message when handling large debug components
- Fixed the converter to ensure the generated Export and CAP files contain only access flags listed in the JCVM specification
- Fixed a converter issue incorrectly using export files
specified by
exportmap
parameter when CAP file has no export component - Fixed security issues in the verifier
- Fixed a converter issue when using older export file format
than the format v2.3 defined in Java Card 3.1. This issue was triggered
by the following:
For a complete list of supported features, refer to the Java Card Development Kit User Guide and Java Card Platform Specification Release Notes.
System Requirements
This product is targeted for use on a PC running the Windows 10 operating system.
The following software must be installed for the Java Card Development Kit Tools to work:
-
Java Development Kit (JDK) – This release has been verified and tested with Oracle JDK 17 (64 bit version) and OpenJDK 17 (64 bit version). Download the JDK software from:
http://www.oracle.com/technetwork/java/javase/downloads
Install it according to the instructions on the website.
-
Apache Ant – This release has been verified and tested with Ant 1.9.13. Download and install Ant from:
Installation
The Java Card specifications, Development Kit Simulator, and Development Kit Tools must be downloaded and installed individually.
Note:
Download and install the Java Development Kit (JDK) prior to installing the Java Card Development Kit Tools. The tools in this development kit were tested with Oracle JDK 17 (64 bit version) and OpenJDK 17 (64 bit version). You can download and install JDK according to the instructions on the website:http://www.oracle.com/technetwork/java/javase/downloads
.
-
See the Downloading the Specification Documents topic of the Java Card Platform Specification Release Notes, for more details on how to download the Java Card Specification bundle.
-
See the Installation topic of the Java Card Platform Development Kit Simulator Release Notes, for more details on how to download and install the Java Card Development Kit Simulator bundle.
-
See the Installation topic of the Java Card Development Kit User Guide, for more details on how to install the Java Card Development Kit Simulator and Java Card Development Kit Tools.
-
The Java Card Development Kit Tools bundle is provided on the Oracle Technology Network download website (
https://www.oracle.com/technetwork/java/embedded/javacard/overview/index.html
). You must extract the downloaded.zip
file to the directory where you have installed the Simulator.
Contents of Java Card Development Kit Tools
This release of the Java Card Development Kit Tools contain development tools that are used to convert and verify CAP files.
The following table describes the files and directories that are installed in the
root installation directory (JC_HOME_TOOLS
).
Directory/File | Description |
---|---|
|
Contains all shell scripts or batch files for running the tools (such as
|
|
Contains license files. |
|
Contains all Java programming language JAR files required for running tools by using the shell scripts or batch files, provided in the |
|
Contains subdirectories each with compilations of the Javadoc tool files for the APDU I/O API and the Java Card Client RMI API. |
Documentation
The Java Card Documentation web site provides online product documentation for the Java Card Platform.
Document | Description |
---|---|
Java Card Development Kit User Guide |
This document describes how to use the Java Card Development Kit to develop applications for Java Card Platform v3.2u1. It is available in HTML and PDF formats. |
Java Card Platform Specifications. |
The following specification documents are available for the Java Card Platform
v3.2u1:
|
Product Information
The Java Card Technology website provides useful information about the Java Card product.
Visit the Java Card Technology website to access the most up-to-date information on the following:
- Product news and reviews
- Release notes and product documentation
Documentation Accessibility
For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.
Access to Oracle Support
Oracle customers that have purchased support have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.
Java Card Development Kit Tools Release Notes, Version 24.0
F74150-06
February 2024
Copyright © 2024, Oracle and/or its affiliates.