AdvancedSharpAdbClient 2.5.6

There is a newer version of this package available.
See the version list below for details.
dotnet add package AdvancedSharpAdbClient --version 2.5.6                
NuGet\Install-Package AdvancedSharpAdbClient -Version 2.5.6                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="AdvancedSharpAdbClient" Version="2.5.6" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add AdvancedSharpAdbClient --version 2.5.6                
#r "nuget: AdvancedSharpAdbClient, 2.5.6"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install AdvancedSharpAdbClient as a Cake Addin
#addin nuget:?package=AdvancedSharpAdbClient&version=2.5.6

// Install AdvancedSharpAdbClient as a Cake Tool
#tool nuget:?package=AdvancedSharpAdbClient&version=2.5.6                
Issues License NuGet
Github Issues Github Issues NuGet Status

A .NET client for adb, the Android Debug Bridge (AdvancedSharpAdbClient)

AdvancedSharpAdbClient is a .NET library that allows .NET applications to communicate with Android devices. It provides a .NET implementation of the adb protocol, giving more flexibility to the developer than launching an adb.exe process and parsing the console output.

It's upgraded verion of SharpAdbClient. Added important features.

Support Platform

  • .NET Framework 3.5 (Maybe unstable)
  • .NET Framework 4.0 (Need Microsoft.Bcl.Async)
  • .NET Framework 4.5.2
  • .NET Framework 4.6.2
  • .NET Framework 4.7.2
  • .NET Framework 4.8.1
  • .NET Standard 1.3 (Not fully supported)
  • .NET Standard 2.0 (Support UWP if you don't use unsupported api like Process)
  • .NET Standard 2.1
  • .NET Core 5.0 (Support UAP 10.0 and UAP 10.0.15138.0)
  • .NET Core App 2.1
  • .NET Core App 3.1
  • .NET 6.0
  • .NET 8.0

Installation

To install AdvancedSharpAdbClient install the AdvancedSharpAdbClient NuGetPackage. If you're using Visual Studio, you can run the following command in the Package Manager Console:

PM> Install-Package AdvancedSharpAdbClient

Getting Started

AdvancedSharpAdbClient does not communicate directly with your Android devices, but uses the adb.exe server process as an intermediate. Before you can connect to your Android device, you must first start the adb.exe server.

You can do so by either running adb.exe yourself (it comes as a part of the ADK, the Android Development Kit), or you can use the AdbServer.StartServer method like this:

if (!AdbServer.Instance.GetStatus().IsRunning)
{
    AdbServer server = new AdbServer();
    StartServerResult result = server.StartServer(@"C:\adb\adb.exe", false);
    if (result != StartServerResult.Started)
    {
        Console.WriteLine("Can't start adb server");
    }
}

Connecting to device

Before using all the methods, you must initialize the new AdbClient class and then connect to the device

If you want to automate 2 or more devices at the same time, you must remember: 1 device - 1 AdbClient class

You can look at the examples to understand more

static AdbClient client;

static DeviceData device;

static void Main(string[] args)
{
    client = new AdbClient();
    client.Connect("127.0.0.1:62001");
    device = client.GetDevices().FirstOrDefault(); // Get first connected device
}

Device automation

Finding element

You can find the element on the screen by xpath

static AdbClient client;

static DeviceData device;

static void Main(string[] args)
{
    client = new AdbClient();
    client.Connect("127.0.0.1:62001");
    device = client.GetDevices().FirstOrDefault();
    Element el = client.FindElement(device, "//node[@text='Login']");
}

You can also specify the waiting time for the element

Element el = client.FindElement(device, "//node[@text='Login']", TimeSpan.FromSeconds(5));

And you can find several elements

Element[] els = client.FindElements(device, "//node[@resource-id='Login']", TimeSpan.FromSeconds(5));

Getting element attributes

You can get all element attributes

static void Main(string[] args)
{
    ...
    Element el = client.FindElement(device, "//node[@resource-id='Login']", TimeSpan.FromSeconds(3));
    string eltext = el.attributes["text"];
    string bounds = el.attributes["bounds"];
    ...
}

Clicking on an element

You can click on the x and y coordinates

static void Main(string[] args)
{
    ...
    client.Click(device, 600, 600); // Click on the coordinates (600;600)
    ...
}

Or on the element(need xpath)

static void Main(string[] args)
{
    ...
    Element el = client.FindElement(device, "//node[@text='Login']", TimeSpan.FromSeconds(3));
    el.Click();// Click on element by xpath //node[@text='Login']
    ...
}

The Click() method throw ElementNotFoundException if the element is not found

try
{
    el.Click();
}
catch (Exception ex)
{
    Console.WriteLine($"Can't click on the element:{ex.Message}");
}

Swipe

You can swipe from one element to another

static void Main(string[] args)
{
    ...
    Element first = client.FindElement(device, "//node[@text='Login']");
    Element second = client.FindElement(device, "//node[@text='Password']");
    client.Swipe(device, first, second, 100); // Swipe 100 ms
    ...
}

Or swipe by coordinates

static void Main(string[] args)
{
    ...
    device = client.GetDevices().FirstOrDefault();
    client.Swipe(device, 600, 1000, 600, 500, 100); // Swipe from (600;1000) to (600;500) on 100 ms
    ...
}

The Swipe() method throw ElementNotFoundException if the element is not found

try
{
    client.Swipe(device, 0x2232323, 0x954,0x9128,0x11111, 200);
    ...
    client.Swipe(device, first, second, 200);
}
catch (Exception ex)
{
    Console.WriteLine($"Can't swipe:{ex.Message}");
}

Send text

You can send any text except Cyrillic (Russian isn't supported by adb)

The text field should be in focus

static void Main(string[] args)
{
    ...
    client.SendText(device, "text"); // Send text to device
    ...
}

You can also send text to the element (clicks on the element and sends the text)

static void Main(string[] args)
{
    ...
    client.FindElement(device, "//node[@resource-id='Login']").SendText("text"); // Send text to the element by xpath //node[@resource-id='Login']
    ...
}

The SendText() method throw InvalidTextException if text is incorrect

try
{
    client.SendText(device, null);
}
catch (Exception ex)
{
    Console.WriteLine($"Can't send text:{ex.Message}");
}

Clearing the input text

You can clear text input

The text field should be in focus

Recommended

static void Main(string[] args)
{
    ...
    client.ClearInput(device, 25); // The second argument is to specify the maximum number of characters to be erased
    ...
}

It may work unstable

static void Main(string[] args)
{
    ...
    client.FindElement(device, "//node[@resource-id='Login']").ClearInput(); // Get element text attribute and remove text length symbols
    ...
}

Sending keyevents

You can see keyevents here https://developer.android.com/reference/android/view/KeyEvent#constants

static void Main(string[] args)
{
    ...
    client.SendKeyEvent(device, "KEYCODE_TAB");
    ...
}

The SendKeyEvent method throw InvalidKeyEventException if keyevent is incorrect

try
{
    client.SendKeyEvent(device, null);
}
catch (Exception ex)
{
    Console.WriteLine($"Can't send keyevent:{ex.Message}");
}

BACK and HOME buttons

static void Main(string[] args)
{
    ...
    client.BackBtn(device); // Click Back button
    ...
    client.HomeBtn(device); // Click Home button
    ...
}

Device commands

Some commands require Root

Install and Uninstall applications

static void Main(string[] args)
{
    ...
    PackageManager manager = new PackageManager(client, device);
    manager.InstallPackage(@"C:\Users\me\Documents\mypackage.apk", reinstall: false);
    manager.UninstallPackage("com.android.app");
    ...
}

Or you can use AdbClient.Install

static void Main(string[] args)
{
    ...
    client.Install(device, File.OpenRead("Application.apk"));
    ...
}

Install multiple applications

static void Main(string[] args)
{
    ...
    PackageManager manager = new PackageManager(client, device);
    manager.InstallMultiplePackage(@"C:\Users\me\Documents\base.apk", new string[] { @"C:\Users\me\Documents\split_1.apk", @"C:\Users\me\Documents\split_2.apk" }, reinstall: false); // Install split app whith base app
    manager.InstallMultiplePackage(new string[] { @"C:\Users\me\Documents\split_3.apk", @"C:\Users\me\Documents\split_4.apk" }, "com.android.app", reinstall: false); // Add split app to base app which packagename is 'com.android.app'
    ...
}

Or you can use AdbClient.InstallMultiple

static void Main(string[] args)
{
    ...
    client.InstallMultiple(device, File.OpenRead("base.apk"), new Stream[] { File.OpenRead("split_1.apk"), File.OpenRead("split_2.apk") }); // Install split app whith base app
    client.InstallMultiple(device, new Stream[] { File.OpenRead("split_3.apk"), File.OpenRead("split_4.apk") }, "com.android.app"); // Add split app to base app which packagename is 'com.android.app'
    ...
}

Start and stop applications

static void Main(string[] args)
{
    ...
    client.StartApp(device, "com.android.app");
    client.StopApp(device, "com.android.app"); // force-stop
    ...
}

Getting a screenshot

static async void Main(string[] args)
{
    ...
    System.Drawing.Image img = client.GetFrameBufferAsync(device, CancellationToken.None).GetAwaiter().GetResult(); // synchronously
    ...
    System.Drawing.Image img = await client.GetFrameBufferAsync(device, CancellationToken.None); // asynchronously
    ...
}

Getting screen xml hierarchy

static void Main(string[] args)
{
    ...
    XmlDocument screen = client.DumpScreen(device);
    ...
}

Send or receive files

void DownloadFile()
{
    using (SyncService service = new SyncService(new AdbSocket(client.EndPoint), device))
    {
        using (Stream stream = File.OpenWrite(@"C:\MyFile.txt"))
        {
            service.Pull("/data/local/tmp/MyFile.txt", stream, null, CancellationToken.None);
        }
    }
}

void UploadFile()
{
    using (SyncService service = new SyncService(new AdbSocket(client.EndPoint), device))
    {
        using (Stream stream = File.OpenRead(@"C:\MyFile.txt"))
        {
            service.Push(stream, "/data/local/tmp/MyFile.txt", 777 ,DateTimeOffset.Now, null ,CancellationToken.None);
        }
    }
}

Run shell commands

static async void Main(string[] args)
{
    ...
    ConsoleOutputReceiver receiver = new ConsoleOutputReceiver();
    client.ExecuteRemoteCommand("echo Hello, World", device, receiver); // synchronously
    ...
    await client.ExecuteRemoteCommandAsync("echo Hello, World", device, receiver, CancellationToken.None); // asynchronously
    ...
}

Encoding

Default encoding is UTF8, if you want to change it, use

AdbClient.SetEncoding(Encoding.ASCII);

Contributors

Contributors

Consulting and Support

Please open an issue on if you have suggestions or problems.

History

AdvancedSharpAdbClient is a fork of SharpAdbClient and madb which in itself is a .NET port of the ddmlib Java Library.

Credits: https://github.com/camalot, https://github.com/quamotion

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp1.0 was computed.  netcoreapp1.1 was computed.  netcoreapp2.0 was computed.  netcoreapp2.1 is compatible.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 is compatible. 
.NET Standard netstandard1.3 is compatible.  netstandard1.4 was computed.  netstandard1.5 was computed.  netstandard1.6 was computed.  netstandard2.0 is compatible.  netstandard2.1 is compatible. 
.NET Framework net35 is compatible.  net40 is compatible.  net403 was computed.  net45 was computed.  net451 was computed.  net452 is compatible.  net46 was computed.  net461 was computed.  net462 is compatible.  net463 was computed.  net47 was computed.  net471 was computed.  net472 is compatible.  net48 was computed.  net481 is compatible. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen30 was computed.  tizen40 was computed.  tizen60 was computed. 
Universal Windows Platform netcore50 is compatible.  uap was computed.  uap10.0 was computed.  uap10.0.15138 is compatible. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on AdvancedSharpAdbClient:

Package Downloads
TaiwanCaptain.God.AdbTool

godlike adb wrapper

GitHub repositories (4)

Showing the top 4 popular GitHub repositories that depend on AdvancedSharpAdbClient:

Repository Stars
Paving-Base/APK-Installer
An Android Application Installer for Windows
Macro-Deck-App/Macro-Deck
Macro Deck transforms your phone, tablet, or any device equipped with a modern internet browser into an efficient remote macro pad. With this tool, you can execute single or multi-step actions seamlessly with just a single tap.
TheAirBlow/HyperSploit
Bypassed HyperOS restrictions on bootloader unlocking
prosthetichead/GarlicPress
GarlicPress is a companion application for the RG35xx running GarlicOS. The main aim of the application is to never require you to remove the SDCards from your device.
Version Downloads Last updated
3.3.13 15,689 7/30/2024
3.3.12 11,395 4/17/2024
3.2.11 2,798 3/20/2024
3.1.10 2,494 2/21/2024
3.0.9 45,425 1/1/2024
2.5.8 1,697 10/29/2023
2.5.7 11,448 7/10/2023
2.5.6 671 5/27/2023
2.5.5 74,626 4/4/2023
2.5.4 8,449 1/30/2023
2.5.3 656 12/21/2022
2.5.2 6,694 11/29/2021
2.5.1 599 9/29/2021
2.5.0 442 9/27/2021
1.3.0-g 336 9/26/2021