Latest 1.0
Homepage https://github.com/macoscope/NotificationController
License MIT
Platforms ios 7.0, osx 10.9, requires ARC
Authors

Build Status
Carthage compatible

NotificationController provides a better way to use NSNotificationCenter on iOS and Mac.

Features:

  • compile-time warnings for retain-cycles in the block-based API
  • prevention from registration for the same notification more than once
  • automatic unregistration from notifications in -dealloc

We encourage you to learn about the underlying implementation from the blog post.

Usage

Fully working example is as simple as:

__weak typeof(self) weakSelf = self;

self.notificationController = [[MCSNotificationController alloc] initWithObserver:self];
[self.notificationController addObserverForName:MCSNotification sender:nil queue:nil usingBlock:^(NSNotification *note) {
    [weakSelf doSomething];
}];

or

self.notificationController = MCSNotificationController(observer: self)
self.notificationController?.addObserverForName(name, sender: nil, queue: nil, usingBlock: {  [weak self] (_) -> Void in
    self.doSomething()
})

Above examples assume that there’s a strongly held notificationController property on that object.
Deregistration happens automatically on the controller’s deallocation.

There’s also a category on NSObject that creates a lazy-loaded mcs_notificationController property for you. So, Objective-C example can get even shorter:

__weak typeof(self) weakSelf = self;

[self.mcs_notificationController addObserverForName:MCSNotification sender:nil queue:nil usingBlock:^(NSNotification *note) {
    [weakSelf doSomething];
}];

That’s all you have to do to safely use notifications with blocks. You should also see an example app and comments in the header.

Requirements

  • iOS 7 and above
  • OS X 10.9 and above

Installation

Install with Carthage:

github "macoscope/NotificationController"

or with CocoaPods:

pod "NotificationController"

Then import with: #import <NotificationController/MCSNotificationController.h>

Copyright

Published under the MIT License.
Copyright (c) 2015 Macoscope sp. z o.o.

Latest podspec

{
    "name": "NotificationController",
    "version": "1.0",
    "summary": "A safer and easier way to use NSNotificationCenter with blocks.",
    "homepage": "https://github.com/macoscope/NotificationController",
    "license": "MIT",
    "authors": {
        "Arkadiusz Holko": "[email protected]"
    },
    "social_media_url": "https://twitter.com/arekholko",
    "source": {
        "git": "https://github.com/macoscope/NotificationController.git",
        "tag": "1.0"
    },
    "platforms": {
        "ios": "7.0",
        "osx": "10.9"
    },
    "requires_arc": true,
    "source_files": [
        "MCSNotificationController/*.{h,m}",
        "MCSNotificationController/**/*.{h,m}"
    ],
    "public_header_files": "MCSNotificationController/*.h"
}

Pin It on Pinterest

Share This