DBGuestureLock 中文

DBGuestureLock is an iOS drop-in class which is very easy to use. I am welcome you to make any additional useful features to DBGuestureLock to make it better. If you want to make a contribution to this project, just make a pull request. If you like this project, make a star!

NO.1 Requirements

DBGuestureLock is build under iOS SDK9.2 with Xcode7.2.1(7C1002) and pass test on travis-ci with Xcode7 and iOS SDK9.0. You should use DBGuestureLock under ARC.

• UIKit.framework

NO.2 Adding DBGuestureLock to your project

Cocoapods

CocoaPods is the recommended way to add DBGuestureLock to your project.

1. Add a pod entry for DBGuestureLock to your Podfile pod 'DBGuestureLock', '~> 0.0.2'
2. Install the pod(s) by running pod install.
3. Include DBGuestureLock wherever you need it with #import "DBGuestureLock.h".

Open your project with Xcode using your_project_name.xcworkspace instead.

Source files

Just add the DBGuestureButton.h, DBGuestureButton.m,DBGuestureLock.h, DBGuestureLock.m source files to your project directly.

1. Download the latest code version or add the repository as a git submodule to your git-tracked project.
2. Open your project in Xcode, then drag and drop the 4 source files onto your project (use the "Product Navigator view"). Make sure to select Copy items when asked if you extracted the code archive outside of your project.
3. Include DBGuestureLock in your ViewController where you want to add the guesture lock with #import "DBGuestureLock.h".

NO.3 Usage

There are two ways to use DBGuestureLock, work with delegate and work with block.

Work with block

The most easy way to use, just import the DBGuestureLock.h and type in two statements of code:

#import "DBGuestureLock.h"

Create a GuestureLock object in viewDidLoad and add it as the subview of current view:

- (void)viewDidLoad {
    [super viewDidLoad];

    [DBGuestureLock clearGuestureLockPassword]; //just for test
    
	DBGuestureLock *lock = [DBGuestureLock lockOnView:self.view offsetFromBottom:60.f onPasswordSet:^(DBGuestureLock *lock, NSString *password) {
        if (lock.firstTimeSetupPassword == nil) {
            lock.firstTimeSetupPassword = password;
            NSLog(@"varify your password");
            self.label.text = @"Enter your password again:";
        }
    } onGetCorrectPswd:^(DBGuestureLock *lock, NSString *password) {
        if (lock.firstTimeSetupPassword && ![lock.firstTimeSetupPassword isEqualToString:DBFirstTimeSetupPassword]) {
            lock.firstTimeSetupPassword = DBFirstTimeSetupPassword;
            NSLog(@"password has been setup!");
            self.label.text = @"password has been setup!";
        } else {
            NSLog(@"login success");
            self.label.text = @"login success!";
        }
    } onGetIncorrectPswd:^(DBGuestureLock *lock, NSString *password) {
        if (![lock.firstTimeSetupPassword isEqualToString:DBFirstTimeSetupPassword]) {
            NSLog(@"Error: password not equal to first setup!");
            self.label.text = @"Not equal to first setup!";
        } else {
            NSLog(@"login failed");
            self.label.text = @"login failed!";
        }
    }];
    [self.view addSubview:lock];
    [self.view setBackgroundColor:[UIColor colorWithRed:0.133 green:0.596 blue:0.933 alpha:1.00]];
}

Call the following method to set lock themes for three Button state if you need:

-(void)setupLockThemeWithLineColor:(UIColor*)lineColor lineWidth:(CGFloat)lineWidth  strokeColor:(UIColor*)strokeColor strokeWidth:(CGFloat)strokeWidth circleRadius:(CGFloat)circleRadius fillColor:(UIColor*)fillColor showCenterPoint:(BOOL)showCenterPoint centerPointColor:(UIColor*)centerPointColor centerPointRadius:(CGFloat)centerPointRadius fillCenterPoint:(BOOL)fillCenterPoint onState:(DBButtonState)buttonState;

