Latest | 1.11 |
---|---|
Homepage | https://github.com/mluedke2/snowshoe |
License | MIT |
Platforms | ios 6.0, requires ARC |
Dependencies | gtm-oauth |
Authors |
iOS wrapper for SnowShoe
DEPRECATED – Please use SnowShoe-Swift instead.
The SnowShoe Stamp is a 3D-printed authentication tool for smartphones.
Installation with CocoaPods
CocoaPods is a dependency manager for Objective-C, which automates and simplifies the process of using 3rd-party libraries like SnowShoe in your projects. See the CocoaPods guides if this is your first time using it.
Podfile
platform :ios, '7.0'
pod "snowshoe", "~> 1.11"
- Alternatively, you can copy the files from the
SnowShoe
directory into your project. If you do that, be sure to also download and include the files from the gtm-oauth project. This dependency is automatically handled if you go the CocoaPods route.
Usage
Once you have included the dependency, there are 3 steps to use SnowShoe:
-
Subclass
SnowShoeViewController
-
Supply an
appKey
andappSecret
- Handle the Stamp Result in
stampResultDidChange
All of these are done in the Simple Example
project provided.
-
Subclass SnowShoeViewController
Import SnowShoeViewController.h
in a header file for a View Controller:
#import "SnowShoeViewController.h"
And subclass SnowShoeViewController
instead of UIViewController
:
@interface StampViewController : SnowShoeViewController
In the example project provided, this is done in StampViewController.h.
-
Supply an appKey and appSecret
You can obtain these by registering your app on the SnowShoe site.
You can set them at any time. In the example project, this is done in AppDelegate.m.
You could alternatively use viewDidLoad
:
- (void)viewDidLoad
{
[super viewDidLoad];
self.appKey = @"your_app_key";
self.appSecret = @"your_app_secret";
}
-
Handle the Stamp Result in stampResultDidChange
stampResultDidChange
will be called anytime new knowledge about the stamp is found. It will provide an NSString, either showing that the process is waiting or a JSON response from the server.
The provided example StampViewController.m shows how to use the waiting
constant with a UIActivityIndicator
, and how to parse the JSON response from the server.
An example success response:
{"stamp": {"serial": "DEV-STAMP"}, "receipt": "EdKr/rBblHx8ce+9QPZXlyVYvl4=",
"secure": false, "created": "2013-06-19 01:08:38.366249"}
An example failure response:
{"receipt": "iTpXGev3ya2k4UMgO7bc+9o/+mU=", "created": "2013-06-19 01:12:23.481493",
"secure": false, "error": {"message": "Stamp not found", "code": 32}}
Questions?
For hardware or API questions/feedback, address those to SnowShoe directly. For questions/feedback on this library, please file issues or pull requests. Or email me at [email protected], visit my blog, or follow me on Twitter
Latest podspec
{ "name": "snowshoe", "version": "1.11", "license": "MIT", "summary": "3D printed smartphone authentication", "homepage": "https://github.com/mluedke2/snowshoe", "authors": { "Matt Luedke": "[email protected]" }, "source": { "git": "https://github.com/mluedke2/snowshoe.git", "tag": "1.11" }, "requires_arc": true, "platforms": { "ios": "6.0" }, "public_header_files": "SnowShoe/SnowShoeViewController.h", "source_files": "SnowShoe/SnowShoeViewController.{h,m}", "dependencies": { "gtm-oauth": [] } }
Mon, 29 Feb 2016 06:32:03 +0000