34ba616e48
Drops gpapi-globalplatform 1.7 and gpapi-upgrade 1.1 (AMD-H Amendment H v1.1) under applet/build-tools/gp-amdh/, sourced from OpenJavaCard/globalplatform-exports (master snapshot 2020-09-30). - dt-mvn.sh mounts exports/org/ into the converter's api_export_files/. - pom.xml adds the .jar files as system-scope deps under the j3r452 profile so javac on j3r452 builds resolves org.globalplatform.upgrade symbols (j3r180 builds don't see them on classpath). - .gitignore: narrow build-tools/ exclusion to top-level only so the new applet/build-tools/gp-amdh/ tree is trackable while the top-level build-tools/jcardsim/ vendor fork stays out of the repo. This commit alone produces zero CAP bytecode change because no current source imports org.globalplatform.*. The infra is provably inert until the Task 3.1+ source on feat/amd-h-epic-3-wip is merged. Verified by diffing CAP zip components for both profiles: only the embedded Java-Card-CAP-Creation-Time timestamp in META-INF/MANIFEST.MF differs. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
66 lines
2.7 KiB
Markdown
66 lines
2.7 KiB
Markdown
# GlobalPlatform Amendment H exports (vendored)
|
|
|
|
This directory ships GlobalPlatform API exports and stub JARs needed to compile
|
|
Aliro applet source against `org.globalplatform.*` and
|
|
`org.globalplatform.upgrade.*` (Amendment H — ELF Upgrade).
|
|
|
|
The `vivokey/smartcard-ci` Docker image does not include these exports, so we
|
|
vendor them here and bind-mount / classpath them in at build time.
|
|
|
|
## Files
|
|
|
|
| Path | Source artifact | Notes |
|
|
|------|-----------------|-------|
|
|
| `exports/org/globalplatform/javacard/globalplatform.exp` | `org.globalplatform-1.7/exports/...` | Converter export file, GP base API v1.7 |
|
|
| `exports/org/globalplatform/upgrade/javacard/upgrade.exp` | `org.globalplatform.upgrade-1.1/exports/...` | Converter export file, AMD-H Upgrade API v1.1 |
|
|
| `lib/gpapi-globalplatform.jar` | `org.globalplatform-1.7/gpapi-globalplatform.jar` | Stub classes for javac classpath |
|
|
| `lib/gpapi-upgrade.jar` | `org.globalplatform.upgrade-1.1/gpapi-upgrade.jar` | Stub classes for javac classpath |
|
|
|
|
## Version selection
|
|
|
|
AMD-H v1.1 targets **GlobalPlatform Card Specification v2.3.1**, which exposes
|
|
the v1.7 base API. Pairing **base 1.7 + upgrade 1.1** is the canonical combo;
|
|
see `GPC_2.3_H_ELF_Upgrade_v1.1_PublicRelease.pdf` in the project root for the
|
|
specification text.
|
|
|
|
## Provenance
|
|
|
|
All four files were extracted verbatim from the `master` snapshot of the
|
|
public repository:
|
|
|
|
https://github.com/OpenJavaCard/globalplatform-exports
|
|
|
|
specifically from these subdirectories:
|
|
|
|
* `org.globalplatform-1.7/`
|
|
* `org.globalplatform.upgrade-1.1/`
|
|
|
|
The local zip used to extract them (`globalplatform-exports-master.zip`) was
|
|
fetched on 2020-09-30 (mtime of the archive entries). File sizes match the
|
|
upstream manifest:
|
|
|
|
43749 gpapi-globalplatform.jar
|
|
12638 gpapi-upgrade.jar
|
|
6641 globalplatform.exp
|
|
1705 upgrade.exp
|
|
|
|
## License
|
|
|
|
These artifacts are GlobalPlatform-published API descriptors / stubs and are
|
|
governed by the GlobalPlatform Specification license under which AMD-H v1.1
|
|
was released. The corresponding specification PDF
|
|
(`GPC_2.3_H_ELF_Upgrade_v1.1_PublicRelease.pdf`) lives at the project root and
|
|
documents the licensing terms.
|
|
|
|
## How the build consumes these files
|
|
|
|
* `applet/scripts/dt-mvn.sh` bind-mounts `exports/org/` into the Docker
|
|
image at `/app/sdks/jc305u3_kit/api_export_files/org` so the ant-javacard
|
|
converter can resolve `org.globalplatform.*` package imports during CAP
|
|
conversion.
|
|
* `applet/pom.xml` declares the two `.jar` files as `system`-scope
|
|
dependencies under the `j3r452` Maven profile only, so javac on j3r452
|
|
builds resolves the symbols. The `j3r180` profile never adds the JARs to
|
|
its classpath — its CAP cannot depend on AMD-H because the J3R180 OS does
|
|
not implement the Upgrade API.
|