IBAnimatable 4.0 迁移指南：从嵌套闭包到链式动画API-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00621/article/details/148440000

IBAnimatable 4.0 迁移指南：从嵌套闭包到链式动画API

IBAnimatable 项目地址: https://gitcode.com/gh_mirrors/iba/IBAnimatable

项目概述

IBAnimatable 是一个强大的界面设计与动画库，它允许开发者直接在 Interface Builder 中设计和原型化自定义的 UI 元素、交互效果、导航、转场和动画。最新发布的 4.0 版本带来了重大的 API 变更，本文将详细介绍如何从 3.x 版本平滑迁移到 4.0。

升级前提条件

系统要求：iOS 8.0 及以上
开发环境：Xcode 8.0 及以上
语言版本：Swift 3.0 及以上

升级优势

4.0 版本最显著的改进是引入了Promise 风格的动画 API，彻底解决了旧版本中嵌套闭包带来的代码可读性问题。新的 API 设计让动画序列的编写更加直观和易于维护。

主要变更解析

动画API的重大革新

在Interface Builder中的动画

对于仅在 Interface Builder 中配置的动画，4.0 版本完全保持兼容，开发者无需做任何修改。

代码中的动画实现

旧版本（3.x）的动画API采用嵌套闭包的方式实现动画序列，导致代码可读性差且容易出错：

// 旧版API示例
view.squeezeFade(.in, direction: .down) {
  view.pop(repeatCount: 1) {
    view.shake(repeatCount: 1) {
      // 更多嵌套...
    }
  }
}

这种"金字塔式"的代码结构不仅难以阅读，而且在修改动画参数时会产生副作用：

view.squeezeFade(.in, direction: .down) {
  view.velocity = 2  // 这个参数会影响后续所有动画
  view.pop(repeatCount: 1) {
    // 这里的shake动画也会继承velocity=2
    view.shake(repeatCount: 1)
  }
}

4.0 版本引入了链式调用的Promise风格API：

// 新版API示例
view.animate(.squeezeFade(way: .in, direction: .down))
    .then(.pop(repeatCount: 1))
    .then(.shake(repeatCount: 1))
    .then(.squeeze(way: .in, direction: .down))
    // 更多链式调用...
    .completion { print("所有动画完成!") }

关键API变更详解

移除了完成闭包：
- 旧版：每个动画方法都带有一个完成闭包
- 新版：使用then()方法连接动画，最后使用completion处理全部完成事件
统一动画调用方式：
- 旧版：每种动画有独立的方法（如pop(), shake()）
- 新版：统一使用animate()方法配合AnimationType枚举
动画参数传递方式变更：
- 旧版：通过修改视图属性设置参数
```
view.duration = 0.8
view.animate()
```
- 新版：通过方法参数传递
```
view.animate(.pop(), duration: 0.8)
```
延迟动画的新写法：
- 旧版：设置view.delay属性
- 新版：使用delay()方法
```
view.delay(0.5).then(.pop())
```