Java Development Environment

Installation Guide
(V1.9)

Excelsecu Data Technology Co., Ltd.

www.excelsecu.com
 CONFIDENTIAL information of Excelsecu Data Technology Co., Ltd.
NO WARRANTIES OF ANY NATURE ARE EXTENDED BY THIS DOCUMENT. Any product and related
material disclosed herein are only furnished pursuant and subject to the terms and conditions of a
duly executed Program Product Licence or Agreement to purchase or lease equipment. The only
warranties made by Excelsecu Technology, if any, with respect to the products described in this
document are set forth in such Licence or Agreement. Excelsecu Technology cannot accept any
financial or other responsibility that may be the result of your use of the information or software
material, including direct, indirect, special or consequential damages.
You should be careful to ensure that the use of this information and/or software material complies
with the laws, rules, and regulations of the jurisdictions with respect to which it is used. All rights
reserved.
Copyright © 2019 Excelsecu Data Technology Co., Ltd.

www.excelsecu.com
 Table of Contents
1. Overview ................................................................................................................................... 4
2. Development Environment Installation .................................................................................... 4
2.1. Install JDK 8 ................................................................................................................... 4
2.1.1. Description ........................................................................................................ 4
2.1.2. Download and Install JDK 8 ............................................................................... 4
2.1.3. Set Environment Variables ................................................................................ 6
2.2. Install NetBeans 8.2....................................................................................................... 7
2.2.1. Download NetBeans 8.2 .................................................................................... 7
2.2.2. Download and install Java Card Development Kit (JCDK).................................. 8
2.2.3. Set Environment Variables ................................................................................ 9
2.2.4. Notes ............................................................................................................... 10
3. Build Test Demo ...................................................................................................................... 11
3.1. Build Test Demo .......................................................................................................... 11
3.2. Install Test Demo ......................................................................................................... 18

www.excelsecu.com
1. Overview
This document provides the guidelines in Java Card development environment Installation

and how to compile applets using our Java development platform products.

2. Development Environment Installation

2.1. Install JDK 8

2.1.1. Description

Oracle provides the Java Development Kit (JDK) for Linux, Mac OS X, Solaris, and Windows.

What we need to download the Java SE Development Kit 8 (also named JDK 1.8), which can

be used with NetBeans. The download link is:

https://www.oracle.com/technetwork/java/javase/downloads/java-archive-javase8-

2177648.html

2.1.2. Download and Install JDK 8

Click the link to download JDK 8 installation package (Java SE Development Kit 8u202 is

recommended to download):

1. Firstly, make sure that what you are going to download is Java SE Development Kit 8u202,

rather than Java SE Runtime Environment 8u202 (JRE is Java Running Environment. If you

just want to run the Java program or Java Applet, download the JRE. If you need to

develop the Java software by yourself, download the JDK. The JDK contains the JRE).

www.excelsecu.com
2. Select the "Accepting License Agreement", and then download the suitable version for

your system. Here takes the Windows x64 as an example.

3. After downloading, click jdk-8u202-windows-x64.exe to install.

4. Install the JDK according to the prompt, and record your installation path of JDK and JRE.

The installation path will be needed when setting the environment variables.

www.excelsecu.com
2.1.3. Set Environment Variables

After the installation is completed, the setting of environment variables is required.

1. New a JAVA_HOME variable and set JAVA_HOME = C:\ProgramFiles\Java\jdk1.8.0_202

according to the installation path.

www.excelsecu.com
 2. Edit Path variable and add %JAVA_HOME%\bin to the Path variable.

3. New a CLASSPATH variable and add %JAVA_HOME%\lib\dt.jar

and %JAVA_HOME%\lib\tools.jar to it.

2.2. Install NetBeans 8.2

2.2.1. Download NetBeans 8.2

Download address: https://netbeans.org/downloads/8.2/.

See as the following picture, download the corresponding installation package according to

the development language and requirements.

After downloading, install it according to the prompt.

Note:

It is recommended to download the corresponding installation package in the "All" column

on the rightmost, then you do not need to download and install the JCDK (Java Card

Development Kit) plugin. If you download installation package in other column, you will also

need to download and install JCDK plugin.

