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).
In your app delegate's didFinishLaunching
method, after initializing the window, just call
UIApplication.configureLinearNetworkActivityIndicatorIfNeeded()
Then, use the standard network activity indicator as usual.
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.
- iOS 11 or higher
- compiles for Mac Catalyst or visionOS (without network activity indicator)
FTLinearActivityIndicator is available through Swift Package Manager or CocoaPods.
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:
- In Xcode, select “File” → “Add Packages…”
- Enter
https://github.com/futuretap/FTLinearActivityIndicator.git
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.
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!
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.