ant-javacard

Easy to use Ant task for building JavaCard applets

License	License MIT
Categories	Categories Ant Build Tools
GroupId	GroupId com.github.martinpaljak
ArtifactId	ArtifactId ant-javacard
Last Version	Last Version 19.05.08
Release Date	Release Date May 8, 2019
Type	Type jar
Description	Description ant-javacard Easy to use Ant task for building JavaCard applets
Project URL	Project URL https://github.com/martinpaljak/ant-javacard
Source Code Management	Source Code Management https://github.com/martinpaljak/ant-javacard

Download ant-javacard

Filename	Size
ant-javacard-19.05.08.pom
ant-javacard-19.05.08.jar	19 KB
ant-javacard-19.05.08-sources.jar	7 KB
ant-javacard-19.05.08-javadoc.jar	43 KB
Browse

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.github.martinpaljak/ant-javacard/ -->
<dependency>
    <groupId>com.github.martinpaljak</groupId>
    <artifactId>ant-javacard</artifactId>
    <version>19.05.08</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.github.martinpaljak/ant-javacard/
implementation 'com.github.martinpaljak:ant-javacard:19.05.08'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.github.martinpaljak/ant-javacard/
implementation ("com.github.martinpaljak:ant-javacard:19.05.08")

Apache Buildr

'com.github.martinpaljak:ant-javacard:jar:19.05.08'

Apache Ivy

<dependency org="com.github.martinpaljak" name="ant-javacard" rev="19.05.08">
  <artifact name="ant-javacard" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.github.martinpaljak', module='ant-javacard', version='19.05.08')
)

Scala SBT

libraryDependencies += "com.github.martinpaljak" % "ant-javacard" % "19.05.08"

Leiningen

[com.github.martinpaljak/ant-javacard "19.05.08"]

Dependencies

compile (1)

Group / Artifact	Type	Version
com.github.martinpaljak : capfile	jar	19.03.04

provided (3)

Group / Artifact	Type	Version
org.apache.ant : ant Optional	jar	1.8.2
com.google.code.findbugs : annotations	jar	3.0.1u2
com.google.code.findbugs : jsr305	jar	3.0.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.

Features

Do What I Mean. You will love it!
No dependencies, no extra or unrelated downloads. Just a 46KB jar.
Supports all available JavaCard SDK versions: 2.1.2, 2.2.1, 2.2.2, 3.0.3, 3.0.4, 3.0.5 and 3.1
- Get one from oracle.com or use the handy Github repository
Works on all platforms with Java 1.8+: Windows, OSX, Linux.
- Usable SDK-s depend on JDK version; 1.8 recommended!
Almost everything integrates or works with Ant.
- Trigger it from Maven or via Gradle wrapper
Can be easily integrated into continuous integration workflows.
Generates CAP files from sources or pre-compiled class files.
Import external libraries: natural use of .jar libraries and/or .exp files.
No restrictions on project folder layout (but src/main/javacard works).
Loading JavaCard applets is equally pleasing with GlobalPlatformPro

Download & Use

Download ant-javacard.jar
- Java version usable with all SDK-s is 1.8! Use SDK 3.0.5u3 and targetsdk to compile with Java 10 for older versions.
Or use the download task:

<get src="https://github.com/martinpaljak/ant-javacard/releases/latest/download/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">
    <applet class="myapplet.MyApplet" aid="0102030405060708"/>
  </cap>
</javacard>

(which results in output similar to this)

