Gemini源码剖析：从基础类到复杂动画的实现机制

芮舒淑

786人浏览 · 2026-03-24 02:20:18

芮舒淑 · 2026-03-24 02:20:18 发布

Gemini源码剖析：从基础类到复杂动画的实现机制

【免费下载链接】Gemini Gemini is rich scroll based animation framework for iOS, written in Swift. 项目地址: https://gitcode.com/gh_mirrors/ge/Gemini

Gemini是一个功能丰富的iOS滚动动画框架，采用Swift编写，能够帮助开发者轻松实现各种基于滚动的复杂动画效果。本文将深入剖析Gemini的源码结构，从基础类设计到复杂动画实现机制，带您全面了解这个强大的动画框架。

核心架构概览

Gemini框架采用了面向协议的设计思想，通过定义一系列动画协议和实现类，构建了灵活且可扩展的动画系统。核心架构主要包含以下几个部分：

动画协议：定义了各种动画效果的接口规范
动画模型：实现动画协议，管理动画状态和参数
集合视图：负责处理滚动事件并触发动画
单元格：承载动画效果的视图容器

Gemini框架架构示意图，展示了主要组件之间的关系

基础类设计

GeminiCollectionView

Gemini的核心视图类是GeminiCollectionView，它继承自UICollectionView，并重写了布局设置和滚动相关方法：

public final class GeminiCollectionView: UICollectionView {
    public func animateVisibleCells() {
        // 实现可见单元格的动画
    }
    
    public func animateCell(_ cell: GeminiCell) {
        // 实现单个单元格的动画
    }
}

这个类负责监听滚动事件，并在适当的时机触发单元格动画。它包含一个GeminiAnimationModel实例，用于管理动画状态。

GeminiCell

GeminiCell是所有动画单元格的基类，继承自UICollectionViewCell：

open class GeminiCell: UICollectionViewCell {
    // 单元格基础实现
}

所有需要应用Gemini动画的单元格都应该继承自这个类，它提供了动画所需的基础属性和方法。

动画协议体系

Gemini定义了一系列动画协议，每种协议对应一种特定的动画类型。这些协议包括：

基础动画协议

ScaleAnimatable：定义缩放动画接口
UIAppearanceAnimatable：定义外观动画接口，如阴影、透明度等
EasingAnimatable：定义动画缓动函数接口

特定动画协议

CubeAnimatable：立方体旋转动画
CircleRotationAnimatable：圆周旋转动画
RollRotationAnimatable：滚动旋转动画
PitchRotationAnimatable：俯仰旋转动画
YawRotationAnimatable：偏航旋转动画
CustomAnimatable：自定义动画

这些协议通过组合的方式实现了复杂的动画效果。例如，PitchRotationAnimatable继承自ScaleAnimatable和UIAppearanceAnimatable：

public protocol PitchRotationAnimatable: ScaleAnimatable, UIAppearanceAnimatable {
    @discardableResult func degree(_ degree: CGFloat) -> PitchRotationAnimatable
    @discardableResult func pitchEffect(_ effect: PitchRotationEffect) -> PitchRotationAnimatable
}

动画模型实现

GeminiAnimationModel是动画实现的核心类，它实现了所有动画协议：

final class GeminiAnimationModel: Gemini {
    // 动画属性和实现
}

// 扩展实现各种动画协议
extension GeminiAnimationModel: CubeAnimatable { ... }
extension GeminiAnimationModel: CircleRotationAnimatable { ... }
extension GeminiAnimationModel: RollRotationAnimatable { ... }
// 其他动画协议扩展...

这种设计使得动画模型可以灵活地支持多种动画效果，并且易于扩展新的动画类型。

动画参数配置

Gemini提供了丰富的动画参数配置选项，通过枚举类型定义了各种动画效果：

ShadowEffect

ShadowEffect枚举定义了阴影效果的类型：

public enum ShadowEffect {
    case none
    case fade
    case lift
    // 其他阴影效果...
}

GeminScaleEffect

GeminScaleEffect枚举定义了缩放效果的类型：

public enum GeminScaleEffect {
    case scaleUp
    case scaleDown
    // 其他缩放效果...
}

CircleRotationDirection

CircleRotationDirection枚举定义了圆周旋转的方向：

public enum CircleRotationDirection {
    case left
    case right
}

这些枚举类型使得开发者可以轻松配置动画效果，例如设置缩放效果：

collectionView.gemini
    .scaleAnimation()
    .scale(0.8)
    .scaleEffect(.scaleUp)

动画触发机制

Gemini的动画触发主要通过GeminiCollectionView的animateCell方法实现：

public func animateCell(_ cell: GeminiCell) {
    // 计算滚动比例
    // 根据比例应用动画效果
}

当用户滚动集合视图时，GeminiCollectionView会计算每个可见单元格的滚动位置比例，然后根据这个比例应用相应的动画效果。这种基于滚动位置的动画触发机制，使得动画与用户交互紧密结合，创造出流畅自然的视觉效果。

Gemini动画效果展示，展示了滚动过程中的动态变化

实际应用示例

要在项目中使用Gemini，首先需要将其集成到您的项目中。您可以通过CocoaPods安装：

pod 'Gemini'

或者直接从Git仓库克隆：

git clone https://gitcode.com/gh_mirrors/ge/Gemini

然后，创建GeminiCollectionView并配置动画效果：

let layout = UICollectionViewFlowLayout()
let collectionView = GeminiCollectionView(frame: view.bounds, collectionViewLayout: layout)

// 配置立方体动画
collectionView.gemini
    .cubeAnimation()
    .cubeDegree(45)
    .shadowEffect(.lift)
    .radius(200)