|
|
# ScannerView 扫描结果跳转 QRCodeDetailView 功能
|
|
|
|
|
|
## 概述
|
|
|
|
|
|
本次更新修改了 `ScannerView.swift`，使其在扫描到二维码或条形码结果时，能够自动跳转到 `QRCodeDetailView.swift` 详情页面，而不是仅仅发送通知。
|
|
|
|
|
|
## 主要功能
|
|
|
|
|
|
### 1. 自动跳转详情页
|
|
|
- 当用户选择扫描到的条码时，自动跳转到二维码详情页面
|
|
|
- 支持单个条码自动选择和多个条码手动选择
|
|
|
- 使用 `NavigationLink` 进行页面导航（非模态展示）
|
|
|
|
|
|
### 2. 自动保存历史记录
|
|
|
- 扫描到的条码自动保存到 Core Data 历史记录
|
|
|
- 数据来源标记为 "scanned"（扫描获得）
|
|
|
- 自动识别条码类型（二维码/条形码）
|
|
|
|
|
|
### 3. 智能类型识别
|
|
|
- 二维码：自动解析内容类型（Wi-Fi、URL、SMS、vCard等）
|
|
|
- 条形码：保存原始类型信息
|
|
|
- 使用 `QRCodeParser` 进行智能解析
|
|
|
|
|
|
### 4. 返回时自动重新扫描
|
|
|
- 从详情页返回时自动重新开始扫描
|
|
|
- 重置所有扫描状态
|
|
|
- 提供流畅的用户体验
|
|
|
|
|
|
## 技术实现
|
|
|
|
|
|
### 新增状态变量
|
|
|
```swift
|
|
|
@State private var navigateToDetail = false
|
|
|
@State private var selectedHistoryItem: HistoryItem?
|
|
|
```
|
|
|
|
|
|
### 修改扫描结果处理
|
|
|
```swift
|
|
|
private func handleCodeSelection(_ selectedCode: DetectedCode) {
|
|
|
// 创建 HistoryItem 并保存到 Core Data
|
|
|
let historyItem = createHistoryItem(from: selectedCode)
|
|
|
|
|
|
// 设置选中的历史记录项并导航到详情页
|
|
|
selectedHistoryItem = historyItem
|
|
|
navigateToDetail = true
|
|
|
|
|
|
// 发送通知（保持向后兼容）
|
|
|
NotificationCenter.default.post(name: .scannerDidScanCode, object: formattedResult)
|
|
|
}
|
|
|
```
|
|
|
|
|
|
### 新增历史记录创建方法
|
|
|
```swift
|
|
|
private func createHistoryItem(from detectedCode: DetectedCode) -> HistoryItem {
|
|
|
let context = CoreDataManager.shared.container.viewContext
|
|
|
let historyItem = HistoryItem(context: context)
|
|
|
|
|
|
// 设置基本信息
|
|
|
historyItem.id = UUID()
|
|
|
historyItem.content = detectedCode.content
|
|
|
historyItem.dataType = DataType.qrcode.rawValue
|
|
|
historyItem.dataSource = DataSource.scanned.rawValue
|
|
|
historyItem.createdAt = Date()
|
|
|
historyItem.isFavorite = false
|
|
|
|
|
|
// 智能类型识别
|
|
|
if detectedCode.type.lowercased().contains("qr") || detectedCode.type.lowercased().contains("二维码") {
|
|
|
let parsedData = QRCodeParser.parseQRCode(detectedCode.content)
|
|
|
historyItem.qrCodeType = parsedData.type.rawValue
|
|
|
} else {
|
|
|
historyItem.barcodeType = detectedCode.type
|
|
|
}
|
|
|
|
|
|
// 保存到 Core Data
|
|
|
CoreDataManager.shared.addHistoryItem(historyItem)
|
|
|
|
|
|
return historyItem
|
|
|
}
|
|
|
```
|
|
|
|
|
|
### 使用 NavigationLink 进行导航
|
|
|
```swift
|
|
|
.background(
|
|
|
NavigationLink(
|
|
|
destination: Group {
|
|
|
if let historyItem = selectedHistoryItem {
|
|
|
QRCodeDetailView(historyItem: historyItem)
|
|
|
.onDisappear {
|
|
|
// 从详情页返回时，重新开始扫描
|
|
|
logInfo("🔄 从详情页返回，重新开始扫描", className: "ScannerView")
|
|
|
resetToScanning()
|
|
|
}
|
|
|
}
|
|
|
},
|
|
|
isActive: $navigateToDetail
|
|
|
) {
|
|
|
EmptyView()
|
|
|
}
|
|
|
)
|
|
|
```
|
|
|
|
|
|
## 用户体验流程
|
|
|
|
|
|
1. **扫描阶段**：用户使用扫描器扫描二维码/条形码
|
|
|
2. **结果检测**：系统检测到条码，暂停预览
|
|
|
3. **选择确认**：
|
|
|
- 单个条码：1秒后自动选择
|
|
|
- 多个条码：用户手动点击选择点
|
|
|
4. **自动跳转**：选择后自动导航到详情页
|
|
|
5. **详情展示**：显示条码图片、类型、解析信息、操作按钮等
|
|
|
6. **返回扫描**：用户返回时自动重新开始扫描
|
|
|
|
|
|
## 导航方式对比
|
|
|
|
|
|
### 之前使用 Sheet（模态展示）
|
|
|
- 优点：简单实现，覆盖整个屏幕
|
|
|
- 缺点：模态展示，用户体验不够流畅
|
|
|
|
|
|
### 现在使用 NavigationLink（页面导航）
|
|
|
- 优点：原生导航体验，支持返回手势，更流畅
|
|
|
- 缺点：需要处理返回时的状态重置
|
|
|
|
|
|
## 返回时重新扫描机制
|
|
|
|
|
|
### 触发时机
|
|
|
- 用户点击返回按钮
|
|
|
- 用户使用返回手势
|
|
|
- 详情页面消失时
|
|
|
|
|
|
### 重置内容
|
|
|
```swift
|
|
|
.onDisappear {
|
|
|
// 从详情页返回时，重新开始扫描
|
|
|
logInfo("🔄 从详情页返回，重新开始扫描", className: "ScannerView")
|
|
|
resetToScanning()
|
|
|
}
|
|
|
```
|
|
|
|
|
|
### 重置过程
|
|
|
1. 重置 UI 状态（`showPreviewPause = false`）
|
|
|
2. 重置扫描状态（`resetDetection()`）
|
|
|
3. 重新开始扫描（`restartScanning()`）
|
|
|
4. 延迟检查会话状态
|
|
|
|
|
|
## 向后兼容性
|
|
|
|
|
|
- 保留了原有的 `NotificationCenter` 通知机制
|
|
|
- 其他依赖扫描结果的组件仍然可以正常工作
|
|
|
- 不影响现有的扫描和检测逻辑
|
|
|
|
|
|
## 文件修改
|
|
|
|
|
|
- **主要文件**：`MyQrCode/ScannerView/ScannerView.swift`
|
|
|
- **新增导入**：`import CoreData`
|
|
|
- **状态变量**：`navigateToDetail`、`selectedHistoryItem`
|
|
|
- **新增方法**：`createHistoryItem(from:)`
|
|
|
- **导航方式**：从 `.sheet` 改为 `NavigationLink`
|
|
|
- **返回处理**：添加 `.onDisappear` 回调
|
|
|
|
|
|
## 依赖关系
|
|
|
|
|
|
- `CoreDataManager.shared`：用于保存历史记录
|
|
|
- `QRCodeParser`：用于解析二维码类型
|
|
|
- `HistoryItem`：Core Data 实体模型
|
|
|
- `QRCodeDetailView`：详情页面组件
|
|
|
|
|
|
## 测试建议
|
|
|
|
|
|
1. 测试单个二维码扫描的自动跳转
|
|
|
2. 测试多个二维码的用户选择跳转
|
|
|
3. 测试条形码扫描的跳转
|
|
|
4. 验证历史记录的正确保存
|
|
|
5. 检查详情页面的完整显示
|
|
|
6. **测试返回时的重新扫描功能**
|
|
|
7. **验证导航的流畅性**
|
|
|
|
|
|
## 注意事项
|
|
|
|
|
|
- 确保 Core Data 模型正确配置
|
|
|
- 验证 `QRCodeParser` 的可用性
|
|
|
- 测试不同设备方向的兼容性
|
|
|
- 检查内存使用情况（避免内存泄漏）
|
|
|
- **确保返回时扫描状态正确重置**
|
|
|
- **验证导航栈的正确管理**
|
|
|
|
|
|
## 更新日志
|
|
|
|
|
|
### v2.0 (最新)
|
|
|
- 将 sheet 展示改为 NavigationLink 导航
|
|
|
- 添加返回时自动重新扫描功能
|
|
|
- 优化用户体验和导航流畅性
|
|
|
|
|
|
### v1.0
|
|
|
- 实现扫描结果跳转详情页
|
|
|
- 自动保存历史记录
|
|
|
- 智能条码类型识别 |
