RIA Packager

Package for creating Adobe AIR packages

Overview

Creates AIR packages from the packaged files, and an AIR SDK if necessary.

When an AIR SDK is necessary, it can use a directory containing an AIR SDK, or an AIR SDK archive (shockpkg package file).

Reading DMG SDK packages is only supported on macOS, using ZIP packages instead is recommended.

Not all possible package formats are supported, and some have individual limitations.

Some packagers have extra features which can optionally be enabled for things the official packager does not support.

This package is not as strict about various things and will allow packaging applications that the official packager would reject as invalid.

Currently there is no option for creating license files for packaging HARMAN SDK runtimes.

Usage

AIR Installer

1import {readFile} from 'node:fs/promises';
2import {
3	PackagerAirInstaller,
4	SecurityKeystorePkcs12
5} from '@shockpkg/ria-packager';
6
7const packager = new PackagerAirInstaller('application.air');
8packager.descriptorFile = 'src/application-app.xml';
9packager.keystore = SecurityKeystorePkcs12.decode(
10	await readFile('key.p12'),
11	'password'
12);
13packager.timestampUrl = 'http://timestamp.digicert.com/';
14
15// Options:
16packager.profile = 'extendedDesktop';
17
18await packager.write(async packager => {
19	await packager.addResourceFile('src/main.swf', 'main.swf');
20	await packager.addResourceDirectory('src/icons', 'icons');
21});

Bundle (Captive Runtime)

Limitations:

• Native extensions not supported.

Bundle Windows

1import {readFile} from 'node:fs/promises';
2import {
3	PackagerBundleWindows,
4	SecurityKeystorePkcs12
5} from '@shockpkg/ria-packager';
6
7const packager = new PackagerAdlWindows('application');
8packager.descriptorFile = 'src/application-app.xml';
9packager.sdkPath = 'airsdk-win.zip';
10packager.keystore = SecurityKeystorePkcs12.decode(
11	await readFile('key.p12'),
12	'password'
13);
14packager.timestampUrl = 'http://timestamp.digicert.com/';
15
16// Options:
17packager.applicationIconModern = true;
18packager.fileTypeIconModern = true;
19packager.frameworkCleanHelpers = true;
20packager.fileVersion = '1.2.3.4';
21packager.productVersion = '1.2.3.4';
22packager.versionStrings = {
23	CompanyName: 'Custom Company Name',
24	LegalCopyright: 'Custom Legal Copyright'
25};
26packager.architecture = 'x64';
27
28await packager.write(async packager => {
29	await packager.addResourceFile('src/main.swf', 'main.swf');
30	await packager.addResourceDirectory('src/icons', 'icons');
31});

Bundle Mac

Limitations:

• The default icon format does not include the obsolete ICN# and ics# encoded icons.

1import {readFile} from 'node:fs/promises';
2import {
3	PackagerBundleMac,
4	SecurityKeystorePkcs12
5} from '@shockpkg/ria-packager';
6
7const packager = new PackagerBundleMac('application.app');
8packager.descriptorFile = 'src/application-app.xml';
9packager.sdkPath = 'airsdk-mac.zip';
10packager.keystore = SecurityKeystorePkcs12.decode(
11	await readFile('key.p12'),
12	'password'
13);
14packager.timestampUrl = 'http://timestamp.digicert.com/';
15
16// Options:
17packager.applicationIconModern = true;
18packager.fileTypeIconModern = true;
19packager.frameworkCleanOsFiles = true;
20
21await packager.write(async packager => {
22	await packager.addResourceFile('src/main.swf', 'main.swf');
23	await packager.addResourceDirectory('src/icons', 'icons');
24});

ADL (Debug Launcher)

Limitations:

• Native extensions not supported.

ADL Windows

1import {PackagerAdlWindows} from '@shockpkg/ria-packager';
2
3const packager = new PackagerAdlWindows('application');
4packager.descriptorFile = 'src/application-app.xml';
5packager.sdkPath = 'airsdk-win.zip';
6
7// Options:
8packager.profile = 'extendedDesktop';
9packager.architecture = 'x64';
10
11await packager.write(async packager => {
12	await packager.addResourceFile('src/main.swf', 'main.swf');
13	await packager.addResourceDirectory('src/icons', 'icons');
14});

ADL Mac

1import {PackagerAdlMac} from '@shockpkg/ria-packager';
2
3const packager = new PackagerAdlMac('application');
4packager.descriptorFile = 'src/application-app.xml';
5packager.sdkPath = 'airsdk-mac.zip';
6
7// Options:
8packager.profile = 'extendedDesktop';
9
10await packager.write(async packager => {
11	await packager.addResourceFile('src/main.swf', 'main.swf');
12	await packager.addResourceDirectory('src/icons', 'icons');
13});

Bugs

If you find a bug or have compatibility issues, please open a ticket under issues section for this repository.

License

Copyright (c) 2019-2024 JrMasterModelBuilder

Licensed under the Mozilla Public License, v. 2.0.

If this license does not work for you, feel free to contact me.