AppState.dev
Swift Package for simple and fast integration of AppState.dev into iOS apps.
Features
- Fetch active notifications for your app
- Read notifications as JSON with the integrated decodable model
- Use one of our templates for SwiftUI, UITableView or UICollectionView
- Hide notifications (if their type can be dismissed)
- Restore hidden notifications
Screenshots
SwiftUI
UITableView
UICollectionView
Installation
Requirements
- iOS 14.0+ / macOS 12.0
- Xcode 13+
- Swift 5+
Swift Package Manager
In Xcode, go to File > Add Packages and add https://github.com/kaevinio/AppState. Add the package to all your targets.
How to Use
Fetching Notifications
All active notifications are fetched and kept in the AppStateManager within the package.
To initially fetch your notifications you need to import AppState and then set your appID:
let appId = "<Your app's ID>"
AppStateManager.shared.setAppID(appId)
Important: You can find your app’s ID in the macOS/iPadOS app by tapping on the info button in your app details.
By setting the ID, your notifications are fetched automatically. From now on, they can be accessed by calling their value:
AppStateManager.shared.states.value
Important: You need to call .value on the states property because they are stored in a CurrentValueSubject using the Combine framework.
The Example directory fetches notifications from a local JSON file containing exemplary notifications. The file represents the answer you get from our API.
Using Templates
You can use the built-in templates for SwiftUI, UITableViews and UICollectionViews.
When setting up your views, simply import AppState on the top of your file and call the respective view. An exemplary integration for a UICollectionView is as follows:
let appStateCell = UICollectionView.CellRegistration<AppStateCollectionViewCell, SectionItem> { _, _, _ in }
The reusable component here is AppStateCollectionViewCell.
In the Example directory you can find demo code to show how to setup all templates within their respective views.
