BLOCKv SDK for iOS

This is the official BLOCKv SDK. It allows you to easily build your own vAtom Viewer app, or integrate your own apps into the BLOCKv platform.

Requirements

• iOS 10.0+
• Xcode 10.1+
• Swift 4.1+

Installation

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

pod 'BLOCKv'

Configuration

Within the AppDelegate be sure to set the App ID.

class AppDelegate: UIResponder, UIApplicationDelegate {

    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
    
        // Set app id
        BLOCKv.configure(appID: "your-app-id")
        
        // Check logged in state
        if BLOCKv.isLoggedIn {
            // show interesting ui
        } else {
            // show authentication ui
        }
        
        // Handle user re-authentication
        BLOCKv.onLogout = {
            // show authentication ui
        }
        
        return true
    }
}

Sample App

The sample app lets you try out the BLOCKv SDK. It's a great place to start if you're getting up to speed on the platform. It offers the following features:

• Authentication (registration & login)
• Profile management
• Fetching the user's inventory of vAtoms
• Fetching individual vAtoms
• Searching for vAtoms on the BLOCKv platform
• Responding to Web socket events
• Dispalying vAtoms in a UICollectionView
• Visually representing vAtoms using faces (new)

To run the example project, clone the repo, and run pod install from the Example directory first.

Design

The SDK has two logical modules: Core and Face. The responsibilites are as follows:

Core

• API integration
• User token management
• Web socket integration

Face

• Face view infrastructure
• Embedded face views e.g. ImageFaceView
• Convenience classes to assist in displaying vAtoms e.g. VatomView

Versioning

This SDK adheres to semantic versioning.

Security Disclosure

If you believe you have identified a security vulnerability with BLOCKv, you should report it as soon as possible via email to [email protected]. Please do not post it to a public issue tracker.

Author

BLOCKv

License

BLOCKv is available under the BLOCKv AG license. See the LICENSE file for more info.