# logcat-view **Repository Path**: isnullpointer/logcat-view ## Basic Information - **Project Name**: logcat-view - **Description**: 类似Androidstudio的logcat工具 - **Primary Language**: Unknown - **License**: GPL-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-17 - **Last Updated**: 2026-11-17 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Logcat 独立的 Android Logcat 查看器,界面与用法接近 Android Studio 的 Logcat,**无需打开 Android Studio**。 ![Logo](assets/logcat-logo.png) ## 功能 - 实时拉取 `adb logcat` 日志(`threadtime` 格式) - 多设备切换,离线设备标记 `[OFFLINE]` - Android Studio 风格过滤:`tag:` / `level:` / `package:` / `message:` / `pid:` / `-tag:` - 过滤历史可下拉 /「历史」菜单回选,并持久保存 - 多标签页并行查看(不同设备或不同过滤条件) - 清空、暂停、自动滚动、长行自动换行(Message 列内换行) - 紧凑 / 完整列显示,可自定义显示列 - 文本字号可调,个人配置自动保存 - 按级别着色(V / D / I / W / E / A) - 项目内置 Windows 版 `adb`,他人拿到即可用 ## 环境要求 - Windows - Python 3.10+ - 手机开启 **USB 调试** 并已授权本机 - 一般无需再装 Android SDK(已内置 `tools/platform-tools/adb.exe`) ## 安装 ```bash pip install -r requirements.txt ``` 国内网络较慢时可使用镜像: ```bash pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple ``` ## 启动 任选其一(推荐前两种,**无命令行黑框**): | 方式 | 说明 | |------|------| | 双击 `run.vbs` | 推荐,无控制台窗口 | | 双击 `main.pyw` | 同样无控制台 | | 双击 `run.bat` | 尽量用 `pythonw` 启动 | | `python main.py` | 开发调试用,会显示控制台 | 也可使用桌面快捷方式(若已创建)直接打开。 ## 使用说明 1. 用 USB 连接设备,确认已开启调试授权 2. 启动软件后,顶部设备下拉框选择手机 3. 在过滤框输入条件,回车可写入历史 4. 左侧工具栏:清空 / 暂停 / 自动滚动 / 换行 / 紧凑视图 / 重启流 5. 顶部 **列**、**设置**:调整显示列、字号等 ### 过滤示例 ```text tag:WindowManager level:error package:com.example.app message:crash tag:Activity level:warn -tag:System bluetooth ``` 说明: - `tag:` / `message:` / `package:` 为包含匹配(默认不区分大小写) - `level:error` 表示 Error **及以上**(E / A) - `-tag:xxx` 表示排除 ### 快捷键 | 操作 | 快捷键 | |------|--------| | 清空日志 | `Ctrl+L` | | 复制选中行 | `Ctrl+C` | ### 多标签页 - 右上角 `+` 新建标签页 - 标签名显示:`设备名 · 过滤条件` - 仅剩一个标签时不可关闭 ## 个人配置 配置保存在用户目录: ```text %USERPROFILE%\.logcat-viewer\settings.json ``` 会记住: - 文本字号 - 紧凑视图 / 自动滚动 / 区分大小写 / 自动换行 - 显示哪些列 - 过滤历史 - 窗口大小 也可在软件内点 **设置 → 打开配置目录**。 ## 内置 adb 路径: ```text tools/platform-tools/adb.exe ``` 程序优先使用项目内这份 adb。若要覆盖,可设置环境变量: ```text ADB_PATH=D:\path\to\adb.exe ``` 或指向包含 `adb.exe` 的目录 / Android SDK 根目录。 ## 项目结构 ```text logcat-project/ ├── main.py / main.pyw # 入口 ├── run.vbs / run.bat # 启动脚本 ├── requirements.txt ├── assets/ # Logo 图标 ├── tools/platform-tools/ # 内置 adb └── logcat/ ├── adb.py # 设备与 logcat 流 ├── parser.py # 日志解析 ├── filter.py # 过滤语法 ├── settings.py # 个人配置 └── ui/ # 界面 ``` ## 常见问题 **1. 一直显示「未检测到设备」** 检查数据线、USB 调试开关、手机上的授权弹窗;可在命令行运行 `tools\platform-tools\adb.exe devices` 确认。 **2. 过滤后显示 0 条** 说明当前缓冲区没有匹配日志。可清空过滤看全部,或换成本机真实存在的 Tag(如 `tag:GNSSMGT`)。 **3. 启动出现黑框** 请用 `run.vbs` 或 `main.pyw`,不要用 `python main.py`(调试除外)。 **4. 依赖安装很慢** 使用上文清华镜像安装 PySide6-Essentials。 ## 打包发布(生成 exe) ```bash pip install -r requirements.txt "pyinstaller>=6.0" python build_release.py --clean ``` 或双击 `build_release.bat`。 产物: ```text release/logcat-view-1.0.0/ # 可直接运行的目录(含 Logcat.exe) release/logcat-view-1.0.0-windows-x64.zip ``` 版本号来自根目录 `VERSION`(当前 `1.0.0`)。发新版时改 `VERSION` 后重新打包即可。 将 zip 上传到 Gitee/GitHub Release 对应版本即可分发。 ## License 见仓库根目录 `LICENSE`。