const aapt = require('aaptjs3');

// Dump APK metadata
const { stdout } = await aapt.dump('app.apk', 'badging');
console.log(stdout);

// Get structured APK info
const info = await aapt.getApkInfo('app.apk');
// { package: 'com.example.app', version: '1.0.0',
//   name: 'My App', icon: 'res/mipmap/ic_launcher.png' }

// List APK contents
const { stdout: files } = await aapt.list('app.apk');

Custom Binary

Configure your own aapt binary — version auto-detected:

const aapt = require('aaptjs3');

// Use a custom aapt binary
await aapt.configure({ binPath: '/path/to/custom/aapt' });

// If the path is broken or version can't be detected,
// falls back to built-in aapt2 with a warning.

API

interface ExecResult {
  stdout: string;
  stderr: string;
}

interface PackageInfo {
  package: string;
  version: string;
  name: string;
  icon: string;
}

`configure(opts: { binPath?: string }): Promise<void>`

Configure a custom aapt binary. Version is auto-detected. All subsequent API calls use the configured binary. If the path is invalid or version unknown, falls back to built-in aapt2.

`getBinPath(): string`

Returns the currently active aapt binary path.

`aapt(commandArgs: string[], maxBuffer?: number): Promise<ExecResult>`

Low-level execution of the active aapt binary with arbitrary arguments.

`dump(apkPath: string, value: string, extraArgs?: string[]): Promise<ExecResult>`

Dump APK information. Supported subcommands: badging, strings, resources, permissions, configurations, packagename, styleparents, apc, overlayable, chunks, xmltree, xmlstrings.

// Simple dumping
await aapt.dump('app.apk', 'badging');
await aapt.dump('app.apk', 'permissions');
await aapt.dump('app.apk', 'packagename');

// xmltree/xmlstrings need --file flag
await aapt.dump('app.apk', 'xmltree', ['--file', 'AndroidManifest.xml']);

Function	aapt2 Replacement
`packageCmd()`	`aapt2 compile` + `aapt2 link`
`remove()`	`aapt2 optimize` or zip tools
`add()`	`aapt2 compile` + `aapt2 link`
`crunch()`	`aapt2 compile`
`singleCrunch()`	`aapt2 compile`

Migration from v1.x

v1.x	v2.x
`dump(apk, value)`	Same, or `dump(apk, value, extraArgs)`
`list(apk, args)`	`list(apk)` — args ignored, reads ZIP
`getApkInfo(apk)`	Same
`packageCmd()`	Throws
`remove()` / `add()`	Throws
`crunch()` / `singleCrunch()`	Throws