Dash-iOS 中的 NSTimer+Blocks：让 NSTimer 直接使用 Block 回调的轻量级 Category 实践指南

• 开发工具

导读

本文围绕 Dash-iOS 仓库中引入的第三方组件 NSTimer-Blocks（位于 Pods/NSTimer-Blocks/README.md），系统讲解它如何为系统类NSTimer注入"直接使用 Block 作为回调"的能力，包括其基于target/selector/userInfo的劫持式实现原理、完整 API 与使用示例，并结合 Dash-iOS 源码中的真实调用场景（远程同步防抖、Web 进度条、剪贴板同步）给出可落地的实战方案。读完本文，你将掌握如何用两行代码替代繁琐的 selector 定时器写法，并理解其中 Block 拷贝、内存管理与防重入的底层细节。

一、组件概览：一个"极其简单"的 NSTimer Block 扩展

NSTimer-Blocks 是 Random Ideas, LLC 在 2011 年发布的一个极简 Objective-C Category（分类），它的全部代码只有两个文件：

• Pods/NSTimer-Blocks/NSTimer+Blocks.h —— 对外暴露的两个类方法声明；
• Pods/NSTimer-Blocks/NSTimer+Blocks.m —— 核心实现，仅约 30 行。

正如其 README 第一句话所描述："Extremely simple category on NSTimer which makes it able to use blocks."（一个让 NSTimer 能够使用 Block 的极其简单的分类）。它不引入任何新类、不改变现有 API，而是以 Category 的形式为NSTimer追加两个以block:为参数的新方法，让开发者用闭包书写定时器回调，从而获得更内聚、可读性更高的代码组织方式。

该组件在 Dash-iOS 中通过 CocoaPods 引入，声明位置在项目根目录的 Podfile（pod 'NSTimer-Blocks'），当前锁定版本为 0.0.1，见 Pods/Manifest.lock。

二、工作原理：劫持 target/selector/userInfo 的"移花接木"

原文档在 "HOW IT WORKS" 一节用直白的话说明了实现思路。作者的设计推理是：既然你选择了用 Block 写回调，大概率就不需要再向定时器传入 userInfo 对象——你可以在 Block 内部自由捕获访问任何需要的东西。因此，实现方案是：

1. 把开发者传入的 Block 通过copy拷贝到堆上；
2. 调用系统原有的+scheduledTimerWithTimeInterval:target:selector:userInfo:repeats:（及其"兄弟"方法+timerWithTimeInterval:target:selector:userInfo:repeats:），但把target指定为分类自身（self，即 NSTimer 类对象）；
3. 把 Block 作为userInfo参数传入；
4. 当定时器触发时，系统会向self发送selector指定的消息，也就是分类内部实现的+jdExecuteSimpleBlock:；
5. 该方法从userInfo中取出 Block 并执行。

这样，系统的定时器机制（runloop 调度、重复/非重复、立即/延迟启动）被原样保留，只是回调对象从"某个指定 target"换成了"NSTimer 自己 + 一个内部执行器"。用源码可以看得更清楚：

+(id)scheduledTimerWithTimeInterval:(NSTimeInterval)inTimeInterval block:(void (^)())inBlock repeats:(BOOL)inRepeats { void (^block)() = [inBlock copy]; id ret = [self scheduledTimerWithTimeInterval:inTimeInterval target:self selector:@selector(jdExecuteSimpleBlock:) userInfo:block repeats:inRepeats]; [block release]; return ret; } +(void)jdExecuteSimpleBlock:(NSTimer *)inTimer; { if([inTimer userInfo]) { void (^block)() = (void (^)())[inTimer userInfo]; block(); } }

值得注意的细节：

• Block 的拷贝与释放：实现先[inBlock copy]把栈上 Block 复制到堆上（在 MRC 环境下，Block 作为参数传入时默认在栈上，必须拷贝才能跨越方法作用域存活），随后交给系统定时器持有；[block release]释放的是分类方法内的临时引用，定时器对userInfo的 retain 仍在维护其生命周期。jdExecuteSimpleBlock:中对userInfo做判空保护，即使传入 nil 也不会崩溃。
• 对系统 API 的"劫持"：README 明确称之为 hijack（劫持），即不重新实现定时调度逻辑，而是把系统方法当作底层管道复用，仅替换 target 与回调投递方式，因此定时器精度、runloop 行为与系统原生完全一致。

