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)

Authentication (registration & login) Profile management

Profile management Fetching the user's inventory of vAtoms

Fetching the user's inventory of vAtoms Fetching individual vAtoms

Fetching individual vAtoms Searching for vAtoms on the BLOCKv platform

Searching for vAtoms on the BLOCKv platform Responding to Web socket events

Responding to Web socket events Dispalying vAtoms in a UICollectionView

Dispalying vAtoms in a 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.