mirror of
https://github.com/revanced/jadb.git
synced 2024-11-19 10:39:23 +01:00
66 lines
2.6 KiB
Markdown
66 lines
2.6 KiB
Markdown
#JADB#
|
||
ADB client implemented in pure Java.
|
||
|
||
The Android Debug Bridge or ADB for short it a client-server architecture used to install android apps from an IDE or command line and to debug apps, etc.
|
||
|
||
The Android SDK Tools is available for the major platforms (Mac, Windows & Linux) and in there is a command line tool called adb that implements the ADB protocol.
|
||
|
||
This projects aims at providing an up to date implementation of the ADB protocol.
|
||
|
||
[](https://travis-ci.org/vidstige/jadb)
|
||
|
||
## 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](https://github.com/cgjones/android-system-core/blob/master/adb/OVERVIEW.TXT)
|
||
|
||
A list of the available commands that a ADB Server may accept can be found here:
|
||
[Services](https://github.com/cgjones/android-system-core/blob/master/adb/SERVICES.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](https://jitpack.io).
|
||
[Оitpack](https://jitpack.io) is a system which parse github public repositories and make artifacts from them.
|
||
You will just only need to add [jitpack](https://jitpack.io) as a repository to let maven/gradle to search for artifacts in it
|
||
|
||
```
|
||
<repositories>
|
||
<repository>
|
||
<id>jitpack.io</id>
|
||
<url>https://jitpack.io</url>
|
||
</repository>
|
||
</repositories>
|
||
```
|
||
|
||
After that you will need to add actual dependency. [Jitpack](https://jitpack.io) 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.1</version>
|
||
</dependency>
|
||
```
|
||
|
||
## Author ##
|
||
Samuel Carlsson <samuel.carlsson@gmai.com> |