pure-python-adb 快速开始教程:5步连接Android设备并执行第一条shell命令
发布时间:2026/8/27 17:33:20 作者:尧图编辑部 阅读量:1,286

pure-python-adb 快速开始教程5步连接Android设备并执行第一条shell命令【免费下载链接】pure-python-adbThis is pure-python implementation of the ADB client.项目地址: https://gitcode.com/gh_mirrors/pu/pure-python-adbpure-python-adb 是一个纯 Python 实现的 ADB 客户端它直接与 ADB server 通信让你无需依赖 Android SDK 就能用 Python 连接 Android 设备、执行 shell 命令、传输文件和安装应用。本教程带你在 5 步内完成安装、连接设备并执行第一条 shell 命令。使用adb命令行工具时命令会发送到电脑上的 adb server再转发给设备端的 adb daemon。而 pure-python-adb 的作用正是取代命令行工具这一环核心客户端实现位于ppadb/client.py设备操作封装在ppadb/device.py。第1步一键安装 pure-python-adb环境要求Python 3.6 及以上版本。一条命令完成安装pip install -U pure-python-adb⚠️ 注意从 v0.2.1 开始包名由adb更名为ppadb导入时使用from ppadb.client import Client。第2步连接 ADB server 并检查连接状态确保电脑的 adb server 已启动在终端执行过任意adb命令即可自动启动。默认连接地址是127.0.0.1:5037from ppadb.client import Client as AdbClient client AdbClient(host127.0.0.1, port5037) print(client.version()) # 39能打印出协议版本号说明已成功与 ADB server 建立连接。第3步列出所有已连接的 Android 设备等价于执行adb devicesdevices client.devices() for device in devices: print(device.serial, device.status)如果列表为空先检查数据线连接和开发者选项中的 USB 调试开关。第4步按序列号获取目标设备对象从列表中挑选一台设备例如模拟器emulator-5554device client.device(emulator-5554)device()方法在 ppadb/client.py 中按序列号匹配并返回Device对象后续所有设备操作都基于它。第5步在 Android 上执行第一条 shell 命令见证时刻 device.shell(echo hello world !)如果希望拿到命令输出可以传一个回调函数读取device.shell(getprop ro.build.version.sdk)至此你已经用 pure-python-adb 完成了连接 Android 设备并执行 shell 命令的完整流程。进阶玩法截图、传文件、装应用掌握基础后这些常用能力触手可得截屏保存device.screencap()返回图片字节直接写入文件即可示例见 example/screencap.py安装 / 卸载 APKdevice.install(example.apk)、device.uninstall(example.package)文件推送 / 拉取device.push(example.apk, /sdcard/example.apk)、device.pull(/sdcard/screen.png, screen.png)网络方式连接设备client.remote_connect(172.20.0.1, 5555)⏱️异步版本需要批量操作多台设备时可使用ppadb/client_async.py中的ClientAsync新手常见问题速查问题解决方法client.devices()返回空列表确认 USB 调试已开启、设备已授权电脑连接 5037 端口失败先在终端手动执行一次adb命令让 adb server 自启动排查通信细节开启调试日志logging.getLogger(ppadb).setLevel(logging.DEBUG)更多用法可参考项目自带的测试用例如test/test_device.py、test/test_host.py以及安装脚本setup.py。现在去连接你的第一台设备吧【免费下载链接】pure-python-adbThis is pure-python implementation of the ADB client.项目地址: https://gitcode.com/gh_mirrors/pu/pure-python-adb创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考