Protein 1.1

You want to add pod 'Protein', '~> 1.1' similar to the following to your Podfile:

target 'MyApp' do
  pod 'Protein', '~> 1.1'
end

Then run a pod install inside your terminal, or from CocoaPods.app.

Alternatively to give it a test run, run the command:

pod try Protein

Protein 1.1

By
Igor Matyushkin
igormatyushkin1

The main purpose of Protein framework is to simplify work with 3D touch in iOS. Protein is compatible with iOS 8.

How To Get Started

Copy content of Source folder to your project.

Use Protein cocoapod

Requirements

iOS 8 and later
Xcode 7 and later

Usage

Shortcuts

To use Protein for managing shortcut items, you need to add list of items to Info.plist file in your project. Example:

In this example, we will use two shortcut items. One will launch app with blue screen, and other one with orange screen.

When you have described structure in Info.plist file, you need to register those items in Protein engine. For this purpose, subclass your AppDelegate from PTAppDelegate class.

@UIApplicationMain
class AppDelegate: PTAppDelegate {

    var window: UIWindow?

    var mainViewController: UIViewController?

    func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool {
        // Register shortcut items

        registerShortcutItemType("blue-screen") { (shortcutItem) -> Void in
            self.mainViewController?.view.backgroundColor = .cyanColor()
        }

        registerShortcutItemType("orange-screen") { (shortcutItem) -> Void in
            self.mainViewController?.view.backgroundColor = .orangeColor()
        }


        // Create window

        let frameForWindow = UIScreen.mainScreen().bounds

        window = UIWindow(frame: frameForWindow)
        window!.backgroundColor = .whiteColor()
        window!.makeKeyAndVisible()


        // Switch to view controller

        mainViewController = UIViewController()

        let navigationController = UINavigationController(rootViewController: mainViewController!)
        navigationController.navigationBarHidden = true

        window!.rootViewController = navigationController


        // Return result

        return true
    }
}

PTAppDelegate contains method named registerShortcutItemType(_:, _:). This method registers handler block for particular type of shortcut item. This block will be called when user tapped shortcut item.

Note: if your project supports iOS 8, you need to wrap calls for registerShortcutItemType(_:, _:) into special condition:

if #available(iOS 9, *) {
    registerShortcutItemType("blue-screen") { (shortcutItem) -> Void in
        self.mainViewController?.view.backgroundColor = .cyanColor()
    }

    registerShortcutItemType("orange-screen") { (shortcutItem) -> Void in
        self.mainViewController?.view.backgroundColor = .orangeColor()
    }
}

Also, for completeness, PTAppDelegate provides developer with unregisterShortcutItemType(_:) method. But, usually, there's no reason to call this method.

License

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