本文作者:有恒
一、背景
日常开发过程中,经常需要对视图做动画,假如需要对一个 view 进行动画操作:3s 淡入,结束后,1s 放大,很容易写出这样的代码:
UIView.animate(withDuration: 3, animations: {
view.alpha = 1
}, completion: { _ in
UIView.animate(withDuration: 1) {
view.frame.size = CGSize(width: 200, height: 200)
}
})
如果,是更多串行的动画需要完成呢?
UIView.animate(withDuration: 3, animations: {
......
}, completion: { _ in
UIView.animate(withDuration: 3) {
......
}, completion: { _ in
UIView.animate(withDuration: 3) {
......
}, completion: { _ in
......
}
}
})
这样的回调地狱代码,很难维护也不优雅。
业界也有一些现成的动画库,比较知名的有:
- Spring: 轻量级的、基于 Swift 实现的动画库,它提供了多种弹簧效果动画效果。缺点是功能相对较少,不能满足所有的动画需求。
- Hero:一个高度可定制化的 iOS 动画库,它支持多种动画效果,如过渡动画、视图转场等。缺点是对于复杂的动画效果可能需要编写大量的代码。
- TweenKit:一个轻量级的、基于 Swift 实现的动画库,它提供了多种动画效果,如渐变效果、旋转效果等。TweenKit 的优点是易于使用,对于入门级的开发者很友好,但缺点是功能相对较少,不能满足所有的动画需求。
以上动画库各有优点和缺点,总的来说都有书写相对复杂不够优雅的缺陷,那有没有方便开发和维护的代码格式?
动画串行执行:
view.at.animate(
.fadeIn(duration: 3.0),
.scale(toValue: 1.2, duration: 0.5)
)
动画并行执行:
view.at.animate(parallelism:
.fadeIn(duration: 3.0),
.scale(toValue: 1.2, duration: 1)
)
如果是多个视图组合动画串行执行呢?
AT.animate (
view1.at.animate(parallelism:
.fadeIn(duration: 3.0),
.scale(toValue: 1.2, duration: 1)
)
view2.at.animate(parallelism:
.fadeIn(duration: 3.0),
.scale(toValue: 1.2, duration: 1)
)
)
二、实现方案
Animator
动画执行器
public protocol Animator {
associatedtype T
mutating func start(with view : UIView)
func pause()
func resume()
func stop()
}
封装 UIViewPropertyAnimator,CAKeyframeAnimator,CABasicAnimator,遵循 Animator 协议,实现不同类型的动画执行器。
Animation
Animation 提供动画执行参数:
为不同的 Animator 制定不同的 Animation 协议:
public protocol AnimationBaseProtocol {
var duration : TimeInterval { get }
}
protocol CAAnimationProtocol : AnimationBaseProtocol {
var repeatCount : Float { get }
var isRemovedOnCompletion : Bool { get }
var keyPath : String? { get }
var animationkey : String? { get }
}
protocol ProPertyAnimationProtocol : AnimationBaseProtocol {
var curve : UIView.AnimationCurve { get }
var fireAfterDelay : TimeInterval { get }
var closure : (UIView) -> Void { get }
}
protocol CABaseAnimationProtocol: CAAnimationProtocol {
var fromValue: Any { get }
var toValue : Any { get }
}
protocol CAKeyFrameAnimationProtocol: CAAnimationProtocol {
var keyTimes: [NSNumber]? { get }
var timingFunction: CAMediaTimingFunction? { get }
var valuesClosure: ((UIView) -> [Any]?) { get }
}
需要注意的是,动画执行器支持多种实现,用到了范型,动画执行器作为返回值,使用时需要对其进行类型擦除。
类型擦除
类型擦除的作用是擦除范型的具体信息,以便在运行时使用:
定义一个范型类:
class Stack {
var items = [T]()
func push(item: T) {
items.append(item)
}
func pop() -> T? {
if items.isEmpty {
return nil
} else {
return items.removeLast()
}
}
}
如果这样使用:
// 实例化一个 Stack 对象
let stackOfString = Stack()
stackOfString.push(item: "hello")
stackOfString.push(item: "world")
// 实例化一个 Stack 对象
let stackOfInt = Stack()
stackOfInt.push(item: 1)
stackOfInt.push(item: 2)
let stackArray: [Stack] = [stackOfString, stackOfInt]
会有一个错误:
因为这是两种类型。
如何进行擦除?
class AnyStack {
private let pushImpl: (_ item: Any) -> Void
private let popImpl: () -> Any?
init(_ stack: Stack) {
pushImpl = { item in
if let item = item as? T {
stack.push(item: item)
}
}
popImpl = {
return stack.pop()
}
}
func push(item: Any) {
pushImpl(item)
}
func pop() -> Any? {
return popImpl()
}
}
这样执行下面代码就可以正常编译使用:
let stackArray: [AnyStack] = [AnyStack(stackOfString), AnyStack(stackOfInt)]
回到 Animator 的设计,同样的原理,这样就解决了形参类型不一致的问题。
具体实现
extension Animator {
public static func fadeIn(duration: TimeInterval = 0.25, curve:UIView.AnimationCurve = .linear , fireAfterDelay: TimeInterval = 0.0, completion:(()-> Void)? = nil) -> AnyAnimator {
let propertyAnimation = PropertyAnimation()
propertyAnimation.duration = duration
propertyAnimation.curve = curve
propertyAnimation.fireAfterDelay = fireAfterDelay
propertyAnimation.closure = { $0.alpha = 1}
return Self.creatAnimator(with: propertyAnimation,completion: completion)
}
public static func scale(valus: [NSNumber], keyTimes: [NSNumber], repeatCount: Float = 1.0, duration: TimeInterval = 0.3, completion:(()-> Void)? = nil) -> AnyAnimator {
let animation = CAFrameKeyAnimation()
animation.keyTimes = keyTimes
animation.timingFunction = CAMediaTimingFunction(name: .linear)
animation.valuesClosure = {_ in valus}
animation.repeatCount = repeatCount
animation.isRemovedOnCompletion = true
animation.fillMode = .removed
animation.keyPath = "transform.scale"
animation.animationkey = "com.moyi.animation.scale.times"
animation.duration = duration
return AnyAnimator.init(CAKeyFrameAnimator(animation: animation,completion: completion))
}
/// 自定义Animation
public static func creatAnimator(with propertyAnimation : PropertyAnimation, completion:(()-> Void)? = nil) -> AnyAnimator {
return AnyAnimator.init(ViewPropertyAnimator(animation:propertyAnimation,completion:completion))
}
}
CAAnimation 是 Core Animation 框架中负责动画效果的类,它定义了一系列动画效果相关的属性和方法。可以通过创建 CAAnimation 的子类,如 CABasicAnimation、CAKeyframeAnimation、CAAnimationGroup 等来实现不同类型的动画效果。
其中,keypath 是 CAAnimation 的一个重要概念,用于指定动画效果所作用的属性。keypath 的值通常为字符串类型,在指定属性时需要使用 KVC(键值编码)来进行访问。
更多关于 CAAnimation 的内容可以参考引用中相关链接,不是本文重点不再展开。
AnimationToken
AnimationToken 是视图和动画执行器的封装,用于视图的动画处理。
然后对 UIView 添加串行、并行的扩展方法:
extension EntityWrapper where This: UIView {
internal func performAnimations(_ animators: [AnyAnimator] , completionHandlers: [(() -> Void)]) {
guard !animators.isEmpty else {
completionHandlers.forEach({ handler in
handler()
})
return
}
var leftAnimations = animators
var anyAnimator = leftAnimations.removeFirst()
anyAnimator.start(with: this)
anyAnimator.append {
self.performAnimations(leftAnimations, completionHandlers: completionHandlers)
}
}
internal func performAnimationsParallelism(_ animators: [AnyAnimator], completionHandlers: [(() -> Void)]) {
guard !animators.isEmpty else {
completionHandlers.forEach({ handler in
handler()
})
return
}
let animationCount = animators.count
var completionCount = 0
let animationCompletionHandler = {
completionCount += 1
if completionCount == animationCount {
completionHandlers.forEach({ handler in
handler()
})
}
}
for var animator in animators {
animator.start(with: this)
animator.append {
animationCompletionHandler()
}
}
}
}
completionHandlers 是动画任务的结束的回调逻辑,类似 UIView 类方法 animate 的 completion 回调,这样就有了动画结束的回调能力。
给 UIView 添加扩展,实现 view.at.animate () 方法:
extension EntityWrapper where This: UIView {
@discardableResult private func animate(_ animators: [AnyAnimator]) -> AnimationToken {
return AnimationToken(
view: this,
animators: animators,
mode: .inSequence
)
}
@discardableResult public func animate(_ animators: AnyAnimator...) -> AnimationToken {
return animate(animators)
}
@discardableResult private func animate(parallelism animators: [AnyAnimator]) -> AnimationToken {
return AnimationToken(
view: this,
animators: animators,
mode: .parallelism
)
}
@discardableResult public func animate(parallelism animators: AnyAnimator...) -> AnimationToken {
return animate(parallelism: animators)
}
}
AT.animate () 对 AnimationToken 进行串行管理,不再赘述。
三、总结
本文只是对动画回调嵌套问题的轻量化解决方案,让组合动画的代码结构更加清晰,方便开发和后续迭代修改。实现方案还有许多可以改进的地方,欢迎参考指正。
四、参考资料
- 图源:https://unsplash.com/photos/PDxp-AItBMA
- [Declarative animation]https://www.swiftbysundell.com/articles/building-a-declarativ…
- [CAAnimation] Apple Inc. Core Animation Programming Guide. [About Core Animation](About Core Animation)
- [CAAnimation] 王巍. iOS 动画高级技巧 [M]. 北京:人民邮电出版社,2015.
- [CAAnimation]https://developer.apple.com/documentation/quartzcore/caanimat…
- [CAAnimation]https://github.com/pro648/tips/blob/master/sources/CAAnimation%EF%BC%9A%E5%B1%9E%E6%80%A7%E5%8A%A8%E7%94%BBCABasicAnimation%E3%80%81CAKeyframeAnimation%E4%BB%A5%E5%8F%8A%E8%BF%87%E6%B8%A1%E5%8A%A8%E7%94%BB%E3%80%81%E5%8A%A8%E7%94%BB%E7%BB%84.md
- [UIViewPropertyAnimator]https://developer.apple.com/documentation/uikit/uiviewpropert…
- [使用 UIViewPropertyAnimator 做动画]https://swift.gg/2017/04/20/quick-guide-animations-with-uivie…
本文发布自网易云音乐技术团队,文章未经授权禁止任何形式的转载。我们常年招收各类技术岗位,如果你准备换工作,又恰好喜欢云音乐,那就加入我们 grp.music-fe (at) corp.netease.com!
服务器托管,北京服务器托管,服务器租用 http://www.fwqtg.net