www.excelsecu.com
 After the installation is completed, the setting of environment variables is required.

2.2.2. Download and install Java Card Development Kit (JCDK)

Open the NetBeans, click “Tools -> Plugins -> Available Plugins”, search “Java Card” in the

“Available Plugins” page, then select “Java Card™” and “Java Card Runtime Bundle” to install.

www.excelsecu.com
2.2.3. Set Environment Variables

After the installation is completed, the setting of environment variables is required.

1. New a JC_HOME variable and set JC_HOME to the JCDK3.0.2_ConnectedEdition folder

directory in the NetBeans installation directory. Example: C:\Program Files\NetBeans

8.2\javacard\JCDK3.0.2_ConnectedEdition

www.excelsecu.com
 2. Edit Path variable and add %JC_HOME%\bin to the Path variable.

3. Edit CLASSPATH variable and add %JC_HOME%\lib\api.jar to it.

2.2.4. Notes

1. Before the installation of Netbeans, JDK version1.8 is needed. Installation method see in

2.1 2.1Install JDK 8.

2. NetBeans internally integrated JCDK version 3.0.2. After the installation is finished, you

can begin to develop your own Java Card Applet.

www.excelsecu.com
3. Build Test Demo
Extended packages, which are not included in standard JCAPI, refer to packages that are

extended by vendors or third parties. The extended API interfaces such as display, keypad

controlling, and Bluetooth communication are defined by Excelsecu Company.

3.1. Build Test Demo

1. Open NetBeans, new a project and select Classic Applet Project.

2. Project name and package name: No requirement. Applet AID: 0xE21A7ED8E712.

www.excelsecu.com
3. Package AID: 0xE21A7ED8E711.

4. Import the agent Package. (Skip this step if the product you are using does not

contain an extension API)

1) Right click the project name, choose Properties -> Project Properties ->

www.excelsecu.com
 Dependencies -> Add.

2) Add Library -> JAR File

www.excelsecu.com
3) Choose the specialmethod.jar which is provided by Excelsecu Company

www.excelsecu.com
4) Choose “Already on Card”.

5) Add cryptoLib.jar, javacardx.jar provided by our company in the same way shown

above. After all the .jar files are added, you can view them in the project's library

directory, as shown below.

www.excelsecu.com
5. Unzip the specialmethod.jar file provided by Excelsecu Company to obtain the following

files.

Note:

Pay attention to the COM folder architecture.

Copy the whole folder com/es/specialmethod/javacard/specialmethod.exp to

\javacard\JCDK3.0.2_ConnectedEdition\api_export_files under the Netbeans installation

path. Must be copied along with the com/es/specialmethod/javacard folder (In the

specialmethod directory, only the javacard folder is reserved, and do not copy the .class files.)

If Netbeans is installed in the default path, you need to copy the whole folder

com/es/specialmethod/javacard/specialmethod.exp to C:\Program Files\NetBeans

8.2\javacard\JCDK3.0.2_ConnectedEdition\api_export_files. The final path is C:\Program

www.excelsecu.com
Files\NetBeans

8.2\javacard\JCDK3.0.2_ConnectedEdition\api_export_files\com\es\specialmethod\javacar

d\specialmethod.exp

Only the path is compliant to \com\es\specialmethod\javacard\specialmethod.exp as

described above can the EXP file be found and compiled successfully in Netbeans.

6. Add the cryptoLib extension package in the same way as adding the specialmethod

extension package. Unzip the cryptoLib.jar package and copy

com/tmc/cryptoLib/javacard/cryptoLib.exp to the

\javacard\JCDK3.0.2_ConnectedEdition\api_export_files folder in the Netbeans

installation path. The resulting path is

\javacard\JCDK3.0.2_ConnectedEdition\api_export_files\com\tmc\cryptoLib\javaca

rd\cryptoLib.exp

Note: Only the path is compliant to com\tmc\cryptoLib\javacard\cryptoLib.exp as

described above can the EXP file be found and compiled successfully in Netbeans.

7. Build applet and compile it to cap file.

www.excelsecu.com
3.2. Install Test Demo

Refer to the Java Applet Installation Guide to install the cap file into the JavaCard product.

www.excelsecu.com