YYText 源码解析：高性能富文本框架的实现

一、YYText 概述与架构设计

YYText 是 iOS 平台一款开源的高性能富文本框架，支持图文混排、动态样式、异步渲染等复杂功能。其核心设计理念是通过模块化架构实现功能解耦，提升代码可维护性与扩展性。

1.1 模块化分层架构

YYText 的架构分为三层：

Core Layer：负责文本存储、布局计算与渲染基础能力。核心类包括 YYTextLayout（布局容器）、YYTextLine（单行文本布局）、YYTextAttachment（附件协议）。
Feature Layer：提供富文本特性支持，如高亮、下划线、阴影等。通过 YYTextHighlight、YYTextDecoration 等类实现。
UI Layer：封装视图组件，如 YYLabel 继承自 UILabel，通过重写 drawRect: 实现自定义渲染。

这种分层设计使得开发者可以仅引入所需模块（例如仅使用 Core Layer 的布局功能），降低二进制体积。

1.2 线程安全与异步渲染

YYText 通过 YYAsyncLayer 实现异步渲染，将布局计算与绘制操作分离到后台线程。关键实现：

// YYAsyncLayer.m
- (void)displayAsync:(BOOL)async {
    if (async) {
        dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^{
            // 后台线程计算布局
            YYTextLayout *layout = [self _calculateLayout];
            dispatch_async(dispatch_get_main_queue(), ^{
                // 主线程更新视图
                self.contents = [layout drawToBitmap];
            });
        });
    } else {
        // 同步模式（调试用）
        [self _calculateLayoutAndDraw];
    }
}

此设计避免了主线程阻塞，在长文本或复杂样式场景下性能提升显著。

二、核心模块解析

2.1 文本存储与布局计算

YYText 使用 YYTextContainer 定义文本边界，支持圆形、路径等非矩形布局。布局计算通过 YYTextLayout 完成，其核心流程：

分词与断行：基于 CTFramesetter（CoreText 接口）进行单词分割与换行计算。
附件处理：识别 YYTextAttachment 协议对象，计算其占位尺寸。
行高调整：通过 YYTextLinePositionModifier 自定义行间距与基线位置。

示例：自定义行高计算

// 自定义行高修饰器
@interface CustomLinePositionModifier : NSObject <YYTextLinePositionModifier>
@end
@implementation CustomLinePositionModifier
- (CGFloat)modifyLineHeight:(CGFloat)lineHeight 
                   withFont:(UIFont *)font {
    return lineHeight * 1.5; // 增加50%行高
}
@end
// 应用到 YYTextContainer
YYTextContainer *container = [YYTextContainer new];
container.linePositionModifier = [CustomLinePositionModifier new];

2.2 动态样式系统

YYText 通过 YYTextAttribute 协议支持运行时样式修改。关键类：

YYTextEffectWindow：管理高亮区域的触摸事件。
YYTextRunDelegate：控制字符级布局（如调整数字字体大小）。

动态样式更新示例：

// 创建可变属性字符串
NSMutableAttributedString *text = [[NSMutableAttributedString alloc] initWithString:@"Hello"];
[text yy_setTextHighlight:[YYTextHighlight highlightWithColor:[UIColor blueColor]] 
                    range:NSMakeRange(0, 5)];
// 运行时修改高亮样式
YYTextHighlight *highlight = [text yy_attribute:YYTextHighlightAttributeName atIndex:0];
highlight.color = [UIColor redColor];
[text yy_setTextHighlight:highlight range:NSMakeRange(0, 5)];

2.3 性能优化技术

2.3.1 内存缓存

YYText 使用三级缓存策略：

布局缓存：YYTextLayoutCache 存储已计算的布局结果。
位图缓存：YYAsyncLayer 对渲染结果进行缓存。
磁盘缓存：通过 YYCache 持久化存储复杂布局。

2.3.2 增量更新

当文本内容变化时，仅重新计算受影响部分：

// 增量更新示例
YYTextLayout *layout = ...;
NSRange changedRange = NSMakeRange(10, 5);
[layout updateLayoutWithChangedRange:changedRange];

三、实践建议与扩展方向

3.1 性能调优技巧

预计算布局：对静态文本提前调用 -calculateLayout 避免运行时卡顿。
限制附件数量：单个 YYTextLayout 建议附件数不超过 20 个。
使用简化模式：对纯文本场景禁用富文本特性以减少开销。

3.2 自定义扩展

新增附件类型：实现 YYTextAttachment 协议支持视频、GIF 等。
自定义布局引擎：继承 YYTextLayout 重写 -calculateLines 方法。
跨平台适配：参考 YYText 设计将 Core Layer 移植到 Android（如使用 SpannableString）。

四、对比 CoreText 的优势

特性	CoreText	YYText
异步渲染	需手动实现	内置支持
动态样式更新	需重建 `CTFramesetter`	局部更新属性
附件支持	仅支持 `CTRunDelegate`	协议化设计，扩展性强
调试工具	无	内置布局边界可视化

五、总结与展望

YYText 通过模块化设计、异步渲染和动态样式系统，解决了 iOS 富文本开发的性能与灵活性痛点。其源码中运用的缓存策略、增量更新等技巧具有普适性，值得在其他 UI 框架中借鉴。未来可探索的方向包括：

集成 Metal 加速渲染
增加 AR 文本布局支持
完善 Swift 接口封装

对于开发者而言，深入理解 YYText 源码不仅能解决实际项目中的富文本需求，更能提升对 UI 框架设计的认知，为构建高性能组件提供参考范式。

YYText 源码深度解析：高性能富文本框架实现