Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jonnybeegod/cloudkitfeaturetoggles
Native CloudKit Feature-Toggles written in Swift
https://github.com/jonnybeegod/cloudkitfeaturetoggles
cloudkit feature-switcher feature-switches feature-toggle feature-toggles ios swift swift-package-manager
Last synced: 18 days ago
JSON representation
Native CloudKit Feature-Toggles written in Swift
- Host: GitHub
- URL: https://github.com/jonnybeegod/cloudkitfeaturetoggles
- Owner: JonnyBeeGod
- License: mit
- Created: 2020-01-04T08:00:21.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2020-01-06T18:01:21.000Z (almost 5 years ago)
- Last Synced: 2024-10-28T21:51:08.334Z (2 months ago)
- Topics: cloudkit, feature-switcher, feature-switches, feature-toggle, feature-toggles, ios, swift, swift-package-manager
- Language: Swift
- Homepage:
- Size: 45.9 KB
- Stars: 5
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# CloudKit FeatureToggles
[](https://codecov.io/gh/JonnyBeeGod/CloudKitFeatureToggles)
## What does it do?
Feature Toggles offer a way to enable or disable certain features that are present in your codebase, switch environments or configurations or toggle between multiple implementations of a protocol - even in your live system at runtime. *CloudKit FeatureToggles* are implemented using `CloudKit` and are therefor associated with no run costs for the developer. Existing Feature Toggles can be changed in the [CloudKit Dashboard](https://icloud.developer.apple.com/dashboard/) and are delivered immediately via silent push notifications to your users.
## How to install?
CloudKitFeatureToggles is compatible with Swift Package Manager. To install, simply add this repository URL to your swift packages as package dependency in Xcode.
Alternatively, add this line to your `Package.swift` file:
```
dependencies: [
.package(url: "https://github.com/JonnyBeeGod/CloudKitFeatureToggles", from: "0.1.0")
]
```
And don't forget to add the dependency to your target(s).
## How to use?
### CloudKit Preparations
1. If your application does not support CloudKit yet start with adding the `CloudKit` and `remote background notification` entitlements to your application
2. Add a new custom record type 'FeatureStatus' with two fields:
| Field | Type |
| --- | --- |
| `featureName` | `String` |
| `isActive` | `Int64` |
For each feature toggle you want to support in your application later add a new record in your CloudKit *public database*.
### In your project
1. In your AppDelegate, initialize a `FeatureToggleApplicationService` and hook its two `UIApplicationDelegate` methods into the AppDelegate lifecycle like so:
```
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
// Override point for customization after application launch.
return featureToggleApplicationService.application(application, didFinishLaunchingWithOptions: launchOptions)
}
func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {
featureToggleApplicationService.application(application, didReceiveRemoteNotification: userInfo, fetchCompletionHandler: completionHandler)
}
```
2. Anywhere in your code you can create an instance of `FeatureToggleUserDefaultsRepository` and call `retrieve` to fetch the current status of a feature toggle.
> :warning: Note that `retrieve` returns the locally saved status of your toggle, this command does not trigger a fetch from CloudKit. Feature Toggles are fetched from CloudKit once at app start from within the `FeatureToggleApplicationService` `UIApplicationDelegate` hook. Additionally you can subscribe to updates whenever there was a change to the feature toggles in CloudKit as shown in the next section.
3. You have to call `retrieve` with your implementation of a `FeatureToggleIdentifiable`. What I think works well is creating an enum which implements `FeatureToggleIdentifiable`:
```
enum FeatureToggle: String, FeatureToggleIdentifiable {
case feature1
case feature2
var identifier: String {
return self.rawValue
}
var fallbackValue: Bool {
switch self {
case .feature1:
return false
case .feature2:
return true
}
}
}
```
### Notifications
You can subscribe to updates from your feature toggles in CloudKit by subscribing to the `onRecordsUpdated` Notification like so:
```
NotificationCenter.default.addObserver(self, selector: #selector(updateToggleStatusFromNotification), name: NSNotification.Name.onRecordsUpdated, object: nil)
```
```
@objc
private func updateToggleStatusFromNotification(notification NSNotification) {
guard let updatedToggles = notification.userInfo[Notification.featureToggleUserInfoKey] as? [FeatureToggle] else {
return
}
// do something with the updated toggle like e.g. disabling UI elements
}
```
Note that the updated Feature Toggles are attached to the notifications userInfo dictionary. When this notification has been sent the updated values are also already stored in the repository.