UIKit动画调试 是做什么的?
概述
CAAnimation问题表现为完成处理器不触发、时序错误或特定条件下的卡顿。核心原则 90%的CAAnimation问题都是CATransaction时序、图层状态或帧率假设造成的,而非Core Animation自身的bug。
危险信号 —— 怀疑CAAnimation问题
如果看到以下任一情况,应怀疑是动画逻辑问题而非设备行为:
- 完成处理器在模拟器上触发但在真机上不触发
- 动画时长(声明0.5s)与视觉时长(实际1.2s)不匹配
- 弹簧动画在iPhone 15 Pro上正常,但在旧设备上卡顿
- 手势与动画同时使用时出现卡顿(单独使用均正常)
- 完成处理器中使用
[weak self]但不确定其作用 - ❌ 禁止 硬编码时长/数值来“匹配实际现象”
- 这会将设备特定bug传播给使用不同硬件的用户
- 不要将其合理化解释为“临时修复”或“足够好了”
关键区分 模拟器通常会隐藏时序问题(仅60Hz,无节流)。真机会暴露它们(可变帧率、CPU节流、后台压力)。强制要求:在真机(最旧支持型号)上测试后再发布。
强制第一步
始终先运行这些(在更改代码之前):
// 1. 检查完成处理器是否触发
animation.completion = { [weak self] finished in
print("🔥 完成处理器已触发: finished=\(finished)")
guard let self = self else {
print("🔥 self 为 nil")
return
}
// 原始代码
}
// 2. 检查实际时长 vs 声明时长
let startTime = Date()
let anim = CABasicAnimation(keyPath: "position.x")
anim.duration = 0.5 // 声明
layer.add(anim, forKey: "test")
DispatchQueue.main.asyncAfter(deadline: .now() + 0.51) {
print("已用时间: \(Date().timeIntervalSince(startTime))") // 实际
}
// 3. 检查哪些动画正在执行
if let keys = layer.animationKeys() {
print("活跃动画: \(keys)")
for key in keys {
if let anim = layer.animation(forKey: key) {
print("\(key): duration=\(anim.duration), removed=\(anim.isRemovedOnCompletion)")
}
}
}
// 4. 检查图层状态
print("图层速率: \(layer.speed)") // != 1.0 表示时序被缩放
print("图层时间偏移: \(layer.timeOffset)") // != 0 表示动画有偏移
这些告诉你什么
- 完成处理器打印出现 → 已触发,问题在回调代码中
- 完成处理器打印缺失 → 未触发,检查CATransaction/图层状态
- 已用时间 == 声明时长 → 时长正确,视觉卡顿来自帧率
- 已用时间 != 声明时长 → CATransaction包装改变了时长
- layer.speed != 1.0 → 有东西在减慢动画
- 活跃动画列表很长 → 多个动画在竞争
强制解读
在更改任何代码之前,你必须确定以下哪一个诊断是根因:
- 如果完成处理器触发但已用时间 != 声明时长 → 应用模式2(CATransaction)
- 如果完成处理器不触发 AND isRemovedOnCompletion为true → 应用模式3
- 如果完成处理器触发但视觉卡顿 → 必须先使用Instruments进行性能分析
- 你不能猜测“可能是帧率问题”——用数据证明
- 性能分析 > Core Animation工具可以确定帧率下降
- 如果跳过Instruments,就是在猜测
如果诊断结果矛盾或不清晰
- 停止。不要立即进入模式
- 添加更多print语句来缩小原因范围
- 问:“诊断显示X和Y,但Z不匹配。我遗漏了什么?”
- 如果不确定,使用Instruments > Core Animation进行性能分析
决策树
CAAnimation问题?
├─ 完成处理器从未触发?
│ ├─ 仅在模拟器上?
│ │ └─ 模拟器时序不同(60Hz)。在真机上测试。
│ ├─ 仅在真机上?
│ │ ├─ 检查:isRemovedOnCompletion 和 fillMode
│ │ ├─ 检查:CATransaction包装
│ │ └─ 检查:动画期间应用是否进入后台
│ └─ 模拟器和真机都触发?
│ ├─ 检查:完成处理器是否在添加动画**之前**设置
│ └─ 检查:[weak self]是否实际被捕获(未在完成前变为nil)
│
├─ 时长不匹配(声明 != 视觉)?
│ ├─ 是否layer.speed != 1.0?
│ │ └─ 有东西缩放了动画时长。找到并修复。
│ ├─ 动画是否被CATransaction包装?
│ │ └─ CATransaction.setAnimationDuration()会覆盖animation.duration
│ └─ 视觉时长是否**长于**声明时长?
│ └─ 模拟器(60Hz)vs 设备帧率(120Hz)。为真硬件重新计算。
│
├─ 弹簧动画在设备上表现异常?
│ ├─ 数值是否为某一设备硬编码?
│ │ └─ 使用设备性能类而非型号
│ ├─ damping/stiffness是否与mass/stiffness互换?
│ │ └─ 检查CASpringAnimation参数含义
│ └─ 模拟器正常工作但真机异常?
│ └─ 模拟器使用60Hz。设备可能使用120Hz。重新计算。
│
└─ 手势+动画卡顿?
├─ 动画是否在竞争(相同keyPath)?
│ └─ 添加新动画前移除旧动画
├─ 手势是否在动画运行时更新图层?
│ └─ 使用CADisplayLink同步更新
└─ 手势是否阻塞了主线程?
└─ 使用Instruments > Core Animation性能分析
常见模式
模式选择规则(强制)
一次应用一个模式,按此顺序
-
始终从模式1开始(完成处理器基础)
- 如果完成处理器从未触发 → 模式1
- 使用print语句验证完成处理器是在add()之前设置
- 只有完成处理器触发但时序错误时才进入模式2
-
然后模式2(CATransaction时长不匹配)
- 仅当完成处理器触发但已用时间 != 声明时长
- 检查强制第一步中的日志
-
然后模式3(isRemovedOnCompletion)
- 仅当动画完成但视觉状态恢复
-
模式4-7 根据具体症状应用(参见决策树)
禁止
- ❌ 同时应用多个模式(“让我同时试模式2和模式4”)
- ❌ 因为“我已经知道不是那个问题”而跳过模式1
- ❌ 不弄清为什么需要每个模式就把它们组合起来
- ❌ 随机尝试模式并希望其中一个生效
模式1:完成处理器基础
❌ 错误(在添加动画之后设置处理器)
layer.add(animation, forKey: "myAnimation")
animation.completion = { finished in // ❌ 太晚了!
print("完成")
}
✅ 正确(在添加之前设置处理器)
animation.completion = { [weak self] finished in
print("🔥 动画完成: \(finished)")
guard let self = self else { return }
self.doNextStep()
}
layer.add(animation, forKey: "myAnimation")
原因 完成处理器必须在动画被添加到图层之前设置。之后设置不起作用。
模式2:CATransaction vs animation.duration
❌ 错误(CATransaction覆盖动画时长)
CATransaction.begin()
CATransaction.setAnimationDuration(2.0) // ❌ 覆盖所有动画!
let anim = CABasicAnimation(keyPath: "position")
anim.duration = 0.5 // 被忽略
layer.add(anim, forKey: nil)
CATransaction.commit() // 动画耗时2.0秒,而非0.5
✅ 正确(在动画上设置时长,而非事务)
let anim = CABasicAnimation(keyPath: "position")
anim.duration = 0.5
layer.add(anim, forKey: nil)
// 无CATransaction包装
原因 CATransaction.setAnimationDuration()影响事务块中的所有动画。仅当你希望统一改变所有动画时才使用它。
模式3:isRemovedOnCompletion & fillMode
❌ 错误(动画完成后消失)
let anim = CABasicAnimation(keyPath: "opacity")
anim.fromValue = 1.0
anim.toValue = 0.0
anim.duration = 0.5
layer.add(anim, forKey: nil)
// 0.5秒后,动画被移除,图层恢复原始状态
✅ 正确(保留动画状态)
anim.isRemovedOnCompletion = false
anim.fillMode = .forwards // 动画完成后保留最终状态
layer.add(anim, forKey: nil)
// 0.5秒后,动画状态被保留
原因 默认情况下,动画被移除,图层恢复。要永久改变状态,设置isRemovedOnCompletion = false和fillMode = .forwards。
模式4:完成处理器中的弱引用(强制)
❌ 禁止(强引用创建循环引用)
anim.completion = { finished in
self.property = "value" // ❌ 保证产生循环引用
}
✅ 强制(始终使用弱引用)
anim.completion = { [weak self] finished in
guard let self = self else { return }
self.property = "value" // 安全访问
}
为什么这是强制而非可选
- CAAnimation保持完成处理器存活直到动画完成
- 完成处理器强引用self(除非显式使用weak)
- 产生循环引用:self → animation → completion → self
- 即使动画是短暂的(0.3s也无法阻止)内存泄漏也会发生
禁止的合理化解释
- ❌ “动画很短,所以没有循环引用风险”
- ❌ “我会手动移除动画,所以没问题”
- ❌ “这段代码路径只运行一次”
始终在完成处理器中使用[weak self]。没有例外。
模式5:多动画(相同keyPath)
❌ 错误(动画冲突)
// 添加动画1
let anim1 = CABasicAnimation(keyPath: "position.x")
anim1.toValue = 100
layer.add(anim1, forKey: "slide")
// 稍后,添加动画2
let anim2 = CABasicAnimation(keyPath: "position.x")
anim2.toValue = 200
layer.add(anim2, forKey: "slide") // ❌ 相同key,替换了anim1!
✅ 正确(添加前移除旧动画)
layer.removeAnimation(forKey: "slide") // 先移除旧的
let anim2 = CABasicAnimation(keyPath: "position.x")
anim2.toValue = 200
layer.add(anim2, forKey: "slide")
或使用唯一key:
let anim1 = CABasicAnimation(keyPath: "position.x")
layer.add(anim1, forKey: "slide_1")
let anim2 = CABasicAnimation(keyPath: "position.x")
layer.add(anim2, forKey: "slide_2") // 不同的key
原因 使用相同key添加动画会替换前一个动画。要么移除旧动画,要么使用唯一key。
模式6:用于手势+动画同步的CADisplayLink
❌ 错误(手势直接更新,动画以不同速率更新)
func handlePan(_ gesture: UIPanGestureRecognizer) {
let translation = gesture.translation(in: view)
view.layer.position.x = translation.x // ❌ 同步问题
}
// 另外:
let anim = CABasicAnimation(keyPath: "position.x")
view.layer.add(anim, forKey: nil) // 不同步导致卡顿
✅ 正确(使用CADisplayLink实现同步)
var displayLink: CADisplayLink?
func startSyncedAnimation() {
displayLink = CADisplayLink(
target: self,
selector: #selector(updateAnimation)
)
displayLink?.add(to: .main, forMode: .common)
}
@objc func updateAnimation() {
// 在同一帧更新手势和动画
let gesture = currentGesture
let position = calculatePosition(from: gesture)
layer.position = position // 同步更新
}
原因 手势识别器和CAAnimation可能以不同帧率运行。CADisplayLink将两者同步到屏幕刷新率。
模式7:弹簧动画设备差异
❌ 错误(为单一设备硬编码)
let springAnim = CASpringAnimation()
springAnim.damping = 0.7 // 为iPhone 15 Pro硬编码
springAnim.stiffness = 100
layer.add(springAnim, forKey: nil) // 在iPhone 12上卡顿
✅ 正确(适配设备性能)
let springAnim = CASpringAnimation()
// 使用设备性能类,而非型号
if ProcessInfo.processInfo.processorCount >= 6 {
// 现代A系列(A14+)
springAnim.damping = 0.7
springAnim.stiffness = 100
} else {
// 较旧A系列
springAnim.damping = 0.85
springAnim.stiffness = 80
}
layer.add(springAnim, forKey: nil)
原因 弹簧物理效果在60Hz和120Hz下感觉不同。使用设备类(核心数、GPU)而非型号。
快速参考表
| 问题 | 检查项 | 修复方法 |
|---|---|---|
| 完成处理器从不触发 | 处理器是否在add()之前设置 | 将completion =移至add()之前 |
| 时长不匹配 | 是否有CATransaction包装? | 移除CATransaction或从中移除动画 |
| 旧设备卡顿 | 数值是否硬编码? | 使用ProcessInfo确定设备类 |
| 动画消失 | isRemovedOnCompletion? | 设为false,使用fillMode = .forwards |
| 手势+动画卡顿 | 是否同步更新? | 使用CADisplayLink |
| 多动画冲突 | 相同key? | 使用唯一key或先removeAnimation() |
| 处理器中的弱引用 | 完成处理器是否正确捕获? | 始终在完成处理器中使用[weak self] |
30分钟后仍卡住时
如果已花费超过30分钟,动画仍然有问题:
停止。你很可能:
- 跳过了某个强制步骤(最常见)
- 误解了诊断输出
- 为症状应用了错误的模式
- 属于需要Instruments性能分析的5%边缘情况
在声称“技能无效”之前必须检查的清单
- 我运行了强制第一步中的所有4个诊断块
- 我粘贴了诊断的确切输出(日志、print语句)
- 我从“这些告诉你什么”中确定了一个根因
- 我从决策树中应用了第一个匹配的模式
- 我在真机上测试了该模式,而不仅仅是模拟器
- 如果卡顿,我使用了Instruments > Core Animation进行了性能分析
- 我一次只应用了一个模式(没有混合)
- 我阅读了模式的条件(“仅当...”)并验证它们匹配
如果所有检查都通过但问题仍然存在,粘贴诊断输出和已尝试模式的描述。需要查看实际数据。