三、API 一览与使用方法

3.1 头文件暴露的两个方法

NSTimer+Blocks.h声明的 API 只有两个类方法，均返回id（实际返回 NSTimer 实例）：

+(id)scheduledTimerWithTimeInterval:(NSTimeInterval)inTimeInterval block:(void (^)())inBlock repeats:(BOOL)inRepeats; +(id)timerWithTimeInterval:(NSTimeInterval)inTimeInterval block:(void (^)())inBlock repeats:(BOOL)inRepeats;

两者的差异与系统同名方法一致：

参数说明：

• inTimeInterval：NSTimeInterval（double 秒），即触发间隔，必须大于 0；
• inBlock：无参 Blockvoid (^)()，定时器触发时执行的回调体；
• inRepeats：BOOL，YES表示按间隔重复触发，NO表示只触发一次。

3.2 官方示例：两行代码替代 selector

README 中的 "HOW TO USE IT" 给出了最核心的用法，完整继承如下：

[NSTimer scheduledTimerWithTimeInterval:2.0 block:^ { [someObj doSomething]; [someOtherObj doSomethingElse]; // ... etc ... } repeats:NO];

这段代码的含义是：创建一个 2 秒后触发一次的定时器，触发时在 Block 内依次执行多个操作。相比传统写法——

[NSTimer scheduledTimerWithTimeInterval:2.0 target:self selector:@selector(doSomething:) userInfo:nil repeats:NO];

——Block 版本把"回调逻辑"直接内联在创建点附近，避免了为单次回调单独拆分方法、传递上下文（userInfo）等样板代码，尤其适合那些"只在此处使用一次"的逻辑片段。

README 作者也坦诚地给出了评价：对大多数 NSTimer 操作而言这或许是"杀鸡用牛刀"（overkill），传统的 selector 方式完全可用；但有些场景用 Block 更优雅（more elegant）——这正是该组件存在的意义。

四、Dash-iOS 中的真实调用链：Block 定时器的三种实战形态

组件在 Dash-iOS 中被广泛采用，Dash-Prefix.pch在工程级预编译头中统一导入 NSTimer+Blocks.h，因此整个工程任意文件均可直接使用。从源码看，主要有三种实战形态。

4.1 防抖（Debounce）：远程同步 WebView URL

Dash/DHRemoteServer.m 中，服务器需要把 WebView 的 URL 变化同步给已连接的 Mac，但 URL 可能在短时间内连续变化，直接每次都发送会造成消息洪泛。实现采用"取消旧定时器 + 延迟重发"的防抖模式：

self.sendWebViewURLTimer = [self.sendWebViewURLTimer invalidateTimer]; if(self.connectedRemote) { url = [url stringByReplacingOccurrencesOfString:@"dash-tarix://" withString:@"file://"]; self.sendWebViewURLTimer = [NSTimer scheduledTimerWithTimeInterval:0.05 block:^{ [self sendObject:@{@"url": url} forRequestName:@"syncWebViewURL" encrypted:YES toMacName:self.connectedRemote.name]; } repeats:NO]; }

配合项目自有的 NSTimer+DHUtils 分类（invalidateTimer方法先判断isValid再invalidate，并返回 nil 便于赋值），每次 URL 变化都会先取消上一个未触发的 0.05 秒定时器，只有停止变化 50ms 后才真正发送一次同步消息。这里 Block 的"捕获上下文"优势体现得很直接：url、self 均被 Block 直接捕获，无需封装 userInfo。

4.2 延迟推进：Web 页面加载进度条

Dash/DHWebProgressView.m 是一个模拟 Safari 风格的进度条组件，其fakeSetProgress:方法借助 Block 定时器在下一帧延后改变动画时长，实现"缓慢推进"的假进度效果：

- (void)fakeSetProgress:(float)progress { self.fakeLoadTimer = [NSTimer scheduledTimerWithTimeInterval:0.01 block:^{ self.barAnimationDuration = 3.0; self.fadeAnimationDuration = 3.0; [self setProgress:progress animated:YES]; self.barAnimationDuration = 0.27; self.fadeAnimationDuration = 0.27; } repeats:NO]; }

注意这里 Block 内使用了self.barAnimationDuration——捕获的是属性读写，Block 执行发生在定时器回调时，此刻读取/写入的是当前 self 的最新状态，这正是 Block 相对 selector 的灵活之处。

4.3 剪贴板监听合并：从 UIPasteboard 到 Mac 的同步

Dash/DHAppDelegate.m 监听剪贴板变化通知，同样采用"先取消再新建"的 0.1 秒防抖定时器，把频繁触发的UIPasteboardChangedNotification合并为一次加密同步发送：

self.clipboardChangedTimer = [self.clipboardChangedTimer invalidateTimer]; self.clipboardChangedTimer = [NSTimer scheduledTimerWithTimeInterval:0.1 block:^{ [[DHRemoteServer sharedServer] sendObject:@{@"string": string} forRequestName:@"syncClipboard" encrypted:YES toMacName:[DHRemoteServer sharedServer].connectedRemote.name]; } repeats:NO];

三个案例共同印证了组件的两大设计价值：Block 直接捕获外部状态免去 userInfo 包装，以及与invalidateTimer组合形成标准防抖范式。

五、内存管理与注意事项

由于组件基于 NSTimer 系统机制实现，使用 Block 版本定时器时需注意：

1. 循环引用（Retain Cycle）：定时器创建后会被 runloop 强持有，若 Block 内强引用self（如[self sendObject...]），则形成self → timer → block → self的环。非重复（repeats:NO）定时器触发一次后自动失效，环会随之解开，风险较低；重复定时器则必须在viewWillDisappear:/dealloc等时机调用invalidate，必要时在 Block 内使用__weak弱引用 self。这也是 Dash 工程在 DHRemoteServer.m 中先invalidateTimer再重建、并在每次重建前取消旧定时器的原因之一。
2. 定时器持有 Block，Block 拷贝到堆：组件内部通过copy保证 Block 生命周期跨越方法作用域，开发者无需手动管理；但重复定时器会持续持有 Block 及其捕获对象，需评估捕获内容的内存开销。
3. runloop 模式：scheduledTimer...默认加入NSDefaultRunLoopMode，滚动 UIScrollView 等场景下定时器可能暂停，若需在滚动中持续触发，建议使用timerWithTimeInterval:block:repeats:手动加入NSRunLoopCommonModes。
4. Block 签名：API 声明为无参 Blockvoid (^)()，定时器触发的时刻信息（如NSDate）无法直接获得，如需fireDate等仍可访问定时器对象本身（如[NSTimer scheduledTimer...].fireDate）或在 Block 外持有返回的 timer 引用。
5. ARC 环境：组件源码使用 MRC 风格（[block release]），在 Pods 构建配置中通过-fno-objc-arc编译标志以非 ARC 方式编译（见 Pods.xcodeproj/project.pbxproj），对使用方透明，开发者无需关心内存管理细节。

六、安装与集成

在 Dash-iOS 中，组件通过 CocoaPods 声明引入，见 Podfile：

pod 'NSTimer-Blocks'

安装后在需要使用的位置#import "NSTimer+Blocks.h"即可（Dash 工程将其放在 Dash-Prefix.pch 全局导入）。该组件的依赖极轻，仅依赖 Foundation，不引入任何 UI 框架，适用于所有 iOS/macOS Objective-C 工程。

七、LICENSE：MIT 风格宽松许可

README 末尾附带的 LICENSE 为 MIT 风格许可（Copyright (C) 2011 by Random Ideas, LLC），允许自由使用、复制、修改、合并、发布、分发、再许可与销售，唯一要求是保留上述版权声明与许可文本。Dash-iOS 的 CocoaPods 依赖致谢文件（Dash/Settings.bundle/Cocoa_Pods_Acknowledgements.plist）也据此收录了该组件及其许可文本。

总结

NSTimer-Blocks 用约 30 行代码完成了一件"小而美"的事：通过 Category 劫持系统的target/selector/userInfo管道，把 NSTimer 回调升级为 Block 语法。在 Dash-iOS 中，它被用于远程同步防抖、进度条延迟推进、剪贴板合并上报等场景，与NSTimer+DHUtils的invalidateTimer组合成了一套成熟的可复用定时器模式。理解其"拷贝 Block → 作为 userInfo → 内部执行器取出并调用"的实现链路，你就能在自有项目中安全、高效地运用这一模式，同时规避循环引用与 runloop 模式等常见陷阱。

• 开发工具