PAYATHON 2026

SwiftUI 圆形刻度环从后台恢复后短暂反向旋转,如何避免?

数据小陈

应用回到前台时,应取消角度归零和动画重启,保留圆环的显示相位,并明确后台期间是否推进视觉角度。如果希望恢复后从原位置继续旋转,可以在离开 .active 时暂停视觉时钟,恢复后的第一帧只建立时间基准,之后按非负时间差递增角度。

仅凭这段代码,无法确定之前尝试的所有实现为何都会出现反向跳动,也不能保证某个 SwiftUI modifier 能消除所有 iOS 环境中的恢复首帧异常。对于在 TimelineView 和 Canvas 方案中复现的问题,可以用 UIViewRepresentable 封装 CADisplayLink,直接控制每一帧的角度和绘制,进一步隔离问题。

原代码中有哪些需要先修正的地方?

rotationDegrees 在执行动画后保存的是目标值 360,不能将它当作屏幕当前显示的中间角度。进入后台时,动画可能正显示在这一圈中的任意位置。

恢复时如果执行:

withAnimation(.linear(duration: 0)) {
    rotationDegrees = 0
}

这会重新指定角度,并未保存当前显示相位。0° 和 360° 的静态外观相同,但当前可见角度可能是 137°,归零仍会改变画面。动画持续运行时,状态中的目标值和屏幕上正在呈现的角度需要区分。

另外还有两个问题:

  • scenePhase 的转换可能经过 .inactive。只判断 oldPhase == .background && newPhase == .active 会漏掉经过 .inactive 的恢复路径。应根据当前是否为 .active 决定视觉更新是否运行。
  • asyncAfter 的 0.05 秒延迟与实际显示帧不同步,再次进入后台或视图离开时也没有取消延迟任务。快速切换时,任务可能在不合适的时机重新启动动画。

这些问题足以解释原实现为什么容易跳变,但不能据此认定其他实现中的异常也由相同原因导致。

应该采用怎样的更新方式?

对于后台暂停视觉旋转的方案,每次更新使用:

Δt = max(0, currentTimestamp - previousTimestamp)
θ = θ + ω × Δt
ω = 2π / 120

这里 θ 以 radians 表示。恢复后的第一次回调不计算后台经过的时间,只记录新的 previousTimestamp。

在默认 UIKit 屏幕坐标系中,下面的代码通过增加角度实现顺时针旋转。每帧直接根据角度计算刻度端点,不给 rotationEffect 或 layer transform 设置需要插值的目标值。

业务计时可以继续累计后台时长,圆环的视觉相位则在后台暂停,两者可以独立维护。

可嵌入 SwiftUI 的实现示例

下面的实现保留了 60 个刻度、每 5 个刻度一个长刻度,以及 120 秒旋转一圈的设置。它没有使用 repeatForever,也没有在恢复时延迟或归零。

import SwiftUI
import UIKit
import QuartzCore

@MainActor
struct StableTickRing: UIViewRepresentable {
    @Environment(\.scenePhase) private var scenePhase

    var isTracking = true

    func makeUIView(context: Context) -> TickRingUIView {
        let view = TickRingUIView(frame: .zero)
        view.setRunning(isTracking && scenePhase == .active)
        return view
    }

    func updateUIView(_ uiView: TickRingUIView, context: Context) {
        uiView.setRunning(isTracking && scenePhase == .active)
    }

    static func dismantleUIView(
        _ uiView: TickRingUIView,
        coordinator: Void
    ) {
        uiView.setRunning(false)
    }
}

@MainActor
final class TickRingUIView: UIView {
    private let tickCount = 60
    private let rotationDuration: Double = 120

    private var angle: Double = 0
    private var wantsToRun = false
    private var displayLink: CADisplayLink?
    private var previousTimestamp: CFTimeInterval?

    override init(frame: CGRect) {
        super.init(frame: frame)
        backgroundColor = .clear
        isOpaque = false
        contentMode = .redraw
    }

    required init?(coder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }

    func setRunning(_ running: Bool) {
        wantsToRun = running
        synchronizeDisplayLink()
    }

    override func didMoveToWindow() {
        super.didMoveToWindow()
        synchronizeDisplayLink()
    }

    private func synchronizeDisplayLink() {
        guard wantsToRun, window != nil else {
            displayLink?.invalidate()
            displayLink = nil
            previousTimestamp = nil
            return
        }

        guard displayLink == nil else { return }

        previousTimestamp = nil
        let proxy = TickRingDisplayLinkProxy(owner: self)
        let link = CADisplayLink(
            target: proxy,
            selector: #selector(TickRingDisplayLinkProxy.tick(_:))
        )
        displayLink = link
        link.add(to: .main, forMode: .common)
    }

