移动开发UI组件【免费下载链接】SVProgressHUDA clean and lightweight progress HUD for your iOS and tvOS app.项目地址https://gitcode.com/gh_mirrors/sv/SVProgressHUD点击查看免费下载SVProgressHUD 是 iOS / tvOS 平台上一款经典的开源进度指示 HUD 组件。本文以仓库中的 CHANGELOG.md 为主线结合 SVProgressHUD.h、SVProgressHUD.m 等核心源码系统梳理该项目从 2.0-beta 到 2.3.1 的关键功能演进包括 tvOS 支持、AutoLayout 重构、grace time 机制、可定制毛玻璃效果、深色模式、Swift Package Manager 集成等。读完本文你将掌握各版本新增/修复能力背后的实现原理并能据此判断如何升级、如何按需定制自己的 HUD。一、版本脉络总览一条完整的现代化演进路线CHANGELOG 记录的时间跨度从 2.0-beta 一直到 2.3.1每一行都对应一次真实的功能新增New:或缺陷修复Fixed:。先给出整体视图版本类型核心变化2.0-beta里程碑新增 tvOS 支持、UIAppearance 支持、仓库迁移至独立组织2.0.1 – 2.0.4稳定性修复键盘通知崩溃、ring 层复位问题新增 maxSupportedWindowLevel 与 dismiss 完成回调2.1 – 2.1.3功能支持将 HUD 添加到自定义 UIView设置颜色时隐式切换为 Custom 样式修复 dismissWithDelay2.2里程碑全面迁移 AutoLayout新增 grace time全新 Fade in/out 动画移除 vibrancy2.2.2 – 2.2.5修正回滚 popActivity、修复状态标签隐藏逻辑、iOS 11.2 离屏键盘高度问题2.2.6定制增强自定义 blur 效果、重写无限旋转动画、独立 ring 颜色、可禁用 motion effect2.3.0现代适配SwiftPM 支持、深色模式、Dynamic Type、内存泄漏修复、iOS 13 定位修复2.3.1收尾补齐 SwiftPM 缺失的符号链接从源码结构看2.x 之后的 SVProgressHUD 始终维持单一文件 少量辅助组件的轻量设计SVProgressHUD.m1566 行承载主逻辑另有 SVIndefiniteAnimatedView.m、SVProgressAnimatedView.m、SVRadialGradientLayer.m 三个辅助渲染组件。二、2.0 时代的架构基石单例、tvOS 与 UIAppearance2.1 单例设计sharedView与 mainWindowCHANGELOG 中 2.0-beta 标注Support for tvOS而单例模式是这一切的基础。 (SVProgressHUD*)sharedView通过dispatch_once创建全局唯一的 HUD 实例SVProgressHUD.m#L67-L77。在 App Extension 场景下则改用UIScreen mainScreen的 bounds 初始化 (SVProgressHUD*)sharedView { static dispatch_once_t once; static SVProgressHUD *sharedView; #if !defined(SV_APP_EXTENSIONS) dispatch_once(once, ^{ sharedView [[self alloc] initWithFrame:[SVProgressHUD mainWindow].bounds]; }); #else dispatch_once(once, ^{ sharedView [[self alloc] initWithFrame:[[UIScreen mainScreen] bounds]]; }); #endif return sharedView; }tvOS 与 iOS 差异主要体现在系统 API 的可用性上。2.0.1 的修复Build issues for tvOS, as UIKeyboard notifications are gone说明 tvOS 上不存在键盘通知因此当前代码在registerNotifications中通过#if TARGET_OS_IOS将键盘相关通知仅限定在 iOS 平台SVProgressHUD.m#L609-L640tvOS 只注册UIApplicationDidBecomeActiveNotification。2.2 UIAppearance全局外观定制2.0-beta 的UIAppearance support体现在头文件中大量UI_APPEARANCE_SELECTOR标注的属性上。以 SVProgressHUD.h#L71-L131 为例defaultStyle、defaultMaskType、ringThickness、ringRadius、cornerRadius、font、backgroundColor、foregroundColor等均支持UIAppearance协议意味着可以在应用启动时一次配置、全局生效。值得注意的是SVProgressHUD.m#L1470-L1520 中这些属性的 setter 都带有if (!_isInitializing)保护初始化阶段写入的默认值不会被 UIAppearance 的赋值覆盖这是避免默认值被配置值回写的关键细节。2.3 2.0.x 的稳定性修补2.0.4 引入了两个重要 APImaxSupportedWindowLevel限制 HUD 可以显示的最大 window level。frontWindow遍历时用window.windowLevel UIWindowLevelNormal window.windowLevel self.maxSupportedWindowLevel过滤SVProgressHUD.m#L1381-L1396默认值为UIWindowLevelNormal。dismiss 完成回调dismissWithCompletion:与dismissWithDelay:completion:被加入公共接口SVProgressHUD.h#L371-L380底层统一收敛到dismissWithDelay:completion:。2.0.4 还修复了 Ring not centered in HUD —— 这与updateHUDFrame中基于内容尺寸计算中心点的逻辑相关SVProgressHUD.m#L449-L524。三、2.2AutoLayout 重构、grace time 与全新的淡入淡出动画3.1 AutoLayout (finally)2.2 的标题性更新是 Update project to AutoLayout (finally)。从当前源码看布局逻辑集中在updateHUDFrameSVProgressHUD.m#L449-L524HUD 尺寸由状态文本、图片/进度环内容计算得出并与minimumSize取较大值self.hudView.bounds CGRectMake(0.0f, 0.0f, MAX(self.minimumSize.width, hudWidth), MAX(self.minimumSize.height, hudHeight));文本尺寸通过boundingRectWithSize:约束 200x300计算内容与文本之间保留SVProgressHUDLabelSpacing 8.0f的间距整体采用间距-内容-间距的对称布局。布局更新通过[CATransaction setDisableActions:YES]关闭隐式动画避免快速刷新时产生卡顿。3.2 grace time短任务不闪屏的宽限时间2.2 新增的 grace time#556解决了一个典型痛点耗时极短的任务如网络缓存命中也会闪现 HUD造成视觉干扰。graceTimeInterval默认 0 秒SVProgressHUD.h#L150设置为正值后showProgress:status:会延迟创建淡入定时器SVProgressHUD.m#L822-L828if (self.graceTimeInterval 0.0 self.backgroundView.alpha 0.0f) { strongSelf.graceTimer [NSTimer timerWithTimeInterval:self.graceTimeInterval target:strongSelf selector:selector(fadeIn:) userInfo:nil repeats:NO]; [[NSRunLoop mainRunLoop] addTimer:strongSelf.graceTimer forMode:NSRunLoopCommonModes]; } else { [strongSelf fadeIn:nil]; }配合setGraceTimer:的旧 timer 失效逻辑SVProgressHUD.m#L586-L594每次新的 show 都会重置宽限计时——任务在宽限期内完成则 HUD 根本不会出现。3.3 全新的 Fade in / Fade out 动画2.2 引入的淡入淡出动画#703 等取代了旧版动画源码中的实现是缩放 透明度组合淡入hudView先放大到 1.3 倍再动画回CGAffineTransformIdentity同时fadeInEffects让各子视图 alpha 归 1SVProgressHUD.m#L915-L965淡出dismissWithDelay:先dispatch_after延迟再动画缩放到 1/1.3 并执行fadeOutEffectsSVProgressHUD.m#L1001-L1070。其中有一段值得注意的注释UIViewAnimationOptionBeginFromCurrentState AND a delay doesnt always work as expected——这是 2.2.6 修复 After setting graceTimeInterval, dismiss(withDelay:) will not work correctly#828的伏笔带延迟的 dismiss 改为dispatch_after实现避免系统在延迟期内提前评估动画起始值导致动画被跳过。2.2 同时移除了 UIVibrancy 效果Remove vibrancy for better readability。当前fadeInEffects中保留了相关注释SVProgressHUD.m#L1415-L1419说明项目选择模糊背景 半透明底色0.6 alpha组合来保证文字可读性而不是叠加 vibrancy 层。3.4 popActivity 与 activityCount 计数2.2.2 回滚了 popActivity#824随后 2.2 正式版本继续保留该能力。其实现基于activityCount计数器每次show递增popActivity递减归零时才真正 dismissSVProgressHUD.m#L343-L350。注意showProgress:中仅在progress 0时递增计数SVProgressHUD.m#L805-L807而无限动画模式每次都递增SVProgressHUD.m#L819。四、2.2.6视觉定制能力的集中爆发2.2.6 是定制能力增强最多的一个版本CHANGELOG 中 5 条更新中有 4 条与外观相关。4.1 自定义 blur 效果与独立 ring 颜色#946此前 HUD 背景模糊样式是硬编码的2.2.6 通过setHudViewCustomBlurEffect:开放了自定义UIBlurEffect的能力并且该调用会隐式把样式切到SVProgressHUDStyleCustomSVProgressHUD.m#L219-L222。在fadeInEffects中Custom 样式直接采用hudViewCustomBlurEffect与自定义背景色SVProgressHUD.m#L1420-L1423而非预设样式的自动选择逻辑。同一 PR 还让 ring 颜色可以独立于背景设置。注意setForegroundColor:只影响文字/前景色而图片与 ring 的颜色统一由foregroundImageColorForStyle决定SVProgressHUD.m#L1198-L1204若未单独设置foregroundImageColor则回落到foregroundColorForStyle。4.2 重写无限动画视图#946Rewrite indefinite animation view彻底重构了转圈动画。新实现位于 SVIndefiniteAnimatedView.m采用CAShapeLayer绘制圆弧配合两张动画旋转动画对maskLayer使用 bundle 中的angle-mask.png作为遮罩见 SVProgressHUD.bundle施加无限transform.rotation动画SVIndefiniteAnimatedView.m#L72-L81描边伸缩动画strokeStart在 0.015→0.515、strokeEnd在 0.485→0.985 之间循环形成扫过效果SVIndefiniteAnimatedView.m#L89-L98。该视图通过defaultAnimationType与系统原生UIActivityIndicatorView互斥切换SVProgressHUD.m#L1081-L1117SVProgressHUDAnimationTypeFlat使用自绘动画SVProgressHUDAnimationTypeNative使用系统指示器。4.3 可禁用的 motion effect#9522.2.6 增加motionEffectEnabled默认 YES。开启时 HUD 会附加 ±10pt 的视差parallax效果updateMotionEffectForOrientation:依据方向选择UIInterpolatingMotionEffectTypeTiltAlongHorizontalAxis/VerticalAxis并组装成UIMotionEffectGroupSVProgressHUD.m#L526-L550。tvOS 上则固定使用水平垂直轴倾斜效果SVProgressHUD.m#L698-L700。4.4 无障碍修复#872Remove new line character before setting accessibility text对应fadeIn:中的处理将状态文本中的换行符替换为空格后再作为 accessibility label避免 VoiceOver 对同一文本重复朗读SVProgressHUD.m#L890-L891。五、2.3.0现代 iOS 的全面适配2.3.0 是通往当前版本2.3.1的最后一次大版本聚焦让老库适应新生态。5.1 Swift Package Manager 支持#981 等2.3.0 为项目加入了 Package.swift声明swift-tools-version:5.3最低支持 iOS 12 / tvOS 12并将SVProgressHUD.bundle与PrivacyInfo.xcprivacy作为资源随包分发// swift-tools-version:5.3 let package Package( name: SVProgressHUD, platforms: [.iOS(.v12), .tvOS(.v12)], products: [.library(name: SVProgressHUD, targets: [SVProgressHUD])], targets: [ .target(name: SVProgressHUD, path: SVProgressHUD, exclude: [SVProgressHUD-Prefix.pch], resources: [.copy(SVProgressHUD.bundle), .copy(PrivacyInfo.xcprivacy)], publicHeadersPath: include) ] )配套的imageBundle也增加了 SwiftPM 分支SVProgressHUD.m#L140-L148通过SWIFTPM_MODULE_BUNDLE宏找到模块内资源。2.3.1 的 Add missing symlinks for SPM (#1112) 则是对 SwiftPM 场景下符号链接缺失的收尾修补。若使用 CocoaPods可在 Podfile 中写入pod SVProgressHUD版本以 SVProgressHUD.podspec 中的2.3.1为准Carthage 用户则在Cartfile中写入github SVProgressHUD/SVProgressHUD。5.2 深色模式支持#965深色模式依赖SVProgressHUDStyleAutomatic2.1 引入的样式枚举之一。defaultStyleResolvingAutomatic根据traitCollection.userInterfaceStyle在深/浅之间自动切换SVProgressHUD.m#L1340-L1346- (SVProgressHUDStyle) defaultStyleResolvingAutomatic { if(self.defaultStyle SVProgressHUDStyleAutomatic) { return self.traitCollection.userInterfaceStyle UIUserInterfaceStyleDark ? SVProgressHUDStyleDark : SVProgressHUDStyleLight; } return self.defaultStyle; }默认defaultStyle就是SVProgressHUDStyleAutomaticSVProgressHUD.m#L402。深/浅样式下前景与背景色由foregroundColorForStyle/backgroundColorForStyle决定SVProgressHUD.m#L1186-L1216毛玻璃样式也随自动解析结果切换为UIBlurEffectStyleSystemMaterial或SystemMaterialDarkiOS 13见 SVProgressHUD.m#L1402-L1410。5.3 Dynamic Type字体随系统缩放#1072statusLabel新增adjustsFontForContentSizeCategory YESSVProgressHUD.m#L1305同时默认字体为[UIFont preferredFontForTextStyle:UIFontTextStyleSubheadline]SVProgressHUD.m#L405。开启后 HUD 文本会跟随系统的更大字体辅助功能设置动态缩放。5.4 图片视图尺寸为 0 时的判断修正#1098updateHUDFrame中判断是否使用了图片时增加了对imageViewSize是否为 0 的校验SVProgressHUD.m#L451BOOL imageUsed (self.imageView.image) !(self.imageView.hidden) (self.imageViewSize.height 0 self.imageViewSize.width 0);这样即使开发者将imageViewSize设为CGSizeZero布局引擎也能正确回退到进度环分支。5.5 内存泄漏修复与 iOS 13 定位修复从 bundle 加载图片的内存泄漏#1080imageView的 getter 中新增了尺寸比对逻辑当imageViewSize变化时移除旧实例重新创建SVProgressHUD.m#L1321-L1335避免了尺寸更新后残留旧视图。iOS 13 的 HUD 定位#1100mainWindow全面适配了UIScene多场景 API——遍历connectedScenes寻找前台活跃的UIWindowScene再定位 keyWindowSVProgressHUD.m#L80-L137并保留多级 fallback。iOS 13 以下仍走[UIApplication sharedApplication].windows的传统路径。5.6 2.2.x 的遗留修复#835/#854/#821 等2.2.3 修复了 iOS 11.2 上离屏键盘高度返回正值的问题#835 等对应visibleKeyboardHeight的窗口遍历检测SVProgressHUD.m#L1348-L1379修复setStatus:未同步更新状态标签 hidden 属性#854当前实现中setStatus:会同时设置 text 与 hidden 并触发updateHUDFrameSVProgressHUD.m#L580-L5842.2.3 使用available抑制 Xcode 9 警告#821 等对应代码中大量available(iOS 13.0, *)等编译期检查。六、贯穿各版本的核心 API 与源码映射将 CHANGELOG 中的关键词与当前源码一一对应便于在升级或二次开发时快速定位CHANGELOG 关键词源码位置说明grace time2.2SVProgressHUD.m#L822-L828graceTimeInterval延迟淡入Fade in/out2.2SVProgressHUD.m#L915-L965、SVProgressHUD.m#L1001-L1070缩放 alpha 组合动画popActivity2.2.2 回滚SVProgressHUD.m#L343-L350activityCount计数归零 dismiss自定义 blur2.2.6SVProgressHUD.m#L219-L222setHudViewCustomBlurEffect:隐式切换 Custom 样式自定义 ring 颜色2.2.6SVProgressHUD.m#L1198-L1204foregroundImageColorForStyle无限动画重写2.2.6SVIndefiniteAnimatedView.m#L46-L102CAShapeLayer mask 旋转 stroke 伸缩motion effect2.2.6SVProgressHUD.m#L526-L550±10pt 视差motionEffectEnabled控制深色模式2.3.0SVProgressHUD.m#L1340-L1346defaultStyleResolvingAutomaticDynamic Type2.3.0SVProgressHUD.m#L1305adjustsFontForContentSizeCategoryimageViewSize 为 02.3.0SVProgressHUD.m#L451imageUsed判定新增尺寸校验iOS 13 定位2.3.0SVProgressHUD.m#L80-L137基于UIScene的 mainWindow 查找内存泄漏2.3.0SVProgressHUD.m#L1321-L1335imageView随尺寸变化重建SPM2.3.0 / 2.3.1Package.swiftSwiftPM 清单与资源打包七、版本升级与使用建议从 2.0.x 升级到 2.2行为差异集中在动画与交互上。若业务依赖旧的 dismiss 行为注意 2.2.6 对dismiss(withDelay:) grace time 组合的修复若使用了popActivity确认 2.2.2 回滚后的语义计数器归零才 dismiss。从 2.2.x 升级到 2.3.x新版本默认样式为SVProgressHUDStyleAutomatic深色模式下外观会自动切换imageBundle的资源加载路径在 SwiftPM 下不同升级后务必回归验证图片与毛玻璃效果。目标部署版本当前仓库要求 iOS 12.0 / tvOS 12.0见 Package.swift 与 SVProgressHUD.podspec低于 12 的工程无法直接使用 2.3.1。App Extension 场景按 README.md 的说明需要#define SV_APP_EXTENSIONSCocoaPods 可用AppExtensionsubspec 自动完成并调用setViewForExtension:指定宿主视图源码中多处#if !defined(SV_APP_EXTENSIONS)分支即为此服务。配合测试与 Demo仓库根目录的 Demo 提供了 iOS 与 tvOS 两套示例工程覆盖了 show / dismiss / 自定义样式的完整调用链是验证上述行为的最直接入口。结语从 CHANGELOG 的每一次Fixed:与New:出发可以清晰看到 SVProgressHUD 如何在十余个版本中逐步解决键盘遮挡、暗黑模式、场景化 UI、包管理生态等真实工程问题。理解这些版本背后的源码动机不仅能帮你更好地升级与迁移也能在遇到自定义需求时快速定位到 SVProgressHUD.m 中对应的实现分支——这正是阅读 changelog 的最高价值所在。赞分享移动开发UI组件【免费下载链接】SVProgressHUDA clean and lightweight progress HUD for your iOS and tvOS app.项目地址https://gitcode.com/gh_mirrors/sv/SVProgressHUD点击查看免费下载相关推荐Firecracker 版本演进与功能变迁从 v0.1 到 1.16 的 CHANGELOG 深度解读Firecracker 版本演进与功能变迁从 v0.1 到 1.16 的 CHANGELOG 深度解读 Firecracker 是面向 Serverless虚拟化云原生SystemJS 版本演进全解析从 2.0 到 6.x 的核心特性变迁与源码级解读SystemJS 版本演进全解析从 2.0 到 6.x 的核心特性变迁与源码级解读 本文以仓库根目录 CHANGELOG.md https://link.gi前端Webamp 版本演进全解析从 0.0.6 到 2.3.1 的公共 API 与架构变迁Webamp 版本演进全解析从 0.0.6 到 2.3.1 的公共 API 与架构变迁 Webamp 是一个用 HTML5 与 JavaScript 在浏览器前端音视频上一篇TikTok API终极指南完整教程与实战应用下一篇猫抓浏览器扩展网页媒体资源嗅探下载的完整解决方案创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考