SwiftyTimer 完整 API 参考指南从 Timer.after 到 new(every:) 的全部方法详解与示例【免费下载链接】SwiftyTimerSwifty API for NSTimer项目地址: https://gitcode.com/gh_mirrors/sw/SwiftyTimerSwiftyTimer 是一款轻量级的 Swift 计时器工具库为NSTimer提供了现代化的 API。它让你用一行闭包语法就能完成延迟执行delay和重复定时repeating timer告别 Objective-C 时代的繁琐写法支持 iOS、macOS、watchOS 和 tvOS 全平台。 为什么新手需要 SwiftyTimer原生NSTimer的创建方式冗长、回调需要 target-action 模式、还要手动挂载 RunLoop。SwiftyTimer 把这些步骤全部封装成一行代码Timer.after(1.minute) { print(Are you still here?) }✅闭包语法无需 target-action直接写闭包✅时间单位助手100.ms、2.5.seconds、10.minutes告别魔法数字✅全平台支持iOS / macOS / tvOS / watchOS见 SwiftyTimer.podspec✅零依赖核心实现仅一个 Swift 文件 SwiftyTimer.swift安装方式任选其一方式操作Swift Package Manager添加依赖gh_mirrors/sw/SwiftyTimer配置见 Package.swiftCocoaPodsPodfile 中加入pod SwiftyTimer执行pod install手动集成把 Sources/SwiftyTimer.swift 拷贝进 Xcode 工程即可⏱️ 核心 API 速查表方法触发次数是否自动调度典型场景Timer.after(_:_:)1 次自动延迟提示、加载等待Timer.every(_:_:)重复自动心跳轮询、进度动画Timer.new(after:_:)1 次需手动start()先创建后控制Timer.new(every:_:)重复需手动start()需要 RunLoop 精细控制timer.start(runLoop:modes:)—手动调度入口滚动时不暂停的定时器 Timer.after延迟一段时间执行一次签名与实现见 SwiftyTimer.swiftTimer.after(2.seconds) { statusItem.blink() }要点闭包结束后计时器自动失效无需手动清理方法标记了discardableResult返回值Timer可忽略若需提前取消可以接住返回值并调用invalidate() Timer.every按固定间隔重复执行这是最常用的方法有两个重载版本版本一无参闭包源码 L42-L47Timer.every(0.7.seconds) { refreshBadge() }版本二闭包接收Timer实例源码 L52-L57Timer.every(5.seconds) { (timer: Timer) in if finished { timer.invalidate() // 满足条件时自己停止 } 版本二适合做几轮就停的场景闭包内拿到timer后调用invalidate()即可优雅终止。另外还支持直接传方法引用无需闭包包装Timer.every(30.seconds, align)️ Timer.new只创建、不调度的裸计时器new系列方法创建计时器但不会立即生效必须手动调用start()挂载到 RunLoop 后才会触发。签名见 SwiftyTimer.swiftlet timer Timer.new(every: 1.second) { print(self.status) } timer.start() // 现在才开始计时什么时候用new而不是every/after当你需要先创建、稍后启动比如等用户点按钮再start()指定挂载到特定的 RunLoop 或运行模式注new设计为类方法而非构造器是为了绕开 Foundation 在便利初始化器上的一个崩溃缺陷。⚙️ timer.start(runLoop:modes:)手动调度与 RunLoop 模式start方法让计时器挂载到指定的 RunLoop源码 L102-L113timer.start() // 默认当前 RunLoop .default 模式 timer.start(modes: .default, .eventTracking) // 滚动/拖拽时继续触发新手高频坑默认模式下用户滚动列表时定时器会暂停。如果你希望滚动中依然跳动比如倒计时就传入.eventTracking模式。完整示例可参考 main.swift 中的test6()。 时间单位助手让代码自解释SwiftyTimer 为Double扩展了一组 Rails 风格的时间属性源码 L118-L134直接替换裸数字写法等价于说明100.ms/100.milliseconds0.1毫秒2.5.seconds/1.second2.5秒10.minutes/1.minute600分钟1.hour3600小时2.days172800天对比一下Timer.after(60.0)需要脑算而Timer.after(1.minute)一眼看懂——单测文件 main.swift 中的断言验证了这些换算关系全部正确。 关键文件导航文件说明Sources/SwiftyTimer.swift全部 API 的唯一实现文件SwiftyTimerTests/SwiftyTimerTests/main.swift官方使用示例与自测程序Package.swiftSwiftPM 依赖配置SwiftyTimer.podspecCocoaPods 元信息与平台支持CHANGELOG.md版本演进记录v2.1.0 起适配 Swift 4.2README.md官方文档与用法示例✅ 新手上手清单只想延迟执行→ 用Timer.after最简单想重复执行→ 用Timer.every需停止时用带timer参数的重载需要滚动中不暂停→start(modes: .default, .eventTracking)需要控制启动时机→ 用Timer.new创建再手动start()停止重复计时器→ 在闭包内timer.invalidate()一次性计时器无需处理SwiftyTimer 用不到 150 行代码就把NSTimer变成了 Swift 开发者真正想用的样子。把 Sources/SwiftyTimer.swift 加入你的项目从此告别 timer 样板代码。【免费下载链接】SwiftyTimerSwifty API for NSTimer项目地址: https://gitcode.com/gh_mirrors/sw/SwiftyTimer创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考