Skip to content

Install applet from the Store

Aiosa edited this page Jul 16, 2020 · 3 revisions

To install an applet, simply select any product from the store or click on the "install from this PC" icon. This will install the latest applet version of the latest SDK (smart card API library) version. In case you need a lower SDK version due to compatibility reason, select a custom installation at the bottom. We do not recommend installing older applet versions.

The process

At first, the files are verified using PGP signatures - that means, the store makes sure no one maliciously modified the software you are going to install on your card. When installing from the store, the verification is performed before the dialog window is shown. When installing from your PC, the signing happens after.

The second step is the applet compatibility verification. Then, the installation window is displayed that informs the user about both previous checks.

After submitting the installation dialog window, the free persistent memory is evaluated first. To do so, we install JCMemory applet onto your card and obtain the free space size. If there is possibility that the installation fails due to low memory, you are notified. However, this method is not 100% accurate as we cannot possibly know the space occupied by the installed instance; and the memory size detection is limited to 32,767 bytes.

If you have checked the keep JCMemory in store settings, the JCMemory remains on your card. The application itself is minimalistic; we recommend you to keep it in order to speed up installations.


Advanced instalation settings

You do not need this feature if you are not an advanced user (or the applet use guide says otherwise). The values that are used in the advanced settings are hexadecimal numbers. That is, valid characters are 123456789ABCDEFabcdef only.

Applets checkboxes: select the applet(s) to install if more available. Also, custom AID is supported.

Installation parameters: is a value passed to the application when installing. The target applet use info section in store provides necessary information.

Force installation: will install the applet using force. That is, any applet that would block the installation is removed first (keep this checked for reinstall).

Custom signature file: available when custom-installing. You can attach detached signature file to auto-verify the signature. The process requires you to have GPGnu installed and necessary key imported. We do not support auto-importing as we will not touch anyone's keyring.


FAQ: The signature verification fails

The verification is not performed: you need to have GnuPG installed and the store needs to be able to launch it (rights restrictions).

Missing file: something or somebody probably modified your local copy of the store. Re-download the store before proceeding.

Signature failed: make sure you have the required key in your GnuPG keyring.

Clone this wiki locally