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 完成，其核心流程：

1. 分词与断行：基于 CTFramesetter（CoreText 接口）进行单词分割与换行计算。
2. 附件处理：识别 YYTextAttachment 协议对象，计算其占位尺寸。
3. 行高调整：通过 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 使用三级缓存策略：

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

2.3.2 增量更新

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

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

三、实践建议与扩展方向

3.1 性能调优技巧

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

3.2 自定义扩展

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

四、对比 CoreText 的优势

五、总结与展望

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

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

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