FTLinearActivityIndicator

1.7

Add the missing network activity indicator on notched iPhones
futuretap/FTLinearActivityIndicator

What's New

iPhone 15 (Pro) support

2023-10-05T11:01:28Z

FTLinearActivityIndicator

Version Swift Package Manager compatible License Platform Sponsor Mastodon

iPhones with a notch or Dynamic Island don't display the network activity indicator anymore. This framework brings it back by placing an activity indicator in the upper right of the screen on top of the regular status bar items on the following devices:

  • iPhone X
  • iPhone Xs
  • iPhone Xs Max
  • iPhone Xʀ
  • iPhone 11
  • iPhone 11 Pro
  • iPhone 11 Pro Max
  • iPhone 12
  • iPhone 12 mini
  • iPhone 12 Pro
  • iPhone 12 Pro Max
  • iPhone 13
  • iPhone 13 mini
  • iPhone 13 Pro
  • iPhone 13 Pro Max
  • iPhone 14
  • iPhone 14 Plus
  • iPhone 14 Pro
  • iPhone 14 Pro Max
  • iPhone 15
  • iPhone 15 Plus
  • iPhone 15 Pro
  • iPhone 15 Pro Max

Since a circular indicator wouldn't fit, a rectangular KITT scanner-like indicator with a gradient is shown. The indicator UI can be used standalone or as a "fix" for the iOS network activity indicator (using the existing API).

Integration

As a fix for the system network activity indicator

In your app delegate's didFinishLaunching method, after initializing the window, just call

UIApplication.configureLinearNetworkActivityIndicatorIfNeeded()

Then, use the standard network activity indicator as usual.

As a standalone view

Include a FTLinearActivityIndicator view in your storyboard or instantiate it from code. The class supports the following methods and properties, using a similar API as the iOS UIActivityIndicatorView:

  • startAnimating()
  • stopAnimating()
  • isAnimating: Bool
  • hidesWhenStopped: Bool

tintColor is supported to colorize the indicator gradient.

Requirements

  • iOS 11 or higher
  • compiles for Mac Catalyst or visionOS (without network activity indicator)

Installation

FTLinearActivityIndicator is available through Swift Package Manager or CocoaPods.

Swift Package Manager

To install FTLinearActivityIndicator using Swift Package Manager you can follow the tutorial published by Apple using the URL for the FTLinearActivityIndicator repo with the current version:

  1. In Xcode, select “File” → “Add Packages…”
  2. Enter https://github.com/futuretap/FTLinearActivityIndicator.git

CocoaPods

To install FTLinearActivityIndicator via CocoaPods, add the following line to your Podfile:

pod 'FTLinearActivityIndicator'

Then run pod install.

To open an example project, just call pod try FTLinearActivityIndicator on the command line.

Author

Ortwin Gentz, FutureTap GmbH, Mastodon/Fediverse: @ortwingentz@mastodon.cloud

If you would like to support my Open Source work, consider joining me as a sponsor! 💪️ Your sponsorship enables me to spend more time on FTLinearActivityIndicator and other community projects. Thank you!

License

FTLinearActivityIndicator is available under the CC-BY-SA 4.0 license. You may copy and redistribute, adapt and build upon the framework for any purpose, even commercially, as long as you give credit to me in the About menu or a similar place in the app.

Description

  • Swift Tools 5.0.0
View More Packages from this Author

Dependencies

  • None
Last updated: Wed Nov 13 2024 04:30:28 GMT-1000 (Hawaii-Aleutian Standard Time)