target:
      [cap] INFO: using JavaCard 3.0.4 SDK in sdks/jc304_kit
      [cap] INFO: targeting JavaCard 2.2.2 SDK in sdks/jc222_kit
      [cap] Setting package name to testapplets.empty
      [cap] INFO: generated applet AID: A000000617008E5CDAAE01 for testapplets.empty.Empty
      [cap] Building CAP with 1 applet from package testapplets.empty (AID: A000000617008E5CDAAE)
      [cap] testapplets.empty.Empty A000000617008E5CDAAE01
  [compile] Compiling files from /Users/martin/projects/ant-javacard/src/testapplets/empty
  [compile] Compiling 1 source file to /var/folders/gf/_m9mq9td3lz32qv1hd4r12yw0000gn/T/jccpro841338375581620546
  [convert] [ INFO: ] Converter [v3.0.4]
  [convert] [ INFO: ]     Copyright (c) 2011, Oracle and/or its affiliates. All rights reserved.
  [convert]
  [convert]
  [convert] [ INFO: ] conversion completed with 0 errors and 0 warnings.
 [javacard] NB! Please use JavaCard SDK 3.0.5u3 or later for verifying!
      [cap] CAP saved to /Users/martin/projects/ant-javacard/Empty_A000000617008E5CDAAE_50da91a4_2.2.2.cap

Syntax

Sample:

<javacard jckit="/path/to/jckit_dir1">
  <cap targetsdk="/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. Optional if javacard defines one, required otherwise.
- targetsdk attribute - path to the target JavaCard SDK to be used for this CAP. Optional, value of jckit used by default. Allows to use a more recent converter to target older JavaCard platforms.
- sources attribute - path to Java source code, to be compiled against the JavaCard SDK. Either sources or classes is required, unless src/main/javacard exists.
- sources2 attribute - additional sources to build per-platform applets. Optional.
- 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.
- includes attribute - comma or space separated list of patterns of files that must be included.
- excludes attribute - comma or space separated list of pattersn of files that mus be excluded.
- package attribute - name of the package of the CAP file. Optional for applets - set to the parent package of the applet class if left unspecified, required for libraries
- version attribute - version of the package. Optional - defaults to 0.1 if left unspecified.
- fidesmoappid attribute - Fidesmo appId, to create the package AID and applet AID-s automatically. Optional.
- 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. Optional, see below for variables.
- 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.
- javaversion attribute - override the Java source and target version. 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. Optional. Required if file in jar does not include .exp files.
- jar attribute - path to the JAR file for compilation. 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.

Output file name variables

%h - 8 character prefix of the SHA-256 Load File Data Block hash of the CAP file
%H - SHA-256 Load File Data Block hash of the CAP file
%n - common name of the entity, either applet class or package
%p - package name
%a - package AID
%j - targeted JavaCard version

License

Happy users

A random list of users, with a public link:

Applets:
- IsoApplet by @philipWendland
- NdefApplet by @promovicz
- GidsApplet by @vletoux
- LedgerWalletApplet by @LedgerHQ
- KeePassNFC by @nfd
- PivApplet (PIV) by @arekinath
- OpenFIP201 (PIV) by @makinako
- Cryptonit (PIV) by @mbrossard
- HTOP NDEF by @petrs
- Yubikey OTP by @arekinath
- SmartPGP by @ANSSI-FR
- SatochipApplet (Bitcoin Hardware Wallet) by @Toporin
- Plus loads of academic projects, classes and papers.
Integration projects:
- JavaCard Gradle plugin by @bertrandmartel
- JavaCard Template project with Gradle by @ph4r05
Other:
- You! Don't torture yourself with complexity, KISS!

Contact

See javacard.pro

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
19.05.08 May 8, 2019
19.03.04 Mar 4, 2019
18.09.25 Feb 25, 2019
18.07.12 Jul 12, 2018
18.06.25 Jun 25, 2018
18.06.18 Jun 18, 2018
18.05.01 May 2, 2018
18.03.19 Mar 19, 2018
18.01.17.1 Jan 17, 2018

ant-javacard

License

Categories

GroupId

ArtifactId

Last Version

Release Date

Type

Description

Project URL

Source Code Management

Download ant-javacard

How to add to project

Dependencies

compile (1)

provided (3)

Project Modules

Building JavaCard applet CAP files with Ant

Features

Download & Use

Syntax

Output file name variables

License

Happy users

Contact

Similar projects

Versions