英文：shinobicontrols
译文：戴仓薯
[iOS 10 day by day] Day 1：开发 iMessage 的第三方插件
[iOS 10 day by day] Day 2：线程竞态检测工具 Thread Sanitizer
《iOS 10 day by day》是 shinobicontrols 公司编写的系列博客，介绍开发者需要了解的 iOS 10 新特性，每周更新。本系列翻译（文集地址）已取得官方授权。仓薯翻译，欢迎指正：）
Shinobicontrols 为 iOS 和 Android 开发者提供高性能、响应式的 UI 控件 SDK，尤其是图表方面的控件。 官网 : shinobicontrols.com twitter : @shinobicontrols
曾经的黑暗年代
用基于 block 的 UIView animation 来编写 view 属性（frame, transform 等等）变化的动画非常简单。只需要短短几行代码：
view.alpha = 1
UIView.animate(withDuration: 2) {
containerView.alpha = 0
}
你可以指定动画结束之后调用的 completion block。如果默认的匀速动画不能满足你的要求，还可以调整时间曲线。
但是，如果你需要一种自定义的曲线动画，相应的属性变化首先要快速开始，然后再急速慢下来，该怎么办呢？另外一个有点麻烦的问题是，怎么取消正在进行中的动画？虽然这些问题都可以解决，用第三方库或者创建一个新的 animation 来取代进行中的 animation。但苹果在 UIKit 中新加的组件能把这些步骤简化许多：进入UIViewPropertyAnimator的世界吧！
Animation 的新纪元
UIViewPropertyAnimator 的 API 设计得很完善，可扩展性也很好。它 cover 了传统 UIView animation 动画的绝大部分功能，并且大大增强了你对动画过程的掌控能力。具体来说，你可以在动画过程中任意时刻暂停，可以随后再选择继续，甚至还能在动画过程中动态改变动画的属性（例如，本来动画终点在屏幕左下角的，可以在动画过程中把终点改到右上角）。
为了探索这个新的类，我们来看几个例子，这几个例子都是演示一张图片划过屏幕的动画。如同所有 Day by Day 系列的文章，例子的代码可以在 Github 上下载到。这次我们用的是 Playground。
Playground 的准备
我们所有的 playground 页面都是让一个小忍者划过屏幕的动画。为了方便对比这些页面的代码，我们把公共部分的代码藏在 Sources 文件夹里。这样不仅能简化每个页面的代码，还能加快编译过程，因为 Sources 里的代码是预编译过的。
Sources 里包含一个简单的UIView子类，叫做NinjaContainerView。它的唯一功能就是添加一个 UIImageView 作为子 view，来显示我们的小忍者。我把忍者图片加到了 Resources 里。
import UIKit
public class NinjaContainerView: UIView {
public let ninja: UIImageView = {
let image = UIImage(named: "ninja")
let view = UIImageView(image: image)
view.frame = CGRect(x: 0, y: 0, width: 45, height: 39)
return view
}()
public override init(frame: CGRect) {
// Animating view
super.init(frame: frame)
// Position ninja in the bottom left of the view
ninja.center = {
let x = (frame.minX + ninja.frame.width / 2)
let y = (frame.maxY - ninja.frame.height / 2)
return CGPoint(x: x, y: y)
}()
// Add image to the container
addSubview(ninja)
backgroundColor = #colorLiteral(red: 0.8039215803, green: 0.8039215803, blue: 0.8039215803, alpha: 1)
}
required public init?(coder aDecoder: NSCoder) {
fatalError("init(coder:) has not been implemented")
}
/// Moves the ninja view to the bottom right of its container, positioned just inside.
public func moveNinjaToBottomRight() {
ninja.center = {
let x = (frame.maxX - ninja.frame.width / 2)
let y = (frame.maxY - ninja.frame.height / 2)
return CGPoint(x: x, y: y)
}()
}
}
现在，在每个 playground 页面里，我们可以复制粘贴以下代码：
import UIKit
import PlaygroundSupport
// Container for our animating view
let containerView = NinjaContainerView(frame: CGRect(x: 0, y: 0, width: 400, height: 400))
let ninja = containerView.ninja
// Show the container view in the Assistant Editor
PlaygroundPage.current.liveView = containerView
这样我们就可以用上 Playground 强大的 “Live View” 功能，不用启动 iOS 模拟器就可以展示动画效果。尽管 Playground 还是有些不好用的地方，但用来尝试新功能是非常合适的。
要显示 Live View，点击菜单栏上的 View -> Assistant Editor -> Show Assistant Editor，或者点击右上角工具栏里两环相套的图标。如果在右半边的编辑器里没有看到 live view，要确保选中的是 Timeline 而不是 Manual —— 不得不承认我在这里浪费了一点时间。
从简单的开始
UIViewPropertyAnimator 的用法可以跟传统的 animation block 一样：
UIViewPropertyAnimator(duration: 1, curve: .easeInOut) {
containerView.moveNinjaToBottomRight()
}.startAnimation()
这会触发一个时长为 1 秒，时间曲线是缓进缓出的动画。动画的内容是闭包里的部分。
最简单的动画
注意我们是通过调用 startAnimation() 来显式启动动画的。另外一种创建 animator 的方法可以不用手动启动动画，就是 runningPropertyAnimator(withDuration:delay:options:animations:completion:)。确实有点长，所以可能还不如用第一种。
先创建好 animator ，再往上添加动画也很容易：
// view 设置好之后，我们先来一个简单的动画
let animator = UIViewPropertyAnimator(duration: 1, curve: .easeInOut)
// 添加第一个 animation block
animator.addAnimations {
containerView.moveNinjaToBottomRight()
}
// 然后再加第二个
animator.addAnimations {
ninja.alpha = 0
}
这两个 animation block 会同时进行。
两个 animation block
添加 completion block 的方法也很类似：
animator.addCompletion {
_ in
print("Animation completed")
}
animator.addCompletion {
position in
switch position {
case .end: print("Completion handler called at end of animation")
case .current: print("Completion handler called mid-way through animation")
case .start: print("Completion handler called at start of animation")
}
}
如果动画完整跑完的话，我们可以在控制台看到以下信息：
Animation completed
Completion handler called at end of animation
进度拖拽和反向动画
我们可以利用 animator 让动画跟随拖拽的进度进行：
let animator = UIViewPropertyAnimator(duration: 5, curve: .easeIn)
// Add our first animation block
animator.addAnimations {
containerView.moveNinjaToBottomRight()
}
let scrubber = UISlider(frame: CGRect(x: 0, y: 0, width: containerView.frame.width, height: 50))
containerView.addSubview(scrubber)
let eventListener = EventListener()
eventListener.eventFired = {
animator.fractionComplete = CGFloat(scrubber.value)
}
scrubber.addTarget(eventListener, action: #selector(EventListener.handleEvent), for: .valueChanged)
Playground 总体来说是很好用的，而且还能在 Live View 里面添加可交互的 UI 控件。然而，接受响应事件就有点麻烦，因为我们需要一个
NSObject的子类来监听诸如.valueChanged这种事件。所以，我们简单创建一个EventListener，一旦触发它的handleEvent方法，它会调用我们的eventFired闭包。
这里 fractionComplete 值的计算方法跟时间没有关系了，所以我们的小忍者不再像之前指定的一样，会优雅地缓动。
Property animator 最强大的功能体现在它能随时打断正在进行的动画。让动画反向也非常容易，只需设置 isReversed 属性即可。
为了演示这一点，我们使用关键帧动画，这样就可以制作一个多阶段的动画了：
animator.addAnimations {
UIView.animateKeyframes(withDuration: animationDuration, delay: 0, options: [.calculationModeCubic], animations: {
UIView.addKeyframe(withRelativeStartTime: 0, relativeDuration: 0.5) {
ninja.center = containerView.center
}
UIView.addKeyframe(withRelativeStartTime: 0.5, relativeDuration: 0.5) {
containerView.moveNinjaToBottomRight()
}
})
}
let button = UIButton(frame: CGRect(origin: .zero, size: CGSize(width: 100, height: 30)))
button.setTitle("Reverse", for: .normal)
button.setTitleColor(.black(), for: .normal)
button.setTitleColor(.gray(), for: .highlighted)
let listener = EventListener()
listener.eventFired = {
animator.isReversed = true
}
button.addTarget(listener, action: #selector(EventListener.handleEvent), for: .touchUpInside)
containerView.addSubview(button)
animator.startAnimation()
按下按钮的时候，animator 就会把动画反向进行，只要这一时刻动画还没结束。
自定义时间曲线
Property animator 在简洁优美的同时，还有很强的扩展性。如果你需要在苹果提供的时间函数之外自定义另一种时间曲线，只需传进一个实现 UITimingCurveProvider 协议的对象。大部分情况下用到的是 UICubicTimingParameters 或者 UISpringTimingParameters。
例如，我们想让小忍者在划过屏幕的过程中，先快速加速，然后再慢慢停止。如下图的贝塞尔曲线所示（绘制曲线用了这个很方便的在线工具）：
http://cubic-bezier.com/#.17,.67,.83,.67
贝塞尔曲线
let bezierParams = UICubicTimingParameters(controlPoint1: CGPoint(x: 0.05, y: 0.95),
controlPoint2: CGPoint(x: 0.15, y: 0.95))
let animator = UIViewPropertyAnimator(duration: 4, timingParameters:bezierParams)
animator.addAnimations {
containerView.moveNinjaToBottomRight()
}
animator.startAnimation()
扩展阅读
新的 property animator 让编写动画更简单，它的 API 跟传统方法类似，还添加了打断动画、自定义时间曲线等功能。
Apple 为 UIViewPropertyAnimator 提供了详尽的文档。另外，也可以看看这场 WWDC 视频，深度解读这些新的 API，还讲了怎么用新的 API 来做 viewController 跳转的过渡动画。另外还有一些有趣的例子，例如一些简单的游戏。