Android-platform-tools NPM

android-platform-tools

This is a fully self contained module that wraps the Android SDK platform tools

This grabs the latest SDK Platform tools from https://developer.android.com/studio/releases/platform-tools.html

Fully multi platform and tested on windows, Linux and Mac OS. Please let me know if your OS does not work.

It will Also store the Android platform tools locally and check it exists at runtime so it does not download each time.

Requirements

NodeJs 8+ recommended NodeJs 4/6 should also work but are unsupported

Version 3 changes

BREAKING: change logic for issue #1 to default to __dirname but can be overridden instead
- Doesn't make sense to have the CLI install to every directory you call it in.
- The functions getToolPaths, downloadTools and downloadAndReturnToolPaths take a second parameter of base directory, defaults to __dirname of the package installation dir

The following syntax is an example to use the previous behaviour adb.downloadAndReturnToolPaths('custom-path3', process.cwd())

NPX Usage

$ npx android-platform-tools devices
npx: installed 80 in 2.914s
List of devices attached

Command Line Interface Usage

npm install -g android-platform-tools
This provides an alias for adb adbn <any adb command here> or adb <any adb command here>
For example: adbn devices or adb devices
Returns the usual: List of devices attached
adbn to avoid path conflicts with any existing android sdk installation with adb
Version 1.0.0+ Now provides aliases for fastboot, etc1tool, dmtracedump, hprof-conv and sqlite3
As with adb they have their respective n suffixes (fastbootn, etc1tooln, dmtracedumpn, hprof-convn and sqlite3n)

CLI Customisation

The following environment variables are available

ADB_HIGHLIGHT_ERRORS (Highlights the word error in stdout in red)
ADB_RAINBOW (Makes each line in stdout a different color and windows environment friendly)

Programmatic Usage

const adb = require('android-platform-tools');
  
//downloadOnly
return adb
    .downloadTools()
    .then((tools) => {
        const toolsPath = tools.path;
    });
//downloadWithValidationAndPaths
return adb
    .downloadAndReturnToolPaths()
    .then((tools) => {
        const adbPath = tools.adbPath;
        const platformToolsPath = tools.platformToolsPath;
    });

With Version 1.0.0 downloadAndReturnToolPaths now returns an object with the following properties:

adbPath
platformToolsPath
fastbootPath
dmtracedumpPath
etc1toolPath
hprofconvPath
sqlite3Path

Contributions

Always welcome

Roadmap

more customisation of the platform tools path, currently defaults to __dirname and "platform-tools"
Also consult TODO.txt

TroubleShooting

EACCESS errors on unix: Error: EACCES: permission denied https://docs.npmjs.com/getting-started/fixing-npm-permissions
Be careful with option one because doing a chown on usr/bin can override the sudo command on unix systems
EPERM: operation not permitted, unlink 'C:%HOMEPATH%\AppData\Roaming\npm\node_modules\android-platform-tools\platform-tools\AdbWinApi.dll' On windows to, to fix it means adb is still running try a adb kill-server