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 能控制应用提交的角度,但不能保证系统恢复合成过程中绝无旧帧或停顿。
备注:内容仅供参考。
