9.MobileTestTool使用说明书
手机测试辅助工具 (MobileTestTool) 使用说明书
📖 目录
软件简介
手机测试辅助工具 (MobileTestTool) 是一款专为Android设备测试和开发设计的综合性工具软件。该工具基于PyQt5构建，提供现代化的图形界面，支持实时日志管理、设备操作、网络监控、SIM卡工具等多种功能，是Android开发和测试人员的得力助手。
核心特性
- 🎯 多设备管理 - 同时连接和管理多个Android设备
- 📊 实时日志分析 - 强大的日志过滤和监控功能
- 🌐 网络测试 - 完整的网络信息监控和抓包功能
- 📱 设备操作 - 应用管理、截图录制、设备信息查询
- 🔧 自定义扩展 - 支持自定义按钮和Tab管理
- 🎨 现代化界面 - 双主题支持、流畅动画、多语言切换
- 📡 SIM卡工具 - 专业的SIM卡APDU解析和读写工具
系统要求
最低配置
- 操作系统: Windows 10/11 (64位)
- 内存: 4GB RAM
- 磁盘空间: 1GB 可用空间
- 网络: 用于下载更新（可选）
必需软件
-
Android SDK Platform-Tools
- 需要安装
adb命令 - 确保
adb已添加到系统 PATH 环境变量 - 测试方法：在命令提示符中输入
adb version，应能看到版本信息
- 需要安装
-
Python环境 (仅源码运行需要)
- Python 3.6 或更高版本
- 依赖包见
requirements.txt
USB连接要求
- 支持USB调试的Android设备
- USB数据线（推荐使用原装数据线）
- 设备已启用USB调试模式
安装与启动
方式一：使用预编译版本（推荐）
-
下载安装包
- 从项目发布页面下载最新的
MobileTestTool_版本号.zip - 解压到任意目录（建议路径简短，如
C:\MobileTestTool）
- 从项目发布页面下载最新的
-
首次启动
- 进入解压目录，双击
MobileTestTool.exe启动程序 - 首次启动可能稍慢，请耐心等待
- 进入解压目录，双击
-
自动更新
- 程序支持在线更新功能
- 在工具栏点击"检查更新"按钮可手动检测新版本
- 首次使用需要在"工具配置"中设置更新源URL
方式二：源码运行
-
克隆项目
git clone <repository-url> cd MobileTestTool -
安装依赖
pip install -r requirements.txt -
运行程序
python main.py
启动模式
程序支持两种运行模式：
- GUI模式（默认）：图形界面模式，直接运行
main.py或MobileTestTool.exe - CLI模式：命令行模式，用于SIM卡批量操作
python main.py -h # 查看帮助 python main.py -p PIN码 # 验证PIN码 python main.py -w data.json # 批量写入数据
界面介绍
主窗口布局
┌─────────────────────────────────────────────────────┐
│ 菜单栏 (文件/工具/帮助) │
├─────────────────────────────────────────────────────┤
│ 工具栏 (设备选择 | 刷新 | 检查更新 | 主题 | 语言) │
├─────────────────────────────────────────────────────┤
│ │
│ ┌─────────────────────┬─────────────────────────┐ │
│ │ │ │ │
│ │ 功能标签页 │ 日志显示区域 │ │
│ │ (可拖拽排序) │ (实时日志输出) │ │
│ │ │ │ │
│ │ - 日志控制 │ │ │
│ │ - 日志过滤 │ │ │
│ │ - 网络信息 │ │ │
│ │ - 应用操作 │ │ │
│ │ - 其他功能 │ │ │
│ │ ... │ │ │
│ │ │ │ │
│ └─────────────────────┴─────────────────────────┘ │
└─────────────────────────────────────────────────────┘
主要组件说明
1. 菜单栏
- 文件菜单：配置导入导出、退出程序
- 工具菜单：工具配置、显示行数设置
- 帮助菜单：关于、使用说明
2. 工具栏
- 设备选择：下拉框选择当前操作的设备
- 刷新按钮：刷新设备列表
- 检查更新：手动检测新版本
- 主题切换：在暗色/亮色主题间切换
- 语言切换：中英文切换
3. 功能标签页
包含所有功能模块的标签页，支持：
- 拖拽排序：直接拖拽标签页标题调整顺序
- 显示/隐藏：通过Tab管理功能控制显示
4. 日志显示区域
- 实时显示操作结果和日志输出
- 支持文本复制、搜索、清空
- 自动滚动到最新内容
快速开始
第一步：连接设备
-
启用USB调试
- 在Android设备上：设置 → 关于手机
- 连续点击"版本号"7次，开启开发者模式
- 返回设置 → 开发者选项 → 启用"USB调试"
-
连接设备
- 使用USB数据线连接设备到电脑
- 在设备上允许USB调试授权（首次连接会弹出提示）
-
选择设备
- 打开MobileTestTool程序
- 在工具栏的设备下拉框中选择你的设备
- 如果看不到设备，点击"刷新"按钮
第二步：基础操作示例
示例1：查看设备信息
- 切换到"应用操作"标签页
- 找到"设备信息"卡片
- 点击"获取设备信息"按钮
- 在日志区域查看设备信息（IMEI、型号、Android版本等）
示例2：实时日志过滤
- 切换到"日志过滤"标签页
- 在"关键字"输入框输入要过滤的关键词（如：
error） - 选择过滤选项（是否正则表达式、大小写敏感等）
- 点击"开始过滤"按钮
- 日志区域将实时显示匹配的日志行
示例3：截图功能
- 切换到"其他"标签页
- 找到"截图录制"卡片
- 点击"截图"按钮
- 截图会自动保存到
C:\log\日期\screenshot\目录
功能详解
📊 日志管理模块
1. 日志过滤 (Log Filter)
功能说明：实时过滤和显示ADB logcat日志中的特定内容
使用步骤：
- 切换到"日志过滤"标签页
- 在"关键字"输入框输入过滤关键词
- 普通模式：直接输入关键词，如
error、crash - 正则模式：勾选"使用正则表达式"，支持正则语法
- 普通模式：直接输入关键词，如
- 设置过滤选项：
- 使用正则表达式：启用正则匹配模式
- 大小写敏感：区分大小写
- 排除模式：显示不包含关键词的日志
- 点击"开始过滤"按钮开始过滤
- 点击"停止过滤"按钮停止过滤
- 使用"保存日志"按钮将过滤结果保存到文件
应用场景：
- 查找特定的错误信息
- 监控特定应用的日志输出
- 跟踪系统事件
2. 日志控制 (Log Control)
MTKLOG管理
MTKLOG是MediaTek设备特有的日志系统，用于收集完整的系统日志。
开启MTKLOG：
- 在"日志控制"标签页找到"MTKLOG控制"卡片
- 选择存储模式：
- SD模式：日志保存在设备SD卡
- USB模式：日志保存在设备内部存储
- 点击"开启"按钮
- 程序会自动执行完整的MTKLOG初始化序列
- 日志开始收集，状态显示为"运行中"
停止并导出MTKLOG：
- 点击"停止&导出"按钮
- 程序会停止日志收集并导出到PC
- 日志文件保存在
C:\log\日期\log_xxx\目录
其他日志功能：
- ADB Log：后台运行logcat，支持导出
- Google Log：收集Google服务相关日志
- AEE Log：收集异常日志
- Bugreport：生成完整的系统bugreport
🌐 网络测试模块
1. 网络信息监控
功能说明：实时监控设备的蜂窝网络和WiFi连接信息
使用步骤：
- 切换到"网络信息"标签页
- 点击"开始获取网络信息"按钮
- 程序会实时显示：
- 蜂窝网络信息：运营商、信号强度、频段、小区ID等
- WiFi信息：SSID、MAC地址、IP地址、连接速度等
- 点击"停止获取"按钮停止监控
显示的信息包括：
- 网络类型（LTE、5G、WiFi等）
- 信号强度（RSRP、RSSI）
- 频段和载波聚合信息
- 小区信息（PCI、TAC等）
- 连接质量指标
2. Telephony日志
功能说明：启用和管理Android Telephony服务日志
使用步骤：
- 在"网络信息"标签页找到"Telephony日志"卡片
- 点击"启用Telephony日志"按钮
- 设备会启用详细的电话服务日志
- 日志可以通过logcat查看
3. TCPDump抓包
功能说明：捕获设备的网络数据包
使用步骤：
- 在"网络信息"标签页找到"TCPDump"卡片
- 点击"开始抓包"按钮
- 程序会在设备上启动tcpdump进程
- 执行需要抓包的操作
- 点击"停止抓包"按钮
- 抓包文件会自动导出到
C:\log\日期\tcpdump\目录
注意事项：
- 需要设备具有root权限
- 抓包文件可能很大，注意磁盘空间
📱 设备操作模块
1. 设备信息查询
功能说明：快速获取设备的基本信息
可查询的信息：
- IMEI（国际移动设备识别码）
- 设备型号和制造商
- Android版本和API级别
- 序列号
- ICCID、IMSI（需要SIM卡）
- 屏幕分辨率
- 存储信息
使用步骤：
- 切换到"应用操作"标签页
- 在"设备信息"卡片点击"获取设备信息"按钮
- 信息显示在日志区域
2. 应用管理
功能说明：安装、卸载、查询Android应用
安装应用：
- 在"应用操作"标签页找到"应用操作"卡片
- 点击"安装APK"按钮
- 选择要安装的APK文件
- 安装进度显示在日志区域
卸载应用：
- 在"应用包名"输入框输入包名（如：
com.android.chrome） - 点击"卸载应用"按钮
- 确认卸载操作
查询应用信息：
- 输入应用包名
- 点击"查询应用信息"按钮
- 显示应用的详细信息
清除应用数据：
- 输入应用包名
- 点击"清除应用数据"按钮
- 清除应用缓存和用户数据
3. 截图和录制
截图功能：
- 切换到"其他"标签页
- 在"截图录制"卡片点击"截图"按钮
- 截图自动保存到
C:\log\日期\screenshot\目录 - 文件名格式：
screenshot_YYYYMMDD_HHMMSS.png
录制功能：
- 点击"开始录制"按钮开始录制屏幕
- 执行需要录制的操作
- 点击"停止录制"按钮
- 视频文件保存到
C:\log\日期\video\目录 - 文件名格式：
screenrecord_YYYYMMDD_HHMMSS.mp4
注意事项：
- 录制功能需要Android 4.4+
- 录制文件可能很大
- 录制时间限制取决于设备性能
🏢 TMO专用功能
本工具包含一些专为T-Mobile测试设计的功能。
1. TMO CC配置管理
功能说明：管理TMO的CC配置文件
使用步骤：
- 切换到"TMO CC"标签页
- 拉取CC文件：点击"拉取CC文件"按钮，从设备获取当前配置
- 推送CC文件：点击"推送CC文件"按钮，将配置文件推送到设备
- 查看CC文件：点击"查看CC文件"按钮，查看本地保存的配置文件
2. Echolocate文件管理
功能说明：收集和管理Echolocate测试文件
使用步骤：
- 切换到"TMO Echolocate"标签页
- 点击"收集Echolocate文件"按钮
- 程序会从设备收集相关文件
- 文件保存到
C:\log\日期\echolocate\目录
3. 背景数据配置
功能说明：配置和管理后台数据使用
使用步骤：
- 切换到"背景数据"标签页
- 查看和修改应用的背景数据使用设置
- 支持批量操作
4. 赫拉配置管理
功能说明：管理赫拉测试相关配置
使用步骤：
- 在"应用操作"标签页找到"赫拉配置"卡片
- 使用相关按钮进行配置管理
📡 SIM卡工具
1. SIM APDU解析器
功能说明：专业的SIM卡APDU消息解析工具，支持多种格式和详细解析
启动方式：
- 切换到"SIM"标签页
- 点击"启动 APDU 解析器"按钮
加载数据：
- MTK原始日志：点击"加载 MTK 原始日志"，选择MTK格式的日志文件
- APDU文本：点击"加载 APDU 文本（每行）"，选择每行一个APDU消息的文本文件
筛选和搜索：
- 使用"筛选类别"下拉菜单选择APDU类型：
- eSIM消息
- CAT命令
- 普通SIM卡消息
- 全部
- 在搜索框输入正则表达式进行搜索
- 勾选"搜索右侧详情"可在解析结果中搜索
查看详情：
- 点击左侧列表中的项目，右侧显示详细的解析结果
- 解析结果包括TLV结构、字段含义等
复制功能：
- 右键点击列表项，选择"复制"可复制消息内容
- 右键点击解析结果，可复制解析内容
详细文档：参考 SIM_APDU_Parser/README.md
2. SIM卡读写工具
功能说明：完整的SIM卡数据读写和管理工具，支持GUI和CLI两种模式
GUI模式使用：
-
启动工具：
- 切换到"SIM"标签页
- 点击"启动 SIM 卡读写工具"按钮
-
连接设备：
- 从端口下拉框选择串口（COM端口）
- 选择端口后程序自动测试和连接
- 连接成功后状态显示为"已连接"
-
读取数据：
- 在左侧文件树中选择要读取的EF文件
- 点击"Read"按钮读取数据
- 数据会显示在右侧表格中
-
写入数据：
- 在表格中编辑数据
- 点击"Update"按钮写入修改
- 写入前需要验证PIN码
-
批量操作：
- 点击"Load JSON"按钮加载JSON配置文件
- 支持批量读取和写入多个EF文件
- JSON格式参考CLI模式说明
-
PIN管理：
- 切换到"PINs管理"标签页
- 输入PIN码（测试SIM通常为
55555555或11111111） - 点击"Verify"按钮验证PIN码
CLI模式使用：
命令行模式适合批量操作和自动化脚本。
# 查看帮助信息
python main.py --help
# 验证PIN码
python main.py -p 55555555
# 验证PIN并批量写入数据
python main.py -p 55555555 -w data.json
# 仅批量写入（需要先验证PIN）
python main.py -w data.json
JSON数据格式：
{
"EF_list": [
{
"ef_id": "6F07",
"adf_type": "USIM",
"records": [
{
"field1": "value1",
"field2": "value2"
}
]
},
{
"ef_id": "6F06",
"adf_type": "USIM",
"records": [
{
"arr": "01",
"opc": "1234567890ABCDEF",
"op": "ABCDEF1234567890"
}
]
}
]
}
支持的EF文件：
- 6F07 (IMSI)
- 6F06 (ARR/ADN)
- 6F38 (UST)
- 2FE2 (ICCID)
- 以及其他标准EF文件
🔧 自定义功能
1. 自定义按钮
功能说明：创建自己的功能按钮，支持多种操作类型
创建按钮步骤：
- 切换到"其他"标签页
- 点击"🔧 管理自定义按钮"按钮（绿色按钮）
- 在对话框中点击"➕ 添加"按钮
- 填写按钮信息：
- 按钮名称：显示在界面上的文字
- 按钮类型：选择操作类型（见下方说明）
- 命令/路径：根据类型填写相应内容
- 所在Tab：选择按钮显示在哪个标签页
- 所在卡片：选择按钮显示在哪个功能卡片
- 描述：按钮功能说明（可选）
- 点击"保存"按钮
- 按钮立即生效，无需重启程序
支持的按钮类型：
-
📱 ADB命令
- 执行Android设备命令
- 示例：
reboot、shell getprop ro.product.model
-
🐍 Python脚本
- 执行自定义Python代码
- 输出显示在日志区域
- 示例：计算、数据处理、格式化输出
-
📁 打开文件
- 快速打开PC上的文件或文件夹
- 示例：
C:\Users\用户名\Desktop\文档.txt
-
🖥️ 运行程序
- 启动PC上的程序
- 示例：
C:\Program Files\Notepad++\notepad++.exe
-
💻 系统命令
- 执行系统命令行指令
- 示例：
ipconfig、ping 8.8.8.8
配置管理：
- 导出配置：点击"导出"按钮，保存按钮配置到JSON文件
- 导入配置：点击"导入"按钮，从JSON文件加载按钮配置
- 编辑按钮：在列表中双击按钮进行编辑
- 删除按钮：选中按钮后点击"删除"按钮
详细文档：参考 docs/自定义按钮功能完整指南.md
2. Tab管理
功能说明：管理标签页的显示、顺序和自定义内容
Tab拖拽排序：
- 直接在主界面拖拽Tab标题即可调整顺序
- 顺序自动保存
Tab显示/隐藏：
- 切换到"其他"标签页
- 点击"📋 Tab管理"按钮
- 在"Tab排序和显示"标签页中：
- 勾选/取消勾选Tab名称前的复选框
- 点击"保存"按钮应用更改
- 更改立即生效
创建自定义Tab：
- 在Tab管理对话框中切换到"自定义Tab"标签页
- 点击"添加Tab"按钮
- 填写Tab信息：
- Tab名称
- 描述信息
- 包含的Card列表
- 点击"保存"
创建自定义Card：
- 在Tab管理对话框中切换到"自定义Card"标签页
- 点击"添加Card"按钮
- 填写Card信息：
- Card名称
- 描述信息
- 所属Tab
- 按钮列表
- 点击"保存"
详细文档：参考 docs/Tab管理功能完整指南.md
🎨 界面个性化
1. 主题切换
功能说明：在暗色和亮色主题之间切换
使用方法：
- 在工具栏点击主题切换按钮（🌙/☀️图标）
- 主题立即切换并自动保存偏好
2. 语言切换
功能说明：切换界面语言（中文/英文）
使用方法：
- 在工具栏点击语言切换按钮（🌐图标）
- 语言立即切换并自动保存偏好
3. 显示行数设置
功能说明：设置日志显示区域的最大行数
使用方法：
- 菜单栏 → 工具 → 显示行数设置
- 输入最大行数（建议1000-5000）
- 点击确定
说明：当日志超过最大行数时，会自动删除最旧的内容，保持界面流畅。
高级功能
在线更新
功能说明：自动检测和下载新版本
首次配置：
- 菜单栏 → 工具 → 工具配置
- 填写以下配置：
- 版本描述 URL：
https://raw.githubusercontent.com/pranvil/MobileTestTool/main/releases/latest.json - 下载目录：留空使用系统临时目录，或自定义路径
- 下载完成后自动打开安装包：勾选后自动运行下载的文件
- 网络超时 (秒)：5~300秒，默认15秒
- 版本描述 URL：
- 点击"确定"保存配置
检查更新：
- 在工具栏点击"检查更新"按钮
- 程序会在后台检查新版本
- 如果有新版本，会显示更新对话框
- 可以查看版本说明和SHA256校验值
- 点击"下载"开始下载，显示下载进度
- 下载完成后可选择打开安装包或定位文件
版本描述文件格式：
{
"version": "0.9.4",
"download_url": "https://example.com/releases/MobileTestTool_0.9.4.zip",
"sha256": "0123456789abcdef...",
"file_name": "MobileTestTool_0.9.4.zip",
"file_size": 123456789,
"release_notes": "- 修复已知问题\n- 优化性能",
"published_at": "2025-10-31T08:00:00Z",
"mandatory": false
}
配置备份和恢复
导出配置：
- 菜单栏 → 文件 → 导出配置
- 选择保存位置
- 配置文件包含：
- 自定义按钮配置
- Tab配置
- 主题和语言偏好
- 工具配置
导入配置：
- 菜单栏 → 文件 → 导入配置
- 选择之前导出的配置文件
- 配置立即生效
Python脚本功能
功能说明：在自定义按钮中执行Python代码
支持的模块：
- 内置函数：
print、len、str、int等 - 标准库：
datetime、json、os、sys、platform等 - 自定义变量：
device_manager（设备管理器对象）
示例脚本：
# 获取当前时间
import datetime
now = datetime.datetime.now()
print(f"当前时间: {now.strftime('%Y-%m-%d %H:%M:%S')}")
# 获取设备信息
if device_manager:
device = device_manager.get_current_device()
if device:
print(f"当前设备: {device}")
安全限制：
- 只能使用安全的模块和函数
- 不能访问文件系统（受限）
- 不能执行系统命令（使用系统命令按钮类型）
详细文档：参考 docs/Python脚本功能使用指南.md
RRC 3GPP解码器
功能说明：解码RRC 3GPP协议消息
使用方法：
- 在"网络信息"标签页找到"RRC 3GPP解码器"卡片
- 输入或粘贴RRC消息的十六进制字符串
- 点击"解码"按钮
- 查看解码结果
密钥日志管理
功能说明：管理日志中的关键字过滤规则
使用方法：
- 在"日志过滤"标签页找到"关键字管理"卡片
- 点击"管理关键字"按钮
- 添加、编辑或删除关键字规则
- 保存后可在日志过滤中使用
QC NV工具
功能说明：Qualcomm设备的NV参数管理工具
使用方法：
- 在"其他"标签页找到"QC NV工具"卡片
- 使用相关功能读取和修改NV参数
- 注意：此功能需要root权限，操作需谨慎
秘密代码
功能说明：执行Android设备的隐藏菜单代码（如*#06#）
使用方法：
- 在"其他"标签页找到"秘密代码"卡片
- 从列表中选择代码或手动输入
- 点击"执行"按钮
常见问题
设备连接问题
Q: 程序检测不到设备？
A: 请检查以下事项：
- 确保USB调试已启用（设置 → 开发者选项 → USB调试）
- 检查USB连接是否正常（尝试更换USB线或USB端口）
- 在设备上允许USB调试授权（首次连接会弹出提示）
- 在命令行运行
adb devices检查设备是否被识别 - 如果仍无法识别，尝试重启adb服务：
adb kill-server然后adb start-server - 某些设备需要安装特定的USB驱动
Q: 显示"设备离线"？
A:
- 断开USB连接后重新连接
- 在设备上撤销USB调试授权后重新授权
- 重启adb服务（见上方）
- 检查设备USB连接模式（应选择"文件传输"或"MTP"模式）
功能使用问题
Q: MTKLOG开启失败？
A:
- 确保设备是MediaTek芯片
- 检查设备是否支持MTKLOG功能
- 确保设备有足够的存储空间
- 尝试切换存储模式（SD模式/USB模式）
- 某些操作需要root权限
Q: 日志过滤没有结果？
A:
- 检查关键字是否正确
- 如果使用正则表达式，检查正则语法是否正确
- 尝试取消"大小写敏感"选项
- 确认设备正在产生相关日志
- 检查logcat服务是否正常运行
Q: 截图或录制失败？
A:
- 确保设备Android版本 >= 4.4（录制功能）
- 检查设备存储空间
- 确保PC上的保存目录有写入权限
- 某些设备可能需要额外的权限
Q: 自定义按钮不执行？
A:
- 检查命令语法是否正确
- 对于ADB命令，确保设备已连接
- 对于文件操作，检查文件路径是否正确
- 查看日志区域的错误信息
- 某些命令可能需要管理员权限
SIM卡工具问题
Q: SIM卡读写工具无法连接端口？
A:
- 确认设备已通过USB连接
- 检查端口是否被其他程序占用
- 确认设备驱动已正确安装
- 尝试点击"Refresh Port"按钮刷新端口列表
- 某些设备需要使用特定的USB端口
Q: SIM卡操作返回权限错误？
A:
- 确保已正确输入PIN码（测试SIM通常为
55555555或11111111） - 某些EF文件需要管理员权限（ADM），可能无法直接访问
- 检查SIM卡状态（是否锁定）
- 查看错误提示中的状态码说明
Q: APDU解析器无法加载文件？
A:
- 检查文件格式是否正确
- MTK日志格式：应包含APDU消息的原始数据
- APDU文本格式：每行应为一个完整的APDU消息（十六进制）
- 检查文件编码（应为UTF-8或纯文本）
性能问题
Q: 程序运行很慢？
A:
- 关闭不必要的标签页（使用Tab管理隐藏）
- 减少日志显示区域的最大行数
- 停止不需要的日志过滤或监控
- 检查PC性能（CPU和内存使用率）
- 关闭其他占用资源的程序
Q: 日志区域卡顿？
A:
- 减少最大显示行数（工具 → 显示行数设置）
- 停止实时日志过滤
- 定期清空日志区域
- 关闭自动滚动功能（如果支持）
配置问题
Q: 配置丢失了？
A:
- 检查配置文件位置：
~/.netui/目录 - 如果配置文件损坏，可以删除后重新配置
- 建议定期使用"导出配置"功能备份配置
- 配置文件是JSON格式，可以手动编辑（需谨慎）
Q: 主题或语言设置不生效？
A:
- 重启程序
- 检查配置文件权限
- 尝试重置配置（删除配置文件）
其他问题
Q: 程序崩溃或无响应？
A:
- 查看日志文件：
logs/debug_日期_时间.txt - 尝试重启程序
- 如果问题持续，尝试删除配置文件重新开始
- 检查是否有杀毒软件拦截
Q: 打包后的EXE无法运行？
A:
- 确保所有依赖文件都在同一目录
- 检查是否有杀毒软件误报
- 尝试以管理员身份运行
- 查看错误提示信息
Q: 如何查看详细的错误信息？
A:
- 查看日志文件：程序运行目录下的
logs/文件夹 - 日志文件命名格式：
debug_YYYYMMDD_HHMMSS.txt - 日志包含详细的错误堆栈信息
技术支持
获取帮助
-
查看文档
- 本使用说明书
- 项目README.md
- 各功能模块的详细指南（docs目录）
-
查看日志
- 程序运行日志：
logs/debug_*.txt - 错误信息会记录在日志文件中
- 程序运行日志：
-
联系支持
- GitHub Issues：[项目Issues页面]
- 项目Wiki：[项目Wiki页面]
反馈问题
提交问题报告时，请包含以下信息：
- 软件版本：菜单栏 → 帮助 → 关于
- 操作系统：Windows版本
- 设备信息：Android版本、设备型号
- 问题描述：详细描述问题现象
- 复现步骤：如何重现问题
- 日志文件：相关的日志文件内容
- 截图：如果有错误提示，请提供截图
贡献代码
欢迎贡献代码和功能改进！
- Fork项目
- 创建功能分支
- 提交更改
- 创建Pull Request
附录
文件存储结构
所有生成的文件统一存储在 C:\log\YYYYMMDD\ 目录下：
C:\log\20241103\
├── screenshot\ # 截图文件
│ └── screenshot_20241103_143025.png
├── video\ # 视频文件
│ └── screenrecord_20241103_143100.mp4
├── log_xxx\ # MTKLOG日志
│ ├── dbg_info_small/
│ └── ...
├── tcpdump\ # TCPDump抓包文件
│ └── capture.pcap
├── logcat\ # ADB日志文件
│ └── logcat_20241103.txt
├── ccfile\ # TMO CC文件
│ └── cc_file.json
└── echolocate\ # Echolocate文件
└── ...
快捷键说明
- Ctrl+C：复制日志区域选中文本
- Ctrl+A：全选日志区域文本
- F5：刷新设备列表（部分功能）
- Esc：关闭对话框（部分对话框）
配置文件位置
- 主配置目录：
%USERPROFILE%\.netui\ - 日志目录：程序运行目录下的
logs\ - 临时文件：系统临时目录
版本历史
-
v0.9.4（当前版本）
- 修复自定义管理界面UI问题
- 增加自定义按钮搜索过滤功能
- 统一自定义tab的UI布局
- 优化device info读取速度
- 分GUI/CLI模块
-
v0.10
- SIM卡工具集成
- 代码优化和清理
-
v0.9
- Tab管理功能
- 自定义按钮功能
- 文档整合优化
免责声明
本工具仅用于合法的测试和开发目的。使用本工具时，请确保：
- 您有权限对目标设备进行操作
- 遵守相关法律法规
- 不用于非法用途
- 操作前备份重要数据
使用本工具造成的任何数据丢失或设备损坏，开发者不承担责任。
最后更新：2025年11月
文档版本：1.0
Made with ❤️ by MobileTestTool Team