`pure-python-adb` 项目技术文档

1. 安装指南

1.1 系统要求

• Python 3.6 及以上版本

1.2 安装步骤

使用 pip 安装 pure-python-adb 包：

pip install -U pure-python-adb

2. 项目使用说明

2.1 连接到 ADB 服务器

你可以使用 pure-python-adb 包来连接到 ADB 服务器，类似于使用 adb 命令行工具。以下是一个简单的示例：

from ppadb.client import Client as AdbClient

# 默认主机和端口为 "127.0.0.1" 和 5037
client = AdbClient(host="127.0.0.1", port=5037)
print(client.version())

2.2 连接到设备

你可以连接到特定的设备并执行命令：

from ppadb.client import Client as AdbClient

client = AdbClient(host="127.0.0.1", port=5037)
device = client.device("emulator-5554")
device.shell("echo hello world !")

2.3 设备管理

你可以列出所有连接的设备，并在所有设备上安装或卸载 APK：

from ppadb.client import Client as AdbClient

apk_path = "example.apk"
client = AdbClient(host="127.0.0.1", port=5037)
devices = client.devices()

for device in devices:
    device.install(apk_path)

# 检查 APK 是否安装
for device in devices:
    print(device.is_installed("example.package"))

# 卸载 APK
for device in devices:
    device.uninstall("example.package")

3. 项目 API 使用文档

3.1 AdbClient 类

• AdbClient(host="127.0.0.1", port=5037)：创建一个 ADB 客户端实例。
• client.version()：获取 ADB 服务器的版本。
• client.devices()：获取所有连接的设备列表。
• client.device(serial)：获取指定序列号的设备实例。

3.2 Device 类

• device.shell(command)：在设备上执行 shell 命令。
• device.install(apk_path)：在设备上安装 APK。
• device.uninstall(package_name)：在设备上卸载 APK。
• device.is_installed(package_name)：检查 APK 是否已安装。
• device.screencap()：获取设备的屏幕截图。
• device.push(local_path, remote_path)：将文件或文件夹推送到设备。
• device.pull(remote_path, local_path)：从设备拉取文件或文件夹。

4. 项目安装方式

4.1 使用 pip 安装

pip install -U pure-python-adb

4.2 从源码安装

如果你需要从源码安装，可以按照以下步骤操作：

1. 克隆项目仓库：

   git clone https://github.com/Swind/pure-python-adb.git
   

2. 进入项目目录并安装：

   cd pure-python-adb
   pip install .
   

通过以上步骤，你可以轻松安装并使用 pure-python-adb 包来与 ADB 服务器进行交互。