Work with delegate

Import the DBGuestureLock.h in your ViewController and make your ViewController conforms to DBGuestureLockDelegate delegate:

#import "DBGuestureLock.h"

@interface ViewController ()<DBGuestureLockDelegate>

Create a GuestureLock object and add it to your view in viewDidLoad method:

- (void)viewDidLoad {
    [super viewDidLoad];

    [DBGuestureLock clearGuestureLockPassword]; //just for test
    
    DBGuestureLock *lock = [DBGuestureLock lockOnView:self.view offsetFromBottom:60.f delegate:self];
    [self.view addSubview:lock];
    [self.view setBackgroundColor:[UIColor colorWithRed:0.133 green:0.596 blue:0.933 alpha:1.00]];
}

Implement the 3 require delegate methods:

-(void)guestureLock:(DBGuestureLock *)lock didSetPassword:(NSString *)password {
    // test
    if (lock.firstTimeSetupPassword == nil) {
        lock.firstTimeSetupPassword = password;
        NSLog(@"varify your password");
        self.label.text = @"Enter your password again:";
    }
}

-(void)guestureLock:(DBGuestureLock *)lock didGetCorrectPswd:(NSString *)password {
    // test
    if (lock.firstTimeSetupPassword && ![lock.firstTimeSetupPassword isEqualToString:DBFirstTimeSetupPassword]) {
        lock.firstTimeSetupPassword = DBFirstTimeSetupPassword;
        NSLog(@"password has been setup!");
        self.label.text = @"password has been setup!";
    } else {
        NSLog(@"login success");
        self.label.text = @"login success!";
    }
}

-(void)guestureLock:(DBGuestureLock *)lock didGetIncorrectPswd:(NSString *)password {
    // test
    if (![lock.firstTimeSetupPassword isEqualToString:DBFirstTimeSetupPassword]) {
        NSLog(@"Error: password not equal to first setup!");
        self.label.text = @"Not equal to first setup!";
    } else {
        NSLog(@"login failed");
        self.label.text = @"login failed!";
    }
}

Some other optional delegate methods allow you to change the style of the lock:

-(BOOL)showButtonCircleCenterPointOnState:(DBButtonState)buttonState;
-(BOOL)fillButtonCircleCenterPointOnState:(DBButtonState)buttonState;//NO for stroke, YES for fill
-(CGFloat)widthOfButtonCircleStrokeOnState:(DBButtonState)buttonState;
-(CGFloat)radiusOfButtonCircleCenterPointOnState:(DBButtonState)buttonState;
-(CGFloat)lineWidthOfGuestureOnState:(DBButtonState)buttonState;
-(UIColor *)colorOfButtonCircleStrokeOnState:(DBButtonState)buttonState;
-(UIColor *)colorForFillingButtonCircleOnState:(DBButtonState)buttonState;
-(UIColor *)colorOfButtonCircleCenterPointOnState:(DBButtonState)buttonState;
-(UIColor *)lineColorOfGuestureOnState:(DBButtonState)buttonState;

Other methods and properties

DBButtonState include:

DBButtonStateNormal     //Normal state button
DBButtonStateSelected   //when button is selected
DBButtonStateIncorrect  //when password is incorrect

Other class methods/property allow you to operate with the password (password is saved in UserDefaults):

+(BOOL)passwordSetupStatus;
+(void)clearGuestureLockPassword;
+(NSString *)getGuestureLockPassword;
@property (nonatomic, readonly, assign)BOOL isPasswordSetup;

NO.4 License

This code is distributed under the terms and conditions of the MIT license.

NO.5 Version update Log

1. 2016/02/28: V0.0.1 First commit. CocoaPods compatable. Finish user guides. Work with delegate.
2. 2016/02/29: V0.0.2 Update and make it work with block. Two ways of usage can be chiose(Block/Delegate).