# AdbToolbox **Repository Path**: zhangerhao/adb-toolbox ## Basic Information - **Project Name**: AdbToolbox - **Description**: AdbToolbox:Mac应用,可视化调试Android设备 - **Primary Language**: Unknown - **License**: Apache-2.0 - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 0 - **Created**: 2026-02-09 - **Last Updated**: 2026-04-27 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # ADB Toolbox ADB Toolbox 是一款功能强大的 macOS 平台 ADB 调试工具箱,为 Android 开发者和测试人员提供了直观、高效的设备管理和调试功能。 ## 功能特性 ### 基础功能 - **设备管理**:查看和管理连接的 Android 设备 - **连接诊断**:检测和解决 ADB 连接问题 - **无线配对**:通过无线方式连接 Android 设备 ### 专业工具 - **日志查看**:实时查看和过滤设备日志 - **应用管理**:安装、卸载和管理设备上的应用 - **屏幕镜像**:通过 Scrcpy 实现设备屏幕镜像 ### 高级特性 - **ADB 服务器管理**:启动、停止和重启 ADB 服务器 - **端口占用检测**:检查和解决端口 5037 占用问题 - **ADB 版本管理**:检查和更新内置 ADB 工具 - **多语言支持**:中英文双语界面 - **状态栏菜单**:通过菜单栏快速访问常用功能 ## 系统要求 - macOS 13.0 (Ventura) 或更高版本 - 64 位 Intel 或 Apple Silicon 处理器 - 至少 2GB 可用内存 - 至少 50MB 可用磁盘空间 ## 安装方法 ### 方法一:从源码构建 1. 克隆项目仓库: ```bash git clone cd ADB Toolbox ``` 2. 打开 Xcode 项目: ```bash open ADB Toolbox.xcodeproj ``` 3. 构建并运行应用: - 选择目标设备为 "My Mac" - 点击 "Run" 按钮或使用快捷键 `Cmd+R` ### 方法二:使用预构建版本 (如果有提供预构建的应用包) 1. 下载最新的 `.dmg` 安装包 2. 打开安装包并将 ADB Toolbox 拖动到 Applications 文件夹 3. 首次运行时,可能需要在系统偏好设置中允许应用运行 ### 解决 "应用已损坏,无法打开" 问题 由于 macOS 的安全机制,非 App Store 下载的应用可能会触发此提示。您可以按照以下步骤快速修复: ```bash sudo xattr -rd com.apple.quarantine "/Applications/ADB Toolbox.app" ``` 执行此命令后,再次尝试打开应用即可。 ## 使用指南 ### 设备管理 1. **连接设备**:通过 USB 或无线方式连接 Android 设备 2. **查看设备**:在 "Devices" 标签页中查看所有连接的设备 3. **设备操作**:点击设备查看详细信息和可用操作 ### 无线配对 1. 确保设备已通过 USB 连接 2. 切换到 "Wireless Pairing" 标签页 3. 点击 "Pair Device" 按钮开始配对过程 4. 按照提示在设备上确认配对请求 5. 配对成功后,可以断开 USB 连接,使用无线方式进行调试 ### 日志查看 1. 切换到 "Logcat" 标签页 2. 选择要查看日志的设备 3. 使用过滤器筛选日志内容 4. 点击 "Start" 按钮开始捕获日志 ### 应用管理 1. 切换到 "App Manager" 标签页 2. 选择目标设备 3. 查看已安装的应用列表 4. 点击应用进行安装、卸载或其他操作 ### 屏幕镜像 1. 切换到 "Screen Mirror" 标签页 2. 选择要镜像的设备 3. 点击 "Start Mirror" 按钮开始屏幕镜像 4. 使用快捷键控制镜像窗口(详见界面提示) ### ADB 服务器管理 1. 在侧边栏的 "Servers" 部分查看 ADB 服务器状态 2. 点击 "Start"、"Stop" 或 "Restart" 按钮控制服务器 3. 点击 "More Options" 查看详细的服务器信息和高级操作 ## 常见问题 ### ADB 服务器无法启动 - 检查端口 5037 是否被其他进程占用 - 尝试在 "Server Manager" 中使用 "Force Stop All ADB" 功能 - 重启计算机后再次尝试 ### 设备无法连接 - 确保设备已启用 USB 调试模式 - 检查 USB 线缆是否正常 - 尝试在 "Connection Doctor" 中运行诊断 - 对于无线连接,确保设备和计算机在同一网络 ### 屏幕镜像无显示 - 确保设备已正确连接 - 检查设备是否支持屏幕镜像 - 尝试重启 ADB 服务器后再次尝试 ## 技术架构 ADB Toolbox 采用现代 Swift 和 SwiftUI 构建,主要组件包括: - **服务层**:处理 ADB 命令执行和设备通信 - **模型层**:定义设备、应用等数据结构 - **视图层**:使用 SwiftUI 构建用户界面 - **工具类**:提供 Shell 执行、资源解析等功能 ## 内置 ADB 工具 ADB Toolbox 内置了最新版本的 Android 平台工具,包括: - adb - fastboot - etc1tool - hprof-conv - sqlite3 - 以及其他实用工具 应用会定期检查这些工具的更新,并提示用户进行升级。 ## 贡献 欢迎贡献代码和提出问题!请遵循以下步骤: 1. Fork 项目仓库 2. 创建功能分支 3. 提交更改 4. 发起 Pull Request ## 许可证 ADB Toolbox 采用 Apache-2.0 许可证。详见 LICENSE 文件。 ## 致谢 - 感谢 Android 开源项目提供的 ADB 工具 - 感谢 Scrcpy 项目提供的屏幕镜像功能 - 感谢所有为项目做出贡献的开发者 ## 联系方式 - 项目主页: - 问题反馈:/issues --- © 2026 ADB Toolbox. All rights reserved.