FTLinearActivityIndicator：让刘海屏iPhone重获网络活动指示器的终极解决方案

FTLinearActivityIndicator：让刘海屏iPhone重获网络活动指示器的终极解决方案

【免费下载链接】FTLinearActivityIndicatorAdd the missing network activity indicator on notched iPhones项目地址: https://gitcode.com/gh_mirrors/ft/FTLinearActivityIndicator

FTLinearActivityIndicator是一款专为刘海屏和动态岛iPhone设计的实用框架，它能轻松恢复iOS系统中缺失的网络活动指示器功能。无论是开发新手还是资深开发者，都能通过简单集成让应用在各类iPhone机型上完美显示网络加载状态。

🧐 为什么需要FTLinearActivityIndicator？

自iOS 18起，苹果官方移除了传统的网络活动指示器，而带有刘海或动态岛的iPhone机型更是从未支持过这一实用功能。这导致用户在使用应用时无法直观判断网络请求状态，影响了整体使用体验。

FTLinearActivityIndicator通过在屏幕右上角状态栏区域添加一个类似KITT扫描仪的线性渐变指示器，巧妙解决了这一问题。它不会与现有状态栏元素冲突，在iPhone SE等非刘海机型上则会显示在时钟上方。

图：FTLinearActivityIndicator在刘海屏iPhone上的实际效果展示，包含两个切换按钮用于控制不同类型的活动指示器

🚀 快速集成指南

作为系统网络活动指示器的修复方案

只需在AppDelegate的didFinishLaunching方法中，初始化窗口之后添加一行代码：

UIApplication.configureLinearNetworkActivityIndicatorIfNeeded()

之后就可以像往常一样使用标准的网络活动指示器API：

• UIApplication.shared.isNetworkActivityIndicatorVisible = true
• UIApplication.shared.isNetworkActivityIndicatorVisible = false

作为独立视图使用

你可以通过故事板添加FTLinearActivityIndicator视图，或通过代码实例化，它支持类似UIActivityIndicatorView的API：

• startAnimating()- 开始动画
• stopAnimating()- 停止动画
• isAnimating- 检查是否正在动画
• hidesWhenStopped- 停止时是否隐藏
• tintColor- 自定义指示器渐变颜色

💻 安装方法

Swift Package Manager

1. 在Xcode中，选择 "File" → "Add Packages…"
2. 输入仓库地址：https://gitcode.com/gh_mirrors/ft/FTLinearActivityIndicator
3. 选择最新版本并完成安装

CocoaPods

在Podfile中添加以下行：

pod 'FTLinearActivityIndicator'

然后运行：pod install

⚙️ 技术要求

• iOS 12.0及以上系统（iOS 11支持至版本1.6）
• Swift 5.0及以上
• 兼容Mac Catalyst和visionOS（但在这些平台上不显示网络活动指示器）

📄 核心实现文件

框架的核心功能主要通过以下文件实现：

• FTLinearActivityIndicator.swift - 线性活动指示器视图的实现
• UIApplication+LinearNetworkActivityIndicator.swift - 系统网络活动指示器的修复扩展
• UIDevice+Extension.swift - 设备相关扩展，用于适配不同机型

📝 许可证信息

FTLinearActivityIndicator基于CC-BY-SA 4.0许可证发布。你可以复制、分发、修改和基于此框架进行商业开发，但需在应用的"关于"菜单或类似位置注明作者信息。

如果需要无归因要求的其他许可证，请联系原作者进行协商。

🌟 作者与支持

该框架由Ortwin Gentz开发，被FutureTap公司用于其Where To?和Streets应用中。如果你想支持开源项目，可以考虑成为项目的赞助者！

通过FTLinearActivityIndicator，你可以为用户提供清晰的网络活动反馈，提升应用的专业度和用户体验。立即尝试将这个简单而强大的框架集成到你的项目中吧！

【免费下载链接】FTLinearActivityIndicatorAdd the missing network activity indicator on notched iPhones项目地址: https://gitcode.com/gh_mirrors/ft/FTLinearActivityIndicator