node-adb-api

A Node.js API wrapper for ADB (Android Debug Bridge)

Features

• 🔍 List connected devices
• 📱 Manage Android apps (launch, kill, clear data)
• 📦 Download APKs from devices
• 🔎 Fuzzy search packages
• ⚡ Fast and reliable

Installation

1npm install node-adb-api

Usage

1const adb = require('node-adb-api');

Device Management

1// Get list of connected device serial numbers
2const devices = adb.getListOfDevices();
3
4// Check if a device is connected
5const isConnected = adb.isAnyDeviceConnected('device_serial');

Package Management

1// Get list of installed packages on a device
2const packages = adb.getPackagesByDeviceSerialNumber('device_serial');
3
4// Fuzzy search packages
5const results = await adb.fuzzySearchPackages(null, 'chrome');
6
7// Get APK path on device
8const path = adb.getDeviceApkPath('device_serial', 'com.example.app');
9
10// Download APK from device
11const apkFile = adb.downloadAPK('device_serial', 'com.example.app');

App Control

1// Launch an app
2adb.launchApp('com.example.app', 'device_serial');
3
4// Force kill an app
5adb.forceKill('com.example.app', 'device_serial');
6
7// Clear app data
8adb.clearData('com.example.app', 'device_serial');
9
10// Uninstall an app
11adb.uninstall('com.example.app', 'device_serial');

API Reference

getListOfDevices()

Returns an array of connected device serial numbers.

isAnyDeviceConnected(deviceSerialNumber)

Checks if the specified device is connected.

• deviceSerialNumber: Device serial number to check

getPackagesByDeviceSerialNumber(deviceSerialNumber)

Returns an array of package names installed on the device.

• deviceSerialNumber: Target device serial number

fuzzySearchPackages(packages, textToFind)

Performs a fuzzy search on installed packages.

• packages: Optional array of packages to search in
• textToFind: Search query string

getDeviceApkPath(deviceSerialNumber, chosenPackage)

Gets the path of an APK file on the device.

• deviceSerialNumber: Target device serial number
• chosenPackage: Package name to locate

downloadAPK(deviceSerialNumber, chosenPackage)

Downloads an APK file from the device.

• deviceSerialNumber: Target device serial number
• chosenPackage: Package name to download
• Returns: The downloaded APK filename

launchApp(chosenPackage, selectedDevice)

Launches an app on the device.

• chosenPackage: Package name to launch
• selectedDevice: Target device serial number

forceKill(chosenPackage, deviceSerialNumber)

Force stops an app on the device.

• chosenPackage: Package name to force stop
• deviceSerialNumber: Target device serial number

clearData(chosenPackage, deviceSerialNumber)

Clears app data on the device.

• chosenPackage: Package name to clear data
• deviceSerialNumber: Target device serial number

uninstall(chosenPackage, selectedDevice)

Uninstalls an app from the device.

• chosenPackage: Package name to uninstall
• selectedDevice: Target device serial number

Development

1# Install dependencies
2npm install
3
4# Run tests
5npm test
6
7# Run linting
8npm run lint

Used in

purrge - 🐱 Quickly purrge android apps from your phone

License

MIT © Cesar Ferreira