Generating Application Modules From Classic Applets

Developers use the Normalizer to generate application modules for Java Card 3 Platform classic applets they are creating or from classic applets created for previous versions of the Java Card platform. These application modules contain CAP files and are downloadable on both the Java Card 3 platform Classic Edition and Connected Edition smart cards.

The output from the tool is a classic module that contains the class files, the CAP components of the CAP file, SIO proxies for classic SIOs (if required), and associated classic application descriptors. The input to the tool must be classic CAP files and associated export (EXP) files. If the input files are not classic CAP files, the normalization fails.

Running the Normalizer

The file to invoke the Normalizer is a batch file (normalizer.bat) that must be run from a working directory of JC_CLASSIC_HOME\bin in order for the code to execute properly.

To run the Normalizer:

  1. Enter the following command using the appropriate subcommands and options:

normalizer.bat subcommand [options]

The following is a list of the subcommands for the Normalizer:

  • normalize - Creates the package class files.

  • copyright - Displays detailed copyright notice

  • help - Displays information about the Normalizer command

normalize Subcommands

Use the normalize subcommand and its options to create the package class files. Options are used with the normalize subcommand to specify input files, export paths, export file names, and output directories.

normalize Subcommand Options

Table 6-1 identifies the normalize subcommand options and provides their descriptions.

Table 6-1 normalize Subcommand Options

Option Description

-i file


--in file

Specifies the input CAP file name.

-p path


--exportpath path

Specifies the path of the export files used by the tool.

-f file


--exportfile file

Specifies the export files used by the tool.

-o directory


--out directory

(Optional) This the default setting and does not have to be explicitly set. Specifies the output directory that contains the export file.




Specifies the directory to keep class files, proxy classes, and CAP components. The output format is as follows:

directory/application classes/proxy/[proxy classes]/javacard/ *.cap

normalize Subcommand Format

The following is the format of the normalize subcommand. Options in the subcommand are used in the sequence that are presented in Table 6-1. In this format example, an input file and an output directory are specified as options:

normalizer.bat normalize --in file --out directory

normalize Subcommand Example

The following is an example of the normalize subcommand in which an input file (myCAP.cap) is specified as an option:

normalizer.bat normalize -i myCAP.cap

copyright Subcommand

The copyright subcommand displays the detailed copyright notice. There are no options associated with this subcommand.

help Subcommand

The help subcommand displays information about the Normalizer command. Options are used with the help subcommand to specify the information that is displayed about each subcommand.

Normalizer Summary Help

The following command displays summary help about the Normalizer:

normalizer.bat help

normalize Subcommand Help

The following command displays help about the normalize subcommand:

normalizer.bat help normalize