AdbClient.NET
A .NET Client for the Android Debug Bridge (ADB)
Features
- Simple
- Thread-Safe
- Implemented Services:
- GetHostVersion (
host:version) - GetDevices (
host:devices) - TrackDevices (
host:track-devices) - Sync (
sync:)- Push (
SEND) - Pull (
RECV) - List (
LIST) - ListV2 (
LIS2) - Stat (
STAT) - StatV2 (
LST2/STA2)
- Push (
- Execute (
shell,v2:) - ScreenCapture (
framebuffer:)
- GetHostVersion (
Compared to madb / SharpAdbClient
- Pros:
- Simple
- Thread-Safe
- Async
- CancellationToken support
- Cons:
- Lots of services not (yet) implemented (pull requests are welcome)
Examples
Get ADB host version
var adbClient = new AdbServicesClient();
int hostVersion = await adbClient.GetHostVersion();Get Devices
var adbClient = new AdbServicesClient();
IList<(string Serial, string State)> devices = await adbClient.GetDevices();Track Devices
This tracks all device changes (connect, disconnect, etc.) until the CancellationToken is cancelled (in this case, for 60 seconds)
var adbClient = new AdbServicesClient();
var cts = new CancellationTokenSource(60000);
await foreach ((string Serial, string State) deviceStateChange in adbClient.TrackDevices(cts.Token))
{
[...]
}List root directory
var adbClient = new AdbServicesClient();
using (var syncClient = await adbClient.GetSyncClient("abcdefghijklmnop"))
{
IList<StatV2Entry> entries = syncClient.ListV2("/");
}Upload file to device
using (var fs = File.OpenRead("test.mp3"))
using (var syncClient = await client.GetSyncClient("abcdefghijklmnop"))
{
await syncClient.Push("/storage/emulated/0/Music/test.mp3", fs);
}Download file from device
using (var fs = File.OpenWrite("test.mp3"))
using (var syncClient = await client.GetSyncClient("abcdefghijklmnop"))
{
await syncClient.Pull("/storage/emulated/0/Music/test.mp3", fs);
}Execute command
Simple
var adbClient = new AdbServicesClient();
int exitCode = await adbClient.Execute("abcdefghijklmnop", "touch", new string[] { "/storage/emulated/0/test.txt" }, null, null, null);With stdout/stderr redirection
var adbClient = new AdbServicesClient();
using var stdout = new MemoryStream();
using var stderr = new MemoryStream();
int exitCode = await adbClient.Execute("abcdefghijklmnop", "ls", new string[] { "-la", "/storage/emulated/0/test.txt" }, null, stdout, stderr);
if (exitCode != 0)
throw new Exception(Encoding.UTF8.GetString(stderr.ToArray()));
Console.WriteLine(Encoding.UTF8.GetString(stdout.ToArray())); // prints directory listingWith everything redirected
var adbClient = new AdbServicesClient();
using var stdin = new MemoryStream(Encoding.UTF8.GetBytes("Hello World"));
using var stdout = new MemoryStream();
using var stderr = new MemoryStream();
int exitCode = await adbClient.Execute("abcdefghijklmnop", "cat", new string[] {}, stdin, stdout, stderr);
if (exitCode != 0)
throw new Exception(Encoding.UTF8.GetString(stderr.ToArray()));
Console.WriteLine(Encoding.UTF8.GetString(stdout.ToArray())); // prints "Hello World"Capture screen
Capture and save as png
var adbClient = new AdbServicesClient();
using Image img = await adbClient.ScreenCapture("abcdefghijklmnop");
img.SaveAsPng("image.png");