JarCasting
JarCasting JarCasting

ant-javacard

ANT task for JavaCard build, ph4r05 fork

License

License

MIT
Categories

Categories

Ant Build Tools
GroupId

GroupId

com.klinec
ArtifactId

ArtifactId

ant-javacard
Last Version

Last Version

18.3.20
Release Date

Release Date
Type

Type

jar
Description

Description

ant-javacard
ANT task for JavaCard build, ph4r05 fork
Project URL

Project URL

https://github.com/ph4r05/ant-javacard
Source Code Management

Source Code Management

https://github.com/ph4r05/ant-javacard

Download ant-javacard

Filename Size
ant-javacard-18.3.20.pom
ant-javacard-18.3.20.jar 17 KB
ant-javacard-18.3.20-sources.jar 7 KB
ant-javacard-18.3.20-javadoc.jar 31 KB
Browse

How to add to project

<!-- https://jarcasting.com/artifacts/com.klinec/ant-javacard/ -->
<dependency>
    <groupId>com.klinec</groupId>
    <artifactId>ant-javacard</artifactId>
    <version>18.3.20</version>
</dependency>
// https://jarcasting.com/artifacts/com.klinec/ant-javacard/
implementation 'com.klinec:ant-javacard:18.3.20'
// https://jarcasting.com/artifacts/com.klinec/ant-javacard/
implementation ("com.klinec:ant-javacard:18.3.20")
'com.klinec:ant-javacard:jar:18.3.20'
<dependency org="com.klinec" name="ant-javacard" rev="18.3.20">
  <artifact name="ant-javacard" type="jar" />
</dependency>
@Grapes(
@Grab(group='com.klinec', module='ant-javacard', version='18.3.20')
)
libraryDependencies += "com.klinec" % "ant-javacard" % "18.3.20"
[com.klinec/ant-javacard "18.3.20"]

Dependencies

compile (1)

Group / Artifact Type Version
org.apache.ant : ant jar 1.8.2

Project Modules

There are no modules declared in this project.

Building JavaCard applet CAP files with Ant

Easy to use Ant task for building JavaCard CAP files in a declarative way.

Build status   Coverity   Latest release   Maven Central   MIT licensed

Features

  • Do What I Mean. You will love it!
  • No dependencies, no extra or unrelated downloads. Just a 14KB jar.
  • Supports all available JavaCard SDK versions: 2.1.2, 2.2.1, 2.2.2, 3.0.3, 3.0.4 and 3.0.5
  • Works on all platforms with Java 1.8: Windows, OSX, Linux.
  • Almost everything integrates or works with Ant.
  • Can be easily integrated into continuous integration workflows.
  • Generates CAP files from sources or pre-compiled class files.
  • Import external libraries: natural use of .exp files and .jar libraries.
  • No restrictions on project folder layout.
  • Loading JavaCard applets is equally pleasing with GlobalPlatformPro

Maven repository

This is Ph4r05 build:

<dependency>
  <groupId>com.klinec</groupId>
  <artifactId>ant-javacard</artifactId>
  <version>1.8.0</version>
</dependency>

Gradle:

compile group: 'com.klinec', name: 'ant-javacard', version: '1.8.0'

Download & Use

<get src="https://github.com/martinpaljak/ant-javacard/releases/download/18.01.17/ant-javacard.jar" dest="." skipexisting="true"/>
  • Then add the following to your build.xml file:
<taskdef name="javacard" classname="pro.javacard.ant.JavaCard" classpath="ant-javacard.jar"/>
  • Now you can create applets within your Ant targets like this:
<javacard>
  <cap jckit="/path/to/jckit_dir" aid="0102030405" output="MyApplet.cap" sources="src/myapplet">
    <applet class="myapplet.MyApplet" aid="0102030405060708"/>
  </cap>
</javacard>

(which results in output similar to this)

target:
      [cap] INFO: using JavaCard v2.2.2 SDK in ../jc222_kit
      [cap] Setting package name to testapplets
      [cap] Building CAP with 1 applet from package testapplets
      [cap] testapplets.Empty 0102030405060708
  [compile] Compiling 1 source file to /var/folders/l7/h99c5w6j0y1b8_qbsth_9v4r0000gn/T/antjc4506897175807383834
      [cap] CAP saved to /Users/martin/projects/ant-javacard/Empty222.cap