    fileprivate func advance(using link: CADisplayLink) {
        let timestamp = link.timestamp

        guard let previous = previousTimestamp else {
            previousTimestamp = timestamp
            setNeedsDisplay()
            return
        }

        previousTimestamp = timestamp
        let delta = max(0, timestamp - previous)
        angle += delta * (2 * Double.pi / rotationDuration)
        setNeedsDisplay()
    }

    override func draw(_ rect: CGRect) {
        guard let context = UIGraphicsGetCurrentContext() else {
            return
        }

        let center = CGPoint(x: bounds.midX, y: bounds.midY)
        let radius = min(bounds.width, bounds.height) / 2 - 8
        guard radius > 0 else { return }

        context.setStrokeColor(UIColor.red.cgColor)
        context.setLineWidth(2.5)
        context.setLineCap(.round)
        context.beginPath()

        for index in 0..<tickCount {
            let radians = Double(index) * 2 * Double.pi
                / Double(tickCount) - Double.pi / 2 + angle
            let length: CGFloat = index % 5 == 0 ? 22 : 14
            let innerRadius = radius - length
            let dx = CGFloat(cos(radians))
            let dy = CGFloat(sin(radians))

            context.move(to: CGPoint(
                x: center.x + dx * radius,
                y: center.y + dy * radius
            ))
            context.addLine(to: CGPoint(
                x: center.x + dx * innerRadius,
                y: center.y + dy * innerRadius
            ))
        }

        context.strokePath()
    }
}

@MainActor
private final class TickRingDisplayLinkProxy: NSObject {
    private weak var owner: TickRingUIView?

    init(owner: TickRingUIView) {
        self.owner = owner
        super.init()
    }

    @objc func tick(_ link: CADisplayLink) {
        owner?.advance(using: link)
    }
}

在页面中使用:

StableTickRing(isTracking: true)
    .frame(width: 340, height: 340)

CADisplayLink 通过一个弱引用代理调用视图,避免视图持有 display link、display link 又通过 target 持有视图的引用环。视图离开 window 或 SwiftUI 拆除视图时,会停止回调。

在同一个视图实例中,angle 只增不减,停止时保留角度,重新开始时清空上一帧时间戳。因此,这段代码不会主动提交更小的角度,也不会在恢复帧一次性补入后台经过的时间。实际呈现效果仍需要在目标设备和 iOS 版本上验证。

如果继续使用纯 SwiftUI,应保留哪些约束?

TimelineView 可以作为刷新来源,但切换 .animation 和 .periodic schedules 本身不能保证方向稳定。纯 SwiftUI 实现仍应满足以下条件:

  • 在稳定身份的状态对象中保存视觉相位或累计的前台运行时间,避免恢复时重新创建起点。
  • 离开 .active 时冻结视觉时间,恢复时从冻结值继续推进。
  • 每次刷新直接计算最终绘制位置,不再叠加 repeatForever 或父级隐式动画。
  • 如果使用 rotationEffect 更新离散采样角度,应在对应更新中禁用动画插值。

可以在相应子树使用以下 transaction 设置来排除 SwiftUI 动画插值:

.transaction { transaction in
    transaction.animation = nil
    transaction.disablesAnimations = true
}

它不能阻止状态重置、后台时间补偿或视图身份变化,.drawingGroup() 也不能修正这些状态问题。

角度一直增加,为什么还可能看起来倒转?

重复刻度会造成方向识别上的歧义。60 个完全相同的刻度每隔 6° 重复一次;当前每 5 个刻度设置一个长刻度的样式,则每隔 30° 重复一次。

如果恢复时直接跳到包含后台经过时间的新角度,即使数值一直增加,观察者也可能把相同刻度之间的位移看成反向移动。这是需要排查的可能原因,不能直接当作这次故障的定论。

诊断时可以临时把一个刻度改成明显不同的颜色,并记录恢复前后提交的角度。如果唯一标记也发生反向位移,再检查视图是否重建、父级是否存在动画,以及恢复过程中是否显示了旧画面。

如果圆环必须准确反映后台继续流逝的时间,恢复后的相位可能与离开时不同。对于任意后台时长,无法同时保证直接跳到正确相位和恢复瞬间的连续性。可以选择在后台暂停视觉相位,或另行设计只向前追赶的过渡。CADisplayLink 能控制应用提交的角度,但不能保证系统恢复合成过程中绝无旧帧或停顿。

备注:内容仅供参考。