Eclipse Java Card Plug-in

The development kit includes an Eclipse plug-in to assist you in developing Java Card applications. Almost all of the choices presented by the plug-in dialogs correspond to command-line options of the development kit tools (cref, converter, scriptgen and apdutool) which are described elsewhere in this user guide. The plug-in runs those tools with the options that you select.

This section includes procedures for performing the following tasks:

Installing the Eclipse Plug-in

The Eclipse plug-in provides a convenient way to develop Java Card applets. To install the plug-in:

  1. In the Eclipse menu bar, select Help, and then select Install New Software.
  2. Click Add.
  3. Click Archive.
  4. Select the development kit’s Eclipse plug-in repository file:


  5. On the Add Repository dialog, type Java Card SDK in the Name field.
  6. Click OK.
  7. On the Available Software dialog, select the feature to install:

    Oracle Java Card Tools for Eclipse IDE

  8. Click Next until the terms of the licenses are displayed.
  9. Accept the terms of the licenses and click Finish to complete installation.
  10. When the software has been installed, Eclipse will prompt you to restart. Click Yes.

Configuring Sample_Platform and Sample_Device

When you create a Java Card project in Eclipse, you must identify the platform, which is the location of the development kit, and provide settings for the device that the simulator will create. You may have more than one simulated device associated with a platform.

When you start Eclipse with the plug-in installed, the plug-in creates
  • Sample_Platform, which points to the directory that is set in the JC_CLASSIC_HOME environment variable, and

  • Sample_Device, which contains the settings for cref (the simulator). See Using the Reference Implementation for more information about cref and its options.

Sample_Platform and Sample_Device are used for running samples, but you can use them for your own programs too. If they are not created successfully, create them manually using the instructions below.

To change the directory of the Java Card platform or the device settings for a project:

  1. In Eclipse, from the Window menu, select Preferences.
  2. In the Preferences dialog, click on the arrow to the left of Java Card Platforms.
  3. Now you can select Java Card Platforms to add, delete or update platforms, and Java Card Devices to add, delete or update the simulated device settings.