160 lines
4.3 KiB
Markdown
160 lines
4.3 KiB
Markdown
|
# 安卓文件日志系统使用说明
|
|||
|
|
|
|||
|
|
## 概述
|
|||
|
|
|
|||
|
|
为了解决安卓板运行20分钟后闪退的问题，我们添加了完整的文件日志记录系统。该系统会自动将关键日志保存到安卓设备的本地存储中，即使应用闪退，日志文件也会保留，便于分析问题原因。
|
|||
|
|
|
|||
|
|
## 日志文件位置
|
|||
|
|
|
|||
|
|
**安卓设备路径：** `/sdcard/Android/data/[应用包名]/files/logs/`
|
|||
|
|
|
|||
|
|
示例完整路径：
|
|||
|
|
```
|
|||
|
|
/sdcard/Android/data/com.yourcompany.dcx/files/logs/dcx_log_20241113_143022.txt
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 日志文件获取方法
|
|||
|
|
|
|||
|
|
### 方法1：直接在设备上查看
|
|||
|
|
- 使用设备上的文件管理器
|
|||
|
|
- 导航到上述路径
|
|||
|
|
- 查看或分享 `dcx_log_*.txt` 文件
|
|||
|
|
|
|||
|
|
### 方法2：使用ADB命令（推荐）
|
|||
|
|
```bash
|
|||
|
|
# 连接设备后执行
|
|||
|
|
adb pull /sdcard/Android/data/[包名]/files/logs/ ./logs/
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 方法3：通过内置日志查看器
|
|||
|
|
- 在应用中添加了 `AndroidLogViewer` 组件
|
|||
|
|
- 可以直接在界面上查看日志内容
|
|||
|
|
- 支持切换不同的日志文件
|
|||
|
|
|
|||
|
|
## 日志内容说明
|
|||
|
|
|
|||
|
|
### 记录的关键信息
|
|||
|
|
|
|||
|
|
1. **系统信息**
|
|||
|
|
- 设备型号、操作系统版本
|
|||
|
|
- Unity版本、内存配置
|
|||
|
|
- 应用启动时间
|
|||
|
|
|
|||
|
|
2. **内存监控**
|
|||
|
|
- 实时内存使用情况
|
|||
|
|
- 内存清理操作记录
|
|||
|
|
- 队列状态信息
|
|||
|
|
|
|||
|
|
3. **设备状态**
|
|||
|
|
- BFI数值异常情况
|
|||
|
|
- 电池电量变化
|
|||
|
|
- 通信连接状态
|
|||
|
|
|
|||
|
|
4. **错误信息**
|
|||
|
|
- 串口通信异常
|
|||
|
|
- 数据解析错误
|
|||
|
|
- 系统异常和崩溃信息
|
|||
|
|
|
|||
|
|
### 日志格式示例
|
|||
|
|
```
|
|||
|
|
[14:30:22.123] [INFO] [Memory] 内存使用: 245.6MB - 队列状态: 发送队列:2, 接收队列:15, 连接状态:已连接
|
|||
|
|
[14:30:25.456] [ERROR] [DeviceStatus] BFI值异常: NaN, 电量: 0%
|
|||
|
|
[14:30:28.789] [ERROR] [Communication] 串口通信异常，时间: 14:30:28
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 系统优化功能
|
|||
|
|
|
|||
|
|
### 1. 内存管理
|
|||
|
|
- 自动监控内存使用，超过300MB时强制清理
|
|||
|
|
- 队列大小限制：发送队列≤10，接收队列≤50
|
|||
|
|
- BFI数据点限制：最多1800个（30分钟）
|
|||
|
|
|
|||
|
|
### 2. 日志轮转
|
|||
|
|
- 单个日志文件最大5MB
|
|||
|
|
- 最多保留5个历史文件
|
|||
|
|
- 自动清理过期日志
|
|||
|
|
|
|||
|
|
### 3. 平台优化
|
|||
|
|
- 安卓平台减少95%的调试日志输出
|
|||
|
|
- 只记录关键错误和状态变化
|
|||
|
|
- 异步写入，不影响主线程性能
|
|||
|
|
|
|||
|
|
## 故障排除步骤
|
|||
|
|
|
|||
|
|
### 1. 获取闪退前日志
|
|||
|
|
```bash
|
|||
|
|
# 闪退后立即执行
|
|||
|
|
adb pull /sdcard/Android/data/[包名]/files/logs/ ./crash_logs/
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 2. 分析关键信息
|
|||
|
|
查看最新的日志文件，重点关注：
|
|||
|
|
- `[ERROR]` 标记的错误信息
|
|||
|
|
- 内存使用超过300MB的记录
|
|||
|
|
- BFI值异常的记录
|
|||
|
|
- 通信中断的时间点
|
|||
|
|
|
|||
|
|
### 3. 常见问题模式
|
|||
|
|
- **内存泄漏：** 内存持续增长，超过300MB
|
|||
|
|
- **数据解析错误：** BFI值为NaN或超出合理范围
|
|||
|
|
- **通信故障：** 频繁的串口异常记录
|
|||
|
|
- **队列溢出：** 接收队列长度持续增长
|
|||
|
|
|
|||
|
|
## 性能影响
|
|||
|
|
|
|||
|
|
### 内存使用
|
|||
|
|
- 日志缓冲区：最多2000行 ≈ 500KB
|
|||
|
|
- 文件写入：批量处理，每次最多100条记录
|
|||
|
|
- 总体内存增加：< 2MB
|
|||
|
|
|
|||
|
|
### 存储使用
|
|||
|
|
- 每小时约生成：2-5MB日志文件
|
|||
|
|
- 最多占用存储：25MB（5个文件 × 5MB）
|
|||
|
|
- 自动清理：保持合理的存储占用
|
|||
|
|
|
|||
|
|
### CPU影响
|
|||
|
|
- 后台定期写入：每10秒检查一次
|
|||
|
|
- 异步处理：不阻塞主线程
|
|||
|
|
- 错误时立即写入：确保关键信息不丢失
|
|||
|
|
|
|||
|
|
## 使用建议
|
|||
|
|
|
|||
|
|
1. **运行测试时**
|
|||
|
|
- 确保设备有足够存储空间（至少100MB可用）
|
|||
|
|
- 在测试前清空旧日志文件
|
|||
|
|
- 记录测试开始和结束时间
|
|||
|
|
|
|||
|
|
2. **闪退后分析**
|
|||
|
|
- 立即导出日志文件
|
|||
|
|
- 查看最后几分钟的内存变化
|
|||
|
|
- 检查是否有重复的错误模式
|
|||
|
|
|
|||
|
|
3. **长期监控**
|
|||
|
|
- 定期检查日志文件大小
|
|||
|
|
- 观察内存使用趋势
|
|||
|
|
- 记录闪退发生的时间和环境
|
|||
|
|
|
|||
|
|
## 技术实现
|
|||
|
|
|
|||
|
|
### 核心组件
|
|||
|
|
- `AndroidFileLogger`：主要日志记录器
|
|||
|
|
- `DCXManager`：集成内存监控和日志记录
|
|||
|
|
- `DataService`：设备状态日志记录
|
|||
|
|
- `SerialCommunicationService`：通信错误日志记录
|
|||
|
|
|
|||
|
|
### 日志过滤规则
|
|||
|
|
```csharp
|
|||
|
|
// 跳过的日志类型
|
|||
|
|
- [帧处理] 普通日志
|
|||
|
|
- [队列] 非警告日志
|
|||
|
|
- OptimizedLog 调试信息
|
|||
|
|
- Memory 普通内存日志
|
|||
|
|
|
|||
|
|
// 记录的关键日志
|
|||
|
|
- [ERROR] 所有错误
|
|||
|
|
- [内存警告] 内存超限
|
|||
|
|
- [异常] 系统异常
|
|||
|
|
- 设备状态变化
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
这个日志系统将帮助您准确定位20分钟闪退的根本原因。请在下次测试时注意观察日志文件的生成和内容记录。
|