由于近段时间项目告一段落啦,所以决定将近段时间接触的一些功能集中整理总结一下,写成了一个简单的Demo,以供参考。此篇文章主要是介绍了第三方登录分享以及指纹识别的配置过程:
一:指纹识别
TouchID指纹识别主要是 iPhone 5s 添加的功能设备,有了这个功能之后,极大的方便了果粉的使用,当然越来越多的应用也开始在应用中集成指纹识别功能。其实官方提供的API中可以看出,�在应用中集成也是比简单的,主要用到的是 LocalAuthentication.framework
这个库,当打开之后可以发现头文件:
LAContext.h
,另外的几个头文件都是一些枚举以及宏定义;下面来看一下暴露出来的几个接口API【常用API】:
# 用来检查当前设备是否可用touchID,返回一个BOOL值
@param policy 是一个枚举类型
第一个枚举LAPolicyDeviceOwnerAuthenticationWithBiometrics就是说,用的是手指指纹去验证的;NS_ENUM_AVAILABLE(NA, 8_0)iOS8 可用
第二个枚举LAPolicyDeviceOwnerAuthentication少了WithBiometrics则是使用TouchID或者密码验证,默认是错误两次指纹或者锁定后,弹出输入密码界面;NS_ENUM_AVAILABLE(10_11, 9_0)iOS 9可用
- (BOOL)canEvaluatePolicy:(LAPolicy)policy error:(NSError * __autoreleasing *)error __attribute__((swift_error(none)));
调用验证方法,注意这里的三个参数:
第一个参数policy是要使用上面那个LAPolicy的枚举
第二个参数localizedReason是NSString类型的验证理由
第三个参数reply则是一个回调Block,block内有一个BOOL类型的success判断是否成功验证,还有一个用于判断错误信息的NSError类型的error
- (void)evaluatePolicy:(LAPolicy)policy
localizedReason:(NSString *)localizedReason
reply:(void(^)(BOOL success, NSError * __nullable error))reply
invalidate方法用来废止这个context
- (void)invalidate NS_AVAILABLE(10_11, 9_0)
以下是提供的几个属性方法
// /返回按钮标题。允许设置密码输入按钮标题。如果设置为空字符串时,按钮会隐藏
@property (nonatomic, nullable, copy) NSString *localizedFallbackTitle;
//取消按钮标题。允许设置取消按钮标题。如果设置为空字符串时,按钮会隐藏NS_AVAILABLE(10_12, 10_0)说明10.0之后才有
@property (nonatomic, nullable, copy) NSString *localizedCancelTitle NS_AVAILABLE(10_12, 10_0);
// 设置最大允许认证失败次数NS_DEPRECATED_IOS(8_3, 9_0),说明这个属性在iOS 8.3被引入,在iOS 9.0被废弃,所以如果系统版本高于9.0是无法使用的。
@property (nonatomic, nullable) NSNumber *maxBiometryFailures NS_DEPRECATED_IOS(8_3, 9_0) __WATCHOS_UNAVAILABLE __TVOS_UNAVAILABLE;
// 这个跟可以检测你的指纹数据库的变化,增加或者删除指纹这个属性会做出相应的反应
@property (nonatomic, nullable, readonly) NSData *evaluatedPolicyDomainState NS_AVAILABLE(10_11, 9_0) __WATCHOS_UNAVAILABLE __TVOS_UNAVAILABLE;
//因为这个属性可以设置一个时间间隔,在时间间隔内是不需要再次录入。默认是0秒,最长可以设置5分钟。
@property (nonatomic) NSTimeInterval touchIDAuthenticationAllowableReuseDuration NS_AVAILABLE(NA, 9_0) __WATCHOS_UNAVAILABLE __TVOS_UNAVAILABLE;
在API中提供的方法属性本来就不多,只要能够理解每个方法和属性的意义,TouchID使用起来就是得心应手的啦,下列是Demo事例中的一个简单应用方法:
/// 检测 指纹
/*
1、 验证(指纹/密码)不能开启的错误信息(指纹系统被判定为无效):
LAErrorPasscodeNotSet : 设备密码未设置
LAErrorTouchIDNotAvailable : TOUCH ID不可用
LAErrorTouchIDNotEnrolled : 指纹未录入
LAErrorTouchIDLockout : TOUCH ID被锁定
LAErrorAppCancel : APP调用了- (void)invalidate
方法使LAContext
失效
LAErrorInvalidContext : 实例化的LAContext
对象失效,再次调用evaluation...
方法则会弹出此错误信息
2、 其他错误信息(指纹系统判定有效,但是验证指纹错误):
LAErrorAuthenticationFailed : 鉴定失败
LAErrorUserCancel : 用户取消
LAErrorUserFallback : 用户选择输入密码
LAErrorSystemCancel : 系统取消(如:另外一个应用进入前台)
*/
/**
* 指纹验证解锁的主要方法
*
* @param localizedFallbackTitle 密码输入按钮标题 例如:定义标题
* @param localizedReason 指纹解锁弹出框副标题 例如:这是副标题
* @param touchBlock 结果回调
*/
-(void)touchIDWithlocalizedFallbackTitle:(NSString *)localizedFallbackTitle localizedReason:(NSString*)localizedReason success:(void(^)(BOOL success, NSString *errorMsg)) touchBlock{
[SVProgressHUD show];
LAContext *context = [[LAContext alloc]init];//使用 new 不会给一些属性初始化赋值
if (!localizedReason) {
localizedReason = @"请验证已有指纹";
}
context.localizedFallbackTitle = localizedFallbackTitle ? : @"密码登录";//@""可以不让 feedBack 按钮显示
NSError * err;
self.canUseTouchId = [context canEvaluatePolicy:LAPolicyDeviceOwnerAuthenticationWithBiometrics error:&err];
// 指纹识别被锁定,需要输入密码验证
if (err.code == LAErrorTouchIDLockout) {
[SVProgressHUD dismiss];
if (touchBlock) {
touchBlock(NO,@"Touch ID被锁,需要用户输入密码解锁");
}
return;
}
if (self.canUseTouchId) {// 检测手机是否可以使用TouchId
//LAPolicyDeviceOwnerAuthenticationWithBiometrics
[context evaluatePolicy:LAPolicyDeviceOwnerAuthenticationWithBiometrics localizedReason:localizedReason reply:^(BOOL success, NSError * _Nullable error) {
[SVProgressHUD dismiss];
//SVProgressHUD dismiss 需要 0.15才会消失;所以dismiss 后进行下一步操作;但是0.3是适当延长时间;留点余量
dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(0.3* NSEC_PER_SEC)), dispatch_get_main_queue(), ^{
self.completeMsg = nil;
if (success){
NSLog(@"指纹识别成功");
// 指纹识别成功,回主线程更新UI
dispatch_async(dispatch_get_main_queue(), ^{
//成功操作
self.completeMsg = @"指纹识别成功";
if (touchBlock) {
touchBlock(success,self.completeMsg);
}
});
}
if (error) {
//指纹识别失败,回主线程更新UI
dispatch_async(dispatch_get_main_queue(), ^{
//失败操作
LAError errorCode = error.code;
switch (errorCode) {
case LAErrorAuthenticationFailed:
{
NSLog(@"授权失败"); // -1 连续三次指纹识别错误
self.completeMsg = @"授权失败";
}
break;
case LAErrorUserCancel: // Authentication was canceled by user (e.g. tapped Cancel button)
{
NSLog(@"用户取消验证Touch ID"); // -2 在TouchID对话框中点击了取消按钮
self.completeMsg = @"用户取消验证Touch ID";
}
break;
case LAErrorUserFallback: // Authentication was canceled, because the user tapped the fallback button (Enter Password)
{
NSLog(@"用户选择输入密码,切换主线程处理"); // -3 在TouchID对话框中点击了输入密码按钮
self.completeMsg = @"用户选择输入密码,切换主线程处理";
}
break;
case LAErrorSystemCancel: // Authentication was canceled by system (e.g. another application went to foreground)
{
NSLog(@"取消授权,如其他应用切入"); // -4 TouchID对话框被系统取消,例如按下Home或者电源键
self.completeMsg = @"取消授权,如其他应用切入";
}
break;
case LAErrorPasscodeNotSet: // Authentication could not start, because passcode is not set on the device.
{
NSLog(@"设备系统未设置密码"); // -5
self.completeMsg = @"设备系统未设置密码";
}
break;
case LAErrorTouchIDNotAvailable: // Authentication could not start, because Touch ID is not available on the device
{
NSLog(@"设备未设置Touch ID"); // -6
self.completeMsg = @"设备未设置Touch ID";
}
break;
case LAErrorTouchIDNotEnrolled: // Authentication could not start, because Touch ID has no enrolled fingers
{
NSLog(@"用户未录入指纹"); // -7
self.completeMsg = @"用户未录入指纹";
}
break;
case LAErrorTouchIDLockout: //Authentication was not successful, because there were too many failed Touch ID attempts and Touch ID is now locked. Passcode is required to unlock Touch ID, e.g. evaluating LAPolicyDeviceOwnerAuthenticationWithBiometrics will ask for passcode as a prerequisite 用户连续多次进行Touch ID验证失败,Touch ID被锁,需要用户输入密码解锁,先Touch ID验证密码
{
NSLog(@"Touch ID被锁,需要用户输入密码解锁"); // -8 连续五次指纹识别错误,TouchID功能被锁定,下一次需要输入系统密码
self.completeMsg = @"Touch ID被锁,需要用户输入密码解锁";
}
break;
case LAErrorAppCancel: // Authentication was canceled by application (e.g. invalidate was called while authentication was in progress) 如突然来了电话,电话应用进入前台,APP被挂起啦");
{
NSLog(@"用户不能控制情况下APP被挂起"); // -9
self.completeMsg = @"用户不能控制情况下APP被挂起";
}
break;
case LAErrorInvalidContext: // LAContext passed to this call has been previously invalidated.
{
NSLog(@"LAContext传递给这个调用之前已经失效"); // -10
self.completeMsg = @"指纹识别失效";
}
break;
}
if (touchBlock) {
touchBlock(success,self.completeMsg);
}
});
}
});
}];
}else{
[SVProgressHUD dismiss];
if (touchBlock) {
touchBlock(NO,[NSString stringWithFormat:@"设备不支持指纹解锁-- %@",err.localizedFailureReason ? : @""]);
}
}
}
效果图如下:
TouchID的简单集成使用功能就是这样,如果想要了解更详细的内容,可以具体参考苹果官方文档:
lacontext官方文档
https://developer.apple.com/reference/localauthentication/lacontext
TouchID官方文档:
https://developer.apple.com/reference/localauthentication/lacontext