Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/onmyway133/lighterappdelegate
:fishing_pole_and_fish: Lighter AppDelegate by dispatching events
https://github.com/onmyway133/lighterappdelegate
appdegate protocol service
Last synced: 3 months ago
JSON representation
:fishing_pole_and_fish: Lighter AppDelegate by dispatching events
- Host: GitHub
- URL: https://github.com/onmyway133/lighterappdelegate
- Owner: onmyway133
- License: mit
- Created: 2016-01-16T02:23:19.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2016-01-16T03:56:18.000Z (about 9 years ago)
- Last Synced: 2024-10-13T20:55:48.862Z (4 months ago)
- Topics: appdegate, protocol, service
- Language: Swift
- Homepage:
- Size: 40 KB
- Stars: 10
- Watchers: 3
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# LighterAppDelegate
Lighter AppDelegate by dispatching events
[](https://travis-ci.org/Khoa Pham/LighterAppDelegate)
[](http://cocoapods.org/pods/LighterAppDelegate)
[](http://cocoapods.org/pods/LighterAppDelegate)
[](http://cocoapods.org/pods/LighterAppDelegate)
## Usage
To run the example project, clone the repo, and run `pod install` from the Example directory first.
## Features
### Dispatching events
- See [Lighter AppDelegate](http://www.fantageek.com/blog/2015/10/31/lighter-appdelegate/)
- You can use either by composition or inheritance
- Dispatching `UIApplicationDelegate` events into specific `Service` class. We can have RootService, DebugService, AnalyticsService, ...
```swift
class RootService : NSObject, UIApplicationDelegate {
func application(application: UIApplication,
didFinishLaunchingWithOptions launchOptions: [NSObject : AnyObject]?) -> Bool {
appDelegate().window = UIWindow(frame: UIScreen.mainScreen().bounds)
showHome()
appDelegate().window?.makeKeyAndVisible()
return true
}
}
extension RootService {
func showHome() {
let storyboard = UIStoryboard(name: "Main", bundle: nil)
appDelegate().window?.rootViewController = storyboard.instantiateInitialViewController()
}
}
extension RootService {
func appDelegate() -> AppDelegate {
return UIApplication.sharedApplication().delegate as! AppDelegate
}
}
```
### Composition
- Initialize `Dispatcher` with your list of services
- Dispatch interested `UIApplicationDelegate` events to `Dispatcher`
```swift
@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {
var window: UIWindow?
let dispatcher = Dispatcher(services: [RootService()])
func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject : AnyObject]?) -> Bool {
return dispatcher.application(application, didFinishLaunchingWithOptions: launchOptions)
}
}
```
### Inheritance
- Inherite from `LighterAppDelegate`
- Override `dispatcher()`
- `LighterAppDelegate` has default implementations for `App State Changes` and `URL` events, which is suitable for common usage.
- If you want to receive more events, add more functions inside your AppDelegate and dispatch to your `Dispatcher`
```swift
@UIApplicationMain
class AppDelegate: LighterAppDelegate {
var window: UIWindow?
let simpleDispatcher = Dispatcher(services: [RootService()])
override func dispatcher() -> Dispatcher {
return simpleDispatcher
}
func applicationDidReceiveMemoryWarning(application: UIApplication) {
dispatcher().applicationDidReceiveMemoryWarning(application)
}
}
```
### Warning
- Only implement `UIApplicationDelegate` functions in case you truly need. Unnecessary functions can cause problems
> You've implemented -[ application:performFetchWithCompletionHandler:], but you still need to add "fetch" to the list of your supported UIBackgroundModes in your Info.plist.
> You've implemented -[ application:didReceiveRemoteNotification:fetchCompletionHandler:], but you still need to add "remote-notification" to the list of your supported UIBackgroundModes in your Info.plist.
- Involving `remoteNotification` events also consider your app to [support Push Notification](https://forums.developer.apple.com/thread/15011)
> Your app appears to include API used to register with the Apple Push Notification service, but the app signature's entitlements do not include the "aps-environment" entitlement
- I 'd like `LighterAppDelegate` to be protocol with default implementations in its extension, but for now we can't provide default implementations for Objective-C protocols.
## Installation
LighterAppDelegate is available through [CocoaPods](http://cocoapods.org). To install
it, simply add the following line to your Podfile:
```ruby
pod "LighterAppDelegate"
```
## Credit
Credit goes to http://sizeof.io/service-oriented-appdelegate/
## Author
Khoa Pham, [email protected]
## License
LighterAppDelegate is available under the MIT license. See the LICENSE file for more info.