async-adbc

async-adbc 是 ADB Client 的纯 Python 异步实现，直接与 ADB Server 通信，无需通过进程调用命令行执行 ADB 命令。

特性

• ⚡ 异步优先：完全异步的 API 设计，基于 asyncio
• 📱 设备管理：连接、管理多个 Android 设备
• 🔌 丰富插件：17+ 内置插件，覆盖各种功能
• 🚀 高性能：直接与 ADB Server 通信，无需命令行
• 📦 插件系统：灵活的插件机制，易于扩展
• 🐍 Python 3.8+：支持 Python 3.8 及以上版本

安装

pip install async-adbc

快速入门

使用 ADBClient

import asyncio
from async_adbc import ADBClient

async def main():
    adbc = ADBClient()  # 默认连接 127.0.0.1:5037
    
    # 获取 ADB 版本
    version = await adbc.version()
    print(f"ADB 版本: {version}")
    
    # 获取设备列表
    devices = await adbc.devices()
    for device in devices:
        print(f"设备: {device.serialno}")
    
    # 获取第一个设备
    device = await adbc.device()
    print(f"默认设备: {device.serialno}")

asyncio.run(main())

使用 Device 插件

import asyncio
from async_adbc import ADBClient

async def main():
    adbc = ADBClient()
    device = await adbc.device()
    
    # 执行 shell 命令
    result = await device.shell("echo hello")
    print(f"Shell 输出: {result}")
    
    # 获取设备属性
    model = await device.prop.get("ro.product.model")
    print(f"设备型号: {model}")
    
    # 列出已安装的包
    packages = await device.pm.list_packages()
    print(f"已安装 {len(packages)} 个应用")
    
    # 获取 CPU 信息
    cpu_info = await device.cpu.get_info()
    print(f"CPU: {cpu_info.name}, {cpu_info.core} 核")
    
    # 获取帧率
    fps_stat = await device.fps.stat("com.example.app")
    print(f"FPS: {fps_stat.fps:.2f}")
    
    # 模拟点击
    await device.input.tap(500, 500)

asyncio.run(main())

文档

完整文档请访问：https://kaluluosi.github.io/async-adbc/

• 快速入门
• API 参考
• 插件列表
• 插件开发教程
• 架构设计

内置插件

示例

文件传输

# 推送文件到设备
await device.push("local.txt", "/sdcard/local.txt")

# 从设备拉取文件
await device.pull("/sdcard/remote.txt", "local.txt")

应用管理

# 安装 APK
await device.pm.install("app.apk")

# 卸载应用
await device.pm.uninstall("com.example.app")

# 清除应用数据
await device.pm.clear("com.example.app")

性能监控

# 获取 CPU 占用率
cpu_usage = await device.cpu.get_total_cpu_usage()
print(f"CPU: {cpu_usage.usage:.2f}%")

# 获取内存信息
mem_stat = await device.mem.stat("com.example.app")
print(f"PSS: {mem_stat.pss} kB")

# 获取帧率
fps_stat = await device.fps.stat("com.example.app")
print(f"FPS: {fps_stat.fps:.2f}")

项目结构

async_adbc/
├── __init__.py          # 导出主要类
├── client.py            # ADBClient 实现
├── device.py            # Device 实现
├── plugin.py            # 插件基类
├── plugins/             # 插件目录
│   ├── __init__.py
│   ├── _registry.py     # 插件注册表
│   ├── am.py            # Activity Manager
│   ├── battery.py       # 电池
│   ├── cpu.py           # CPU
│   ├── fps.py           # 帧率
│   ├── input.py         # 输入
│   ├── mem.py           # 内存
│   ├── pm.py            # 包管理
│   ├── prop.py          # 属性
│   └── ...
├── protocol/            # 协议实现
│   ├── __init__.py
│   ├── consts.py        # 协议常量
│   ├── connection.py    # 连接管理
│   └── response.py      # 响应处理
├── service/             # 服务实现
│   ├── __init__.py
│   ├── base.py          # 服务基类
│   ├── host.py          # Host 服务
│   └── local.py         # Local 服务
├── exceptions.py        # 异常定义
├── models.py            # 数据模型
└── config.py            # 配置

开发

克隆代码

git clone https://github.com/kaluluosi/async-adbc.git
cd async-adbc

安装依赖

pip install -e ".[test,docs]"

运行测试

# 运行单元测试
pytest -m unit

# 运行集成测试（需要连接设备）
pytest -m integration

构建文档

mkdocs serve

参考与感谢

• adb 协议文档
• pure-python-adb
• solopi

许可证

MIT License

英文说明 / English

async-adbc

async-adbc is a pure Python asynchronous ADB Client implementation that communicates directly with ADB Server, eliminating the need for command-line invocation.

Features

• ⚡ Async-first: Fully asynchronous API based on asyncio
• 📱 Device management: Connect and manage multiple Android devices
• 🔌 Rich plugins: 17+ built-in plugins covering various functionalities
• 🚀 High performance: Direct communication with ADB Server
• 📦 Extensible: Flexible plugin system for easy extension
• 🐍 Python 3.8+: Supports Python 3.8 and above

Quick Example

import asyncio
from async_adbc import ADBClient

async def main():
    adbc = ADBClient()
    device = await adbc.device()
    
    # Execute shell command
    result = await device.shell("echo hello")
    print(result)
    
    # Get device properties
    model = await device.prop.get("ro.product.model")
    print(f"Model: {model}")
    
    # List packages
    packages = await device.pm.list_packages()
    print(f"Installed: {len(packages)}")
    
    # Get CPU info
    cpu_info = await device.cpu.get_info()
    print(f"CPU: {cpu_info.name}")

asyncio.run(main())

License

MIT License