首页 > 代码库 > 用 UIViewPropertyAnimator 编写动画

用 UIViewPropertyAnimator 编写动画

 

[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 跳转的过渡动画。另外还有一些有趣的例子,例如一些简单的游戏。

 

用 UIViewPropertyAnimator 编写动画