Installing the Smart Card Scripting Environment for Eclipse (SSE4E)

The SSE4E is a plug-in for Eclipse that provides a script and profile development environment for the Smart Card Shell.

Requirements

Java Runtime

The Smart Card Shell requires a Java Runtime Environment (JRE), which is version 1.6 at minimum. The PC must fulfill the usual requirements of an office system.

Eclipse

The plug-in can be used with Eclipse 3.2 or higher. It has been tested to work with the Eclipse IDE for Java (80MB) and the Eclipse Platform Runtime Binary (40MB).

Card Reader

You will need a contact or contactless smart card reader with PC/SC or CT-API driver. PC/SC readers are supported by the default installation.

For CT-API card readers you will need to enter the correct CT-API DLL or shared object into the OCF configuration file. See the configuration documentation for supported readers and special configuration options.

Installing the Plug-In

The plug-in can be installed from within Eclipse using the "Software Update" mechanism.

Installing from Update Site

The update site for the plug-in is located at

http://www.openscdp.org/eclipse

Follow these steps to download an install the plug-in:

Start Eclipse
Select "Help" / "Software Updates" / "Find and Install"
Choose "Search for new features to install" and click "Next"
Press "New Remote Site..."
Enter the name "OpenSCDP" and the URL from above
Activate the update site on the list and press "Finish"
Select the plug-in to install

Installing from Archive Site

An archive of the update site can be used to install the plug-in from a local file. This way is recommended if your Eclipse has no connection to the Internet.

Follow these steps to install the plug-in:

Start Eclipse
Select "Help" / "Software Updates" / "Find and Install"
Choose "Search for new features to install" and click "Next"
Press "New Archive Site..."
Select the archive of the update site
Activate the update site on the list and press "Finish"
Select the plug-in to install

To get started we recommend to download and install the OpenSCDP Script Collection. It contains valuable scripts for common card applications.

Release Notes

This software is still beta and in testing phase. The documentation is not yet completed.

The following features are provided:

JavaScript Editor

Syntax Highlighting for JavaScript
Hyperlink Help by pressing CTRL and moving the cursor over a keyword
Syntax checking when saving files

XML Profile Editor

Syntax Highlighting for XML and JavaScript enclosed by <Script> or <Testscript> tags
Hyperlink Help by pressing CTRL and moving the cursor over a keyword
XML-Validation and JavaScript syntax checking when saving files
XML-Schema and DTD validation if schema or DTD is specified in XML header
XML-Catalog with GP Profile Schema in version 1.1.0 and 1.2.0 included

Project Browser

Wizard to create SSE4E Projects, JavaScript and XML files
Add SSE4E nature to existing Eclipse projects
Run scripts from launch configuration

Shell Console

Shell interpreter and synchronous script executor
Tracer console

Preferences

Reader selection

Restrictions and known Problems

Cursor movement in the shell console does not update as expected. This is an Eclipse issue, that can not be resolved. Entering commands still works, as the cursor moves to the correct position at the first key stroke.