gungun974 / bbportal

A library that will enable you to pass data between your extensions and applications.

BBPortal

Description

BBPortal is a library that will enable you to pass data between your targets and applications (excluding the watch target). It's using App Groups in the background to save data in the shared container and another library - DAFileMonitor - is used to listen to changes on the file. You can create as many portals as you want. You can give your portals different IDs or you can give them all the same ID. When you push data through your portal, all other portals with the same ID will receive the data.

In the example below, you can see two apps controlling each other by passing data in real-time:

You can read more about this library on my blog: http://agostini.tech/2017/08/13/sharing-data-between-applications-and-extensions-using-app-groups/

Usage

var portal: BBPortalProtocol = BBPortal(withGroupIdentifier: "your.group.identifier.goes.here", andPortalID: "id.for.this.portal")

// Send data
portal.send(data: ["key": "What ever data you want"]) { 
    (error) in

    if let anError = error {
        print("Send failed with error: ", anError)
    }
}

// Receive data
portal.onDataAvailable = {
    (data) in

    guard let dict = data as? [String: Any?] else {
        return
    }

    print("I received some data through the portal: ", dict)
}

Installation

BBPortal is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod 'BBPortal'

Author

Dejan Agostini, [email protected] Update by gungun974, [email protected]

License

BBPortal is available under the MIT license. See the LICENSE file for more info.