ApplicationEventObserver

Application event notification (e.g. UIApplicationDidBecomeActiveNotification) handling in Swift.

🎉Features

You don't have to use NSNotificationCenter.
You can catch event(s) only you want to.
You can do subscribe/resume/suspend/dispose at anytime.

✏️How to use

First, you create ApplicationEventObserver instance.
The instance obverves UIApplication events untill release(deinit).
(e.g.)

class ViewController: UIViewController {
    private lazy var appEventObserver = ApplicationEventObserver()
    ...
}

Second, subscribe event(s) you want to catch.
For example, you want to catch UIApplicationDidBecomeActive event, check returned value event's type in handler(closure).

func viewDidLoad() {
    super.viewDidLoad()
    appEventObserver.subscribe() { event in
        switch event.type {
        case .DidBecomeActive:
            print(event.type.notificationName)
        default:
            break
        }
    }
}

Also, you can suspend/resume anytime.
If instance's state is suspended, stop observing all events until call resume()
(e.g.)

func showPopup() {
    appEventObserver.suspend()
}
...
func closePopup() {
    appEventObserver.resume()
}

Specs

ApplicationEvent (struct)

ApplicationEvent has two parameters.

type : ApplicationEventType
value : NSNotification instance's userInfo value if the instance has. Provide as AnyObject?

📌Example

Before (Use NSNotificationCenter)

class ViewController: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad()
        NSNotificationCenter.defaultCenter().addObserver(
            self,
            selector: "notified:",
            name: UIApplicationDidBecomeActiveNotification,
            object: nil
        )
        NSNotificationCenter.defaultCenter().addObserver(
            self,
            selector: "notified:",
            name: UIApplicationWillChangeStatusBarFrameNotification,
            object: nil
        )
    }

    deinit {
        NSNotificationCenter.defaultCenter().removeObserver(self)
    }
}

private extension ViewController {
    @objc private func notified(notification: NSNotification) {
        switch notification.name {
        case UIApplicationDidBecomeActiveNotification:
            print(notification.name)
        case UIApplicationWillChangeStatusBarFrameNotification:
            let rect = notification.userInfo?[UIApplicationStatusBarFrameUserInfoKey]
            print(notification.name,rect)
        default:
            break
        }
    }
}

After (Use ApplicationEventObserver)

import UIKit

import ApplicationEventObserver

class ViewController: UIViewController {

    private lazy var appEventObserver = ApplicationEventObserver()

    override func viewDidLoad() {
        super.viewDidLoad()

        appEventObserver.subscribe() { event in
            switch event.type {
            case .DidBecomeActive, .WillResignActive:
                print(event.type.notificationName)
            case .WillChangeStatusBarFrame:
                if let v = event.value {
                    print(event.type.notificationName, v)
                }
            default:
                break
            }
        }

    }

}

So simple !!:star:

Supported Events

Supported events list below:

Notification Name	ApplicationEventType
UIApplicationDidFinishLaunchingNotification	.DidFinishLaunching
UIApplicationWillEnterForegroundNotification	.WillEnterForeground
UIApplicationDidEnterBackgroundNotification	.DidEnterBackground,
UIApplicationWillResignActiveNotification	.WillResignActive,
UIApplicationDidBecomeActiveNotification	.DidBecomeActive,
UIApplicationDidReceiveMemoryWarningNotification	.DidReceiveMemoryWarning,
UIApplicationWillTerminateNotification	.WillTerminate,
UIApplicationSignificantTimeChangeNotification	.SignificantTimeChange,
UIApplicationWillChangeStatusBarOrientationNotification	.WillChangeStatusBarOrientation,
UIApplicationDidChangeStatusBarOrientationNotification	.DidChangeStatusBarOrientation,
UIApplicationWillChangeStatusBarFrameNotification	.WillChangeStatusBarFrame
UIApplicationDidChangeStatusBarFrameNotification	.DidChangeStatusBarFrame
UIApplicationBackgroundRefreshStatusDidChangeNotification	.BackgroundRefreshStatusDidChange

Options

UIApplicationWillChangeStatusBarOrientationNotification
UIApplicationDidChangeStatusBarOrientationNotification
→ You can get orientation value.

UIApplicationWillChangeStatusBarOrientationNotification
UIApplicationDidChangeStatusBarOrientationNotification
→ You can get rect value.

Requirements

iOS 8.0+
Xcode 7.0+(Swift 2+)

Installation and Setup

With Carthage

Just add the following line to your Cartfile:

github "sgr-ksmt/ApplicationEventObserver"

Run carthage update on Terminal.
Add the framework as described. Details: Carthage README

With CocoaPods

Just add the following line to your Podfile:

pod 'ApplicationEventObserver'

Run pod install on Terminal.

samskiter/ApplicationEventObserver