fix: 修复扫码相机竞态并调整金额与浅色外观

串行处理相机配置及启停，补充四项生命周期回归测试。快捷金额去除多余小数，固定浅色模式，版本更新至 2.1.1（2010101）。
2026-09-18 09:37:00 +08:00
parent c4b0e7798b
commit 3823d10423
6 changed files with 216 additions and 40 deletions
@@ -0,0 +1,56 @@
+import AVFoundation
+
+/// 扫码采集会话的配置与运行接口，便于独立验证生命周期顺序。
+protocol QRCodeCaptureSession: AnyObject {
+    /// 当前是否正在采集。
+    var isRunning: Bool { get }
+    /// 开始批量配置。
+    func beginConfiguration()
+    /// 提交批量配置。
+    func commitConfiguration()
+    /// 启动采集。
+    func startRunning()
+    /// 停止采集。
+    func stopRunning()
+}
+
+extension AVCaptureSession: QRCodeCaptureSession {}
+
+/// 在同一串行队列中配置和启停相机，避免配置提交与启动交叉执行。
+final class QRCodeCaptureSessionController {
+    private let session: QRCodeCaptureSession
+    private let queue: DispatchQueue
+    private var isConfigured = false
+
+    /// 创建会话生命周期控制器；队列必须为串行队列。
+    init(session: QRCodeCaptureSession,
+         queue: DispatchQueue = DispatchQueue(label: "com.zhifly.suixinkan.qr-capture")) {
+        self.session = session
+        self.queue = queue
+    }
+
+    /// 在配置事务内添加输入输出，提交完成后在主线程通知结果。
+    func configure(_ configuration: @escaping () -> Bool, completion: @escaping (Bool) -> Void) {
+        queue.async { [self] in
+            if !isConfigured {
+                session.beginConfiguration()
+                isConfigured = configuration()
+                session.commitConfiguration()
+            }
+            let succeeded = isConfigured
+            DispatchQueue.main.async { completion(succeeded) }
+        }
+    }
+
+    /// 按提交顺序更新运行状态，运行状态的读取也限定在会话队列内。
+    func setRunning(_ shouldRun: Bool) {
+        queue.async { [self] in
+            if shouldRun {
+                guard isConfigured, !session.isRunning else { return }
+                session.startRunning()
+            } else if session.isRunning {
+                session.stopRunning()
+            }
+        }
+    }
+}