核心用法
pywayne-adb-logcat-reader 是用于实时捕获 Android 设备日志的 Python 模块，基于 adb logcat 命令实现。核心类 AdbLogcatReader 提供生成器式日志流，支持逐行实时处理，无需等待完整输出。
快速上手
from pywayne.adb.logcat_reader import AdbLogcatReader
reader = AdbLogcatReader() # 默认 C++ 后端
reader.start()
for line in reader.read(): # 生成器逐行输出
print(line)
reader.stop()双后端机制
- C++ 后端（默认）：原生实现，实时流处理性能更优，适合生产环境高频日志采集
- Python 后端：基于 subprocess，兼容性更佳，便于调试与问题排查
关键 API
| 方法 | 说明 |
|------|------|
| `start()` | 启动 adb logcat 进程 |
| `read()` | 生成器方法，逐行产出日志 |
| `stop()` | 终止进程并清理资源 |
| `get_backend()` | 获取当前激活后端类型 |
显著优点
1. 实时流式处理：生成器架构避免内存爆炸，适合长时监控与大规模日志
2. 双后端灵活切换：性能与兼容性兼顾，覆盖不同部署环境
3. 接口简洁：三步完成（创建→启动→读取），学习成本低
4. 自动清理：stop() 后自动清理日志缓存
潜在缺点与局限性
- 依赖 ADB 环境：需预装 Android SDK 并配置 adb 路径，非纯 Python 依赖
- 后端编译成本：C++ 后端可能需要额外编译步骤，增加首次部署复杂度
- 无内置过滤：需自行实现日志级别/Tag 过滤逻辑，模块本身仅提供原始流
- 平台限制：仅适用于 Android 设备，无法用于 iOS 或其他系统
适合人群
- Android 应用开发者进行实时日志调试
- 自动化测试工程师构建日志监控流水线
- 性能分析人员采集长时间运行日志数据
常规风险
- 子进程泄漏：若未调用
stop()，adb 进程可能残留占用系统资源 - 敏感信息暴露：logcat 可能包含用户隐私数据，生产环境需脱敏处理
- 权限要求：部分设备需 root 或特定权限才能读取全部日志