For the complete documentation index, see llms.txt. This page is also available as Markdown.

Managing CP applications

Create, package, activate, and manage Commerce Platform applications on VOS3 using the packman tool.

Commerce Platform (CP) applications are HTML and ECMAScript applications that are triggered by a native payment application during idle or transaction flows.

For a full description of the CP runtime model, triggers, and API, refer to the ADK Programmers Guide.

Requirements

Running a CP application on VOS3 requires three separately signed components:

Component

Signing

Description

Payment application

Sponsor-signed

Triggers the CP application at idle or during a transaction

CP application

System-signed

The HTML and ECMAScript application package

CP app activation

Sponsor-signed

Activates a specific CP application for use

Create a CP app

From a zip file

Convert a CP application in legacy ZIP format directly into a DL file:

packman.py cpapp_convert -t vos3 -s dev -z <cpapp-zip> -o <dlfile>

Example:

packman.py cpapp_convert -t vos3 -s dev -z cpapp-123345678.zip -fo dl.cpapp-123345678.tar

From a directory

Build a CP application from a directory like any other VOS3 bundle:

Example:

AppDev variant (APP-DEV devices only)

During development on an APP-DEV device, a CP app can be packaged as an appdev variant. This installs the app to a read-write location on the device, allowing in-place editing without reinstalling.

Convert from a zip file:

Convert from an existing CP app DL file:

When development is complete, convert back to a standard production CP app:

An appdev CP app can also be extracted and rebuilt from a directory using the packman extract and build commands.

Create a CP app removal

Generate a removal DL file from an existing CP app DL file:

Example:

Create a CP app activation

A CP app must be activated before it will run. Generate an activation DL file from the CP app DL file:

Example:

The activation DL file installs an activation file in the usr1 home directory.

Create a CP app activation removal

Generate a de-activation DL file from the activation DL file:

Example:

The de-activation DL file removes the activation file from the usr1 home directory.

Development on APP-DEV devices

A standard CP app package is installed to a read-only location on the device.

An appdev CP app package is installed to a read-write location: /mnt/appdata/versioned/globalshare/cpapps

This allows developers to edit the CP application files directly on the device without needing to reinstall after each change.

Migrating from VOS2

Area

Change

Packaging and signing

VOS2 ZIP packaging and signing is no longer supported. CP applications are regular VOS3 packages installed by any available means (local or remote). Use cpapp_convert to migrate existing ZIP packages.

Activation

CP applications must now be activated by installing a sponsor-signed activation package. This is a new requirement not present on VOS2.

Triggers and API

The internal functioning of CP applications — triggers, API, and ECMAScript behavior — is unchanged from VOS2.

Last updated

Was this helpful?