ADB Client in pure Java.
Go to file
2023-10-09 15:06:59 +02:00
.github/workflows use "master" in triggers 2022-02-12 20:57:18 +01:00
.idea Apply the correct package name 2017-10-17 16:27:34 +07:00
build script to build in docker image 2018-09-17 18:48:24 +02:00
lib Removing unused jar 2016-03-03 07:36:29 +01:00
META-INF Adding jar artifact 2014-04-02 19:44:28 +02:00
src/se/vidstige/jadb feat: Add support for shell v2 commands (vidstige/jadb#121) 2022-06-11 18:14:23 +02:00
test feat: Add support for shell v2 commands (vidstige/jadb#121) 2022-06-11 18:14:23 +02:00
.gitattributes Build: Cleaning up .gitignore & friends 2016-07-25 18:42:08 +02:00
.gitignore #58 connect command implemented and it`s test 2017-03-20 13:18:56 +03:00
CONTRIBUTING.md rm and build 2018-09-23 20:27:49 +02:00
LICENSE.md Adding the Apache 2.0 license 2014-02-24 07:53:11 +01:00
pom.xml build: Change group id to app.revanced 2023-10-09 15:06:59 +02:00
README.md updating badge 2022-02-12 20:57:18 +01:00
release.sh Adding release script 2016-11-10 06:46:57 +01:00

JADB

ADB client implemented in pure Java.

The Android Debug Bridge (ADB) is a client-server architecture used to communicate with Android devices (install APKs, debug apps, etc).

The Android SDK Tools are available for the major platforms (Mac, Windows & Linux) and include the adb command line tool which implements the ADB protocol.

This projects aims at providing an up to date implementation of the ADB protocol.

Build Status jitpack badge codecov first timers friendly

Example

Usage cannot be simpler. Just create a JadbConnection and off you go.

JadbConnection jadb = new JadbConnection();
List<JadbDevice> devices = jadb.getDevices();

Make sure the adb server is running. You can start it by running adb once from the command line.

It's very easy to send and receive files from your android device, for example as below.

JadbDevice device = ...
device.pull(new RemoteFile("/path/to/file.txt"), new File("file.txt"));

Some high level operations such as installing and uninstalling packages are also available.

JadbDevice device = ...
new PackageManager(device).install(new File("/path/to/my.apk"));

Protocol Description

An overview of the protocol can be found here: Overview

A list of the available commands that a ADB Server may accept can be found here: Services

The description for the protocol for transferring files can be found here: SYNC.TXT.

Using JADB in your application

Since version v1.1 Jadb support maven as a build system. Although this project is not presented in official apache maven repositories this library can be used as dependencies in your maven/gradle project with the help of jitpack. Jitpack is a system which parses github public repositories and make artifacts from them. You only need to add jitpack as a repository to let maven/gradle to search for artifacts in it, like so

<repositories>
    <repository>
        <id>jitpack.io</id>
        <url>https://jitpack.io</url>
    </repository>
</repositories>

After that you will need to add actual dependency. Jitpack takes groupId, artifactId and version id from repository name, project name and tag ignoring actual values from pom.xml. So you need to write:

<dependency>
    <groupId>com.github.vidstige</groupId>
    <artifactId>jadb</artifactId>
    <version>v1.2.1</version>
</dependency>

Troubleshooting

If you cannot connect to your device check the following.

  • Your adb server is running by issuing adb start-server
  • You can see the device using adb adb devices

If you see the device in adb but not in jadb please file an issue on https://github.com/vidstige/jadb/.

Workaround for Unix Sockets Adb Server

Install socat and issue the following to forward port 5037 to the unix domain socket.

socat TCP-LISTEN:5037,reuseaddr,fork UNIX-CONNECT:/tmp/5037

Contributing

This project would not be where it is, if it where not for the helpful contributors supporting jadb with pull requests, issue reports, and great ideas. If you would like to contribute, please read through CONTRIBUTING.md.

  • If you fix a bug, try to first create a failing test. Reach out to me for assistance or guidance if needed.

Authors

Samuel Carlsson samuel.carlsson@gmail.com

See contributors for a full list.

License

This project is released under the Apache License Version 2.0, see LICENSE.md for more information.