Using ADBLib in Android: Setup, Step‑by‑Step Guide, and Underlying Principles

In Android, executing adb commands via

Runtime runtime = Runtime.getRuntime(); Process proc = runtime.exec(cmd);

works for some commands, but many are blocked due to insufficient permissions, especially on Android P and later; ADBLib provides a higher‑privilege way to run adb commands from within an app.

The ADBLib source code is lightweight and open‑source, available at https://github.com/cgutman/AdbLib , and an APK implementing it can also be found on Google Play.

Usage steps :

1. Change the adb daemon to TCP/IP mode (port 5555). 2. Generate an encryption key pair (private.key and public.key) using the Adbcrypto class. 3. Retrieve the device’s IP address. 4. Open a socket connection to device_ip:5555 . 5. Write ADB commands to the socket and read the returned output.

The key generation code creates a Adbcrypto instance that stores the keys under /data/data/<package_name>/files/. The generated files are private.key and public.key.

Reading and writing the key files requires the appropriate file‑system permissions, which must be declared in the app’s manifest.

To obtain the device IP, the app can either query the network interfaces directly or use the provided utility method (shown in the original images).

When establishing the socket, note that some devices allow only a single active connection; therefore, any existing connection should be closed before attempting a new one.

Connection handling must be asynchronous. The sample connection code (illustrated in the source images) creates a socket, opens input and output streams, and communicates with the adbd daemon running on the device’s port 5555‑5585.

Successful connection is indicated by a UI prompt similar to the standard ADB authorization dialog that appears when the device first connects to a PC.

After the socket is ready, multiple ADBStream instances can be created to send commands and capture their responses.

Gradle configuration and AndroidManifest.xml snippets are required to include the ADBLib library and declare necessary permissions (e.g., INTERNET, WRITE_EXTERNAL_STORAGE).

ADBLib principle : ADBLib is a Java implementation of the ADB network protocol. It simulates an ADB server on the Android device, communicating with the adbd daemon via a TCP socket. The library creates a socket, manages input/output streams, and handles optional encryption, effectively allowing the app to issue ADB commands without needing a separate PC‑side ADB server.

In summary, by configuring the project, generating encryption keys, obtaining the device IP, establishing a socket, and sending commands, developers can control Android devices programmatically using ADBLib.