Syntax

Sample:

<javacard jckit="/path/to/jckit_dir1">
  <cap jckit="/path/to/jckit_dir2" aid="0102030405" package="package.name" version="0.1" output="MyApplet.cap" sources="src/myapplet" classes="path/to/classes" export="mylib">
    <applet class="myapplet.MyApplet" aid="0102030405060708"/>
    <import exps="path/to/exps" jar="/path/to/lib.jar"/>
  </cap>
</javacard>

Details:

  • javacard tag - generic task
    • jckit attribute - path to the JavaCard SDK that is used if individual cap does not specify one. Optional if cap defines one, required otherwise.
  • cap tag - construct a CAP file
    • jckit attribute - path to the JavaCard SDK to be used for this CAP. Optional if javacard defines one, required otherwise.
    • sources attribute - path to Java source code, to be compiled against the current JavaCard SDK. Either sources or classes is required.
    • classes attribute - path to pre-compiled class files to be assembled into a CAP file. If both classes and sources are specified, compiled class files will be put to classes folder, which is created if missing.
    • package attribute - name of the package of the CAP file. Optional - set to the parent package of the applet class if left unspecified.
    • version attribute - version of the package. Optional - defaults to 0.0 if left unspecified.
    • aid attribute - AID (hex) of the package. Recommended - or set to the 5 first bytes of the applet AID if left unspecified.
    • output attribute - path where to save the generated CAP file. Required.
    • export attribtue - path (folder) where to place the JAR and generated EXP file. Optional.
    • jar attribute - path where to save the generated archive JAR file. Optional.
    • jca attribute - path where to save the generated JavaCard Assembly (JCA) file. Optional.
    • verify attribute - if set to false, disables verification of the resulting CAP file with offcardeverifier. Optional.
    • debug attribute - if set to true, generates debug CAP components. Optional.
    • ints attribute - if set to true, enables support for 32 bit int type. Optional.
  • applet tag - for creating an applet inside the CAP
    • class attribute - class of the Applet where install() method is defined. Required.
    • aid attribute - AID (hex) of the applet. Recommended - or set to package aid+i where i is index of the applet definition in the build.xml instruction
  • import tag - for linking against external components/libraries, like GPSystem or OPSystem
    • exps attribute - path to the folder keeping .exp files. Required
    • jar attribute - path to the JAR file for compilation. Optional - only required if using sources mode and not necessary with classes mode if java code is already compiled

Notes:

  • jc.home property has the highest precedence, followed by jckit path of cap, followed by path in javacard, followed by JC_HOME environment variable. SDK must be valid to be considered for use.

License

Happy users

A random list of users, with a public link:

Contact

Similar projects

  • standard JavaCard SDK Ant tasks
    • :( as cumbersome to use as the command line utilities
    • :( not declarative/DWIM enough
    • :) very explicit interface with all details exposed
  • JavaCard Gradle plugin (MIT) - https://github.com/bertrandmartel/javacard-gradle-plugin
    • :) Wraps ant-javacard for use with Gradle
  • gradle-javacard (Apache 2.0) - https://github.com/fidesmo/gradle-javacard
    • :) nice declarative interface
    • :( requires gradle (40M download)
    • :( JavaCard 2.2.2 only
  • EclipseJCDE (Eclipse 1.0) - http://eclipse-jcde.sourceforge.net/
    • :( JavaCard 2.2.2 only
    • :( not possible to integrate in CI - depends on eclipse
    • :( essentially an Eclipse GUI wrapper for JC SDK
  • JCOP Tools
    • :( not open source
  • NetBeans IDE JC support
    • :( not possible to integrate into CI
    • :( JavaCard 3.0 only
    • :( Netbeans, not cross platform
  • Maven2 task from FedICT (LGPL3) - https://code.google.com/p/eid-quick-key-toolset
    • :( Maven downloads half the internet before even simple tasks
    • :( JavaCard 2.2.2 only
  • Ant script files with templates
    • :( XML is a very bad and verbose programming environment

Versions

Version
18.3.20
1.8.0