最近公司的 app 要使用指紋支付了;總體來說還是蠻順利的;但是中間有遇到一些坑;下面就對坑進行彙總;

一.基本知識

點開這個LocalAuthentication.framework，發現裏面主要有這麼幾個東西

LocalAuthentication.framework

- LAContext.h
- LAError.h
- LAPublicDefines.h
- LocalAuthentication.h

LocalAuthentication.h

這個沒什麼可講的吧，代碼就兩行，一行導入LAContext.h,一行導入LAError.h，這個LocalAuthentication類是暴露出來方便開發者調用的類。

LAPublicDefines.h

先從簡單的開始講吧，首先是LAPublicDefines.h，從名字上來看是公共宏定義類，裏面包含了許多定義好的宏，這些宏會在LAContext.h
得到使用。

//
//  LAPublicDefines.h
//  LocalAuthentication
//
//  Copyright (c) 2014 Apple. All rights reserved.
//

#ifndef LocalAuthentication_LAPublicDefines_h
#define LocalAuthentication_LAPublicDefines_h

// Policies
#define kLAPolicyDeviceOwnerAuthenticationWithBiometrics    1
#define kLAPolicyDeviceOwnerAuthentication                  2

// Options
#define kLAOptionUserFallback                               1
#define kLAOptionAuthenticationReason                       2

// Credential types
#define kLACredentialTypePasscode                          -1
#define kLACredentialTypePassphrase                        -2
#define kLACredentialCTKPIN                                -3

// Error codes
#define kLAErrorAuthenticationFailed                       -1
#define kLAErrorUserCancel                                 -2
#define kLAErrorUserFallback                               -3
#define kLAErrorSystemCancel                               -4
#define kLAErrorPasscodeNotSet                             -5
#define kLAErrorTouchIDNotAvailable                        -6
#define kLAErrorTouchIDNotEnrolled                         -7
#define kLAErrorTouchIDLockout                             -8
#define kLAErrorAppCancel                                  -9
#define kLAErrorInvalidContext                            -10

// Error domain
#define kLAErrorDomain        "com.apple.LocalAuthentication"

#endif

LAError.h

這個類其實也不用贅述，就是一個枚舉，裏面寫的是錯誤的類型，其實就是把上面的kLAError宏寫進這個枚舉了，具體代碼註釋寫的很清晰，大概翻譯了一下

typedef NS_ENUM(NSInteger, LAError)
{
    LAErrorAuthenticationFailed,     // 驗證信息出錯，就是說你指紋不對
    LAErrorUserCancel               // 用戶取消了驗證
    LAErrorUserFallback             // 用戶點擊了手動輸入密碼的按鈕，所以被取消了
    LAErrorSystemCancel             // 被系統取消，就是說你現在進入別的應用了，不在剛剛那個頁面，所以沒法驗證
    LAErrorPasscodeNotSet           // 用戶沒有設置TouchID
    LAErrorTouchIDNotAvailable      // 用戶設備不支持TouchID
    LAErrorTouchIDNotEnrolled       // 用戶沒有設置手指指紋
    LAErrorTouchIDLockout           // 用戶錯誤次數太多，現在被鎖住了
    LAErrorAppCancel                // 在驗證中被其他app中斷
    LAErrorInvalidContext           // 請求驗證出錯
} NS_ENUM_AVAILABLE(10_10, 8_0);

LAContext.h

重頭戲來了，想在自己的項目中使用TouchID，就要用到LAContext這個類裏面的方法首先映入眼簾的是一個NS_ENUM枚舉LAPolicy。

typedef NS_ENUM(NSInteger, LAPolicy)
{
    LAPolicyDeviceOwnerAuthenticationWithBiometrics NS_ENUM_AVAILABLE(NA, 8_0) __WATCHOS_AVAILABLE(3.0) __TVOS_AVAILABLE(10.0) = kLAPolicyDeviceOwnerAuthenticationWithBiometrics,
    LAPolicyDeviceOwnerAuthentication NS_ENUM_AVAILABLE(10_11, 9_0) = kLAPolicyDeviceOwnerAuthentication

} NS_ENUM_AVAILABLE(10_10, 8_0) __WATCHOS_AVAILABLE(3.0) __TVOS_AVAILABLE(10.0);

第一個枚舉LAPolicyDeviceOwnerAuthenticationWithBiometrics就是說，用的是手指指紋去驗證的；NS_ENUM_AVAILABLE(NA, 8_0)iOS8 可用
第二個枚舉LAPolicyDeviceOwnerAuthentication少了WithBiometrics則是使用TouchID或者密碼驗證,默認是錯誤兩次指紋或者鎖定後,彈出輸入密碼界面;NS_ENUM_AVAILABLE(10_11, 9_0)iOS 9可用

首先暴露出來的幾個方法，注意這裏都是實例方法，所以需要創建一個實例對象去才能調用，使用LAContext *context = [LAContext alloc] init];創建一個LAContext對象。

canEvaluatePolicy:error:方法用來檢查當前設備是否可用touchID，返回一個BOOL值
evaluatePolicy:localizedReason:reply:調用驗證方法，注意這裏的三個參數：
第一個參數policy是要使用上面那個LAPolicy的枚舉
第二個參數localizedReason是NSString類型的驗證理由
第三個參數reply則是一個回調Block，block內有一個BOOL類型的success判斷是否成功驗證，還有一個用於判斷錯誤信息的NSError類型的error
invalidate方法用來廢止這個context

第一次touchID 樣式

錯誤後 touchID 樣式

- (BOOL)canEvaluatePolicy:(LAPolicy)policy error:(NSError * __autoreleasing *)error __attribute__((swift_error(none)));

- (void)evaluatePolicy:(LAPolicy)policy
       localizedReason:(NSString *)localizedReason
                 reply:(void(^)(BOOL success, NSError * __nullable error))reply;

- (void)invalidate;

枚舉LACredentialType,LAAccessControlOperation，這個東西和下面的幾個方法我查了很久也沒弄明白用在哪，蘋果官方文檔也看的不太懂，枚舉中只有一個LACredentialTypeApplicationPassword。
不過通過這個NS_ENUM_AVAILABLE(10_11, 9_0)還有方法後面的NS_AVAILABLE(10_11, 9_0)知道這個枚舉和這兩個方法只能在OS X 10.11和iOS 9.0以上版本使用，所以可能是比較新的東西，後面蘋果還會對他擴充吧。
下面是方法的說明:

  // 目前額外加密就一種就是應用密碼
  // 輸入進去將會是 UTF-8 的字符串
  typedef NS_ENUM(NSInteger, LACredentialType)
  {
      LACredentialTypeApplicationPassword = 0,
  } NS_ENUM_AVAILABLE(10_11, 9_0);

// 以下方法據我理解應該是：可以在驗證Touch ID之後額外加密?
  // 設置解鎖額外加密憑證
  - (BOOL)setCredential:(nullable NSData *)credential
          type:(LACredentialType)type NS_AVAILABLE(10_11, 9_0);
  // 判斷加密憑證是否設置成功
  - (BOOL)isCredentialSet:(LACredentialType)type NS_AVAILABLE(10_11, 9_0);
  // 通過Touch ID來驗證加密憑證是否通過
  - (void)evaluateAccessControl:(SecAccessControlRef)accessControl
              operation:(LAAccessControlOperation)operation
        localizedReason:(NSString *)localizedReason
                  reply:(void(^)(BOOL success, NSError * __nullable error))reply
                  NS_AVAILABLE(10_11, 9_0);

  typedef NS_ENUM(NSInteger, LAAccessControlOperation)
  {
      // 創建額外加密
      LAAccessControlOperationCreateItem,
      // 使用額外加密
      LAAccessControlOperationUseItem,
      // 創建額外加密key
      LAAccessControlOperationCreateKey,
      // 使用額外加密key簽名
      LAAccessControlOperationUseKeySign
  } NS_ENUM_AVAILABLE(10_11, 9_0);

屬性的話，這裏有5個

@property (nonatomic, nullable, copy) NSString *localizedFallbackTitle;

@property (nonatomic, nullable, copy) NSString *localizedCancelTitle NS_AVAILABLE(10_12, 10_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;

@property (nonatomic) NSTimeInterval touchIDAuthenticationAllowableReuseDuration NS_AVAILABLE(NA, 9_0) __WATCHOS_UNAVAILABLE __TVOS_UNAVAILABLE;

localizedFallbackTitle可以設置驗證TouchID時彈出Alert的輸入密碼按鈕的標題
localizedCancelTitle可以設置驗證TouchID時彈出Alert的取消按鈕的標題(iOS10纔有)
maxBiometryFailures 最大指紋嘗試錯誤次數。這個屬性我們可以看到他後面寫了NS_DEPRECATED_IOS(8_3, 9_0)，說明這個屬性在iOS 8.3被引入，在iOS 9.0被廢棄，所以如果系統版本高於9.0是無法使用的。
evalueatedPolicyDomainState這個跟可以檢測你的指紋數據庫的變化,增加或者刪除指紋這個屬性會做出相應的反應
touchIDAuthenticationAllowableReuseDuration這個屬性應該是類似於支付寶的指紋開啓應用，如果你打開他解鎖之後，按Home鍵返回桌面，再次進入支付寶是不需要錄入指紋的。因爲這個屬性可以設置一個時間間隔，在時間間隔內是不需要再次錄入。默認是0秒，最長可以設置5分鐘。

二.常見問題

1. 指紋識別的版本問題

iOS 9 之前是沒有LAErrorTouchIDLockout鎖定這個選項的,默認錯誤5次後;第6次驗證是自動彈出輸入密碼界面;
iOS 9 之後鎖定指紋識別之後,如果需要立即彈出輸入密碼界面需要使用LAPolicyDeviceOwnerAuthentication這個屬性重新發起驗證
如果輸入了鎖屏密碼,指紋解密鎖定會默認解除

iOS 8 錯誤5次鎖定後,第6次驗證需要密碼

支付寶微信對於鎖定的不同處理

2. 指紋識別的LAPolicy

第一個枚舉LAPolicyDeviceOwnerAuthenticationWithBiometrics就是說，用的是手指指紋去驗證的；NS_ENUM_AVAILABLE(NA, 8_0)iOS8 可用
第二個枚舉LAPolicyDeviceOwnerAuthentication少了WithBiometrics則是使用TouchID或者密碼驗證,默認是錯誤兩次指紋或者鎖定後,彈出輸入密碼界面;NS_ENUM_AVAILABLE(10_11, 9_0)
iOS 9可用

3. 指紋識別LAContext的方法

canEvaluatePolicy:error:方法用來檢查當前設備是否可用touchID，返回一個BOOL值;不會彈驗證指紋密碼框
evaluatePolicy:localizedReason:reply:調用驗證方法，會彈驗證指紋密碼框

4. feedback按鈕顯示

默認第一次識別只有取消按鈕
錯誤一次之後,會顯示 feedBack 按鈕
如果不想顯示 feedback 按鈕;可以設置 feedBackTitle = @""

設置 feedbackTitle 爲@""

設置 feedbackTitle 爲@"驗證登錄密碼"

5. CancelTitle按鈕顯示

該屬性, iOS 10 纔可以進行設置,iOS 以前是不可以進行設置的

6. 指紋識別慢的問題

我的 iphone 7 Plus指紋識別啓動過程需要2s 左右的時間;如果發現啓動比較慢,這個是正常現象
支付寶和微信爲了消除用戶的緊張情緒,在開啓指紋識別的時候都有放 HUD
指紋識別完成後,需要返回主線程進行相應的操作;否者你會發現有時候識別完4-5秒纔有反應

微信支付 HUD顯示案例

demo的 HUD顯示案例

    [SVProgressHUD show];

    LAContext *context = [[LAContext alloc]init];//使用 new 不會給一些屬性初始化賦值

    context.localizedFallbackTitle = @"輸入密碼";//@""可以不讓 feedBack 按鈕顯示
    //LAPolicyDeviceOwnerAuthenticationWithBiometrics
    [context evaluatePolicy:LAPolicyDeviceOwnerAuthenticationWithBiometrics 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(), ^{

            if (success)
            {
                NSLog(@"指紋識別成功");
                // 指紋識別成功，回主線程更新UI
                dispatch_async(dispatch_get_main_queue(), ^{
                    //成功操作
                });
            }

            if (error) {
                //指紋識別失敗，回主線程更新UI
                dispatch_async(dispatch_get_main_queue(), ^{
                    //失敗操作
                    LAError errorCode = error.code;
                    switch (errorCode) {

                        case LAErrorAuthenticationFailed:
                        {
                            NSLog(@"授權失敗"); // -1 連續三次指紋識別錯誤
                        }
                            break;
                        case LAErrorUserCancel: // Authentication was canceled by user (e.g. tapped Cancel button)
                        {
                            NSLog(@"用戶取消驗證Touch ID"); // -2 在TouchID對話框中點擊了取消按鈕
                        }
                            break;
                        case LAErrorUserFallback: // Authentication was canceled, because the user tapped the fallback button (Enter Password)
                        {
                            NSLog(@"用戶選擇輸入密碼，切換主線程處理"); // -3 在TouchID對話框中點擊了輸入密碼按鈕
                        }
                            break;
                        case LAErrorSystemCancel: // Authentication was canceled by system (e.g. another application went to foreground)
                        {
                            NSLog(@"取消授權，如其他應用切入"); // -4 TouchID對話框被系統取消，例如按下Home或者電源鍵
                        }
                            break;
                        case LAErrorPasscodeNotSet: // Authentication could not start, because passcode is not set on the device.

                        {
                            NSLog(@"設備系統未設置密碼"); // -5
                        }
                            break;
                        case LAErrorTouchIDNotAvailable: // Authentication could not start, because Touch ID is not available on the device
                        {
                            NSLog(@"設備未設置Touch ID"); // -6
                        }
                            break;
                        case LAErrorTouchIDNotEnrolled: // Authentication could not start, because Touch ID has no enrolled fingers
                        {
                            NSLog(@"用戶未錄入指紋"); // -7
                        }
                            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功能被鎖定，下一次需要輸入系統密碼
                        }
                            break;
                        case LAErrorAppCancel: // Authentication was canceled by application (e.g. invalidate was called while authentication was in progress) 如突然來了電話，電話應用進入前臺，APP被掛起啦");
                        {
                            NSLog(@"用戶不能控制情況下APP被掛起"); // -9
                        }
                            break;
                        case LAErrorInvalidContext: // LAContext passed to this call has been previously invalidated.
                        {
                            NSLog(@"LAContext傳遞給這個調用之前已經失效"); // -10
                        }
                            break;
                    }

                });
            }
        });
    }];

7.彈窗顯示級別問題

指紋識別的彈窗的級別非常之高，高到離譜，經過驗證應用程序內部沒有比指紋識別的window的級別更高的UIWindowLevel，也就說了他是系統級的彈窗。需要注意的是，如果指紋彈窗顯示和消失應用程序會調用：

  - (void)applicationWillResignActive:(UIApplication *)application;
  - (void)applicationDidBecomeActive:(UIApplication *)application;

所以應用程序內部無法獲取。不知道越獄之後的手機能否獲取到，如果能獲取到，那就不可描述了，所以推薦各位看官沒什麼剛需不要越獄。

8.檢測指紋庫中指紋是否發生改變

蘋果官方文檔解釋如下

This property returns a value only when the canEvaluatePolicy(:error:) method succeeds for a biometric policy or the evaluatePolicy(:localizedReason:reply:) method is called and a successful Touch ID authentication is performed. Otherwise, nil is returned.
The returned data is an opaque structure. It can be used to compare with other values returned by this property to determine whether the database of authorized fingerprints has been updated. However, the nature of the change cannot be determined from this data.

總結來說:

當你增加或者刪除指紋時候,你在使用使用canEvaluatePolicy(_:error:)或者evaluatePolicy(_:localizedReason:reply:)方法驗證;成功後evaluatedPolicyDomainState屬性會返回一個 NSData 對象;否則返回 nil;
但是返回的evaluatedPolicyDomainState屬性並不能說明發生了什麼樣子的改變;只是告訴你發生了改變

根據上面的信息,我們就可以每次使用指紋的時候檢測指紋數據庫是否發生改變並作出相應的操作;下面是stackOverFlow 做的一個相應示例

evaluatedPolicyDomainState使用示例

9.支持機型判斷

從設備和系統判斷是否是支持TouchID，有點取巧
.h 文件

//
//  NSString+QDTouchID.h
//  Ewallet
//
//  Created by 陳博文 on 16/10/25.
//  Copyright © 2016年 UCSMY. All rights reserved.
//

#import <Foundation/Foundation.h>

@interface NSString (QDTouchID)
+ (BOOL)judueIPhonePlatformSupportTouchID;
@end

. m 文件

//
//  NSString+QDTouchID.m
//  Ewallet
//
//  Created by 陳博文 on 16/10/25.
//  Copyright © 2016年 UCSMY. All rights reserved.
//

#import "NSString+QDTouchID.h"
#include <sys/sysctl.h>

#define IOS8_OR_LATER    ( [[[UIDevice currentDevice] systemVersion] compare:@"8.0"] != NSOrderedAscending )
#define IS_Phone UI_USER_INTERFACE_IDIOM()==UIUserInterfaceIdiomPhone

@implementation NSString (QDTouchID)

//是否是iOS8.0以上的系統

//是否是5s以上的設備支持
+ (NSString *)platform
{
    size_t size;
    sysctlbyname("hw.machine", NULL, &size, NULL, 0);
    char *machine = malloc(size);
    sysctlbyname("hw.machine", machine, &size, NULL, 0);
    NSString *platform = [NSString stringWithCString:machine encoding:NSUTF8StringEncoding];
    free(machine);
    return platform;
}

// 判斷是否支持TouchID,只判斷手機端，ipad端我們不支持

+ (BOOL)judueIPhonePlatformSupportTouchID
{
    /*
     if ([platform isEqualToString:@"iPhone1,1"])   return @"iPhone1G GSM";
     if ([platform isEqualToString:@"iPhone1,2"])   return @"iPhone3G GSM";
     if ([platform isEqualToString:@"iPhone2,1"])   return @"iPhone3GS GSM";
     if ([platform isEqualToString:@"iPhone3,1"])   return @"iPhone4 GSM";
     if ([platform isEqualToString:@"iPhone3,3"])   return @"iPhone4 CDMA";
     if ([platform isEqualToString:@"iPhone4,1"])   return @"iPhone4S";
     if ([platform isEqualToString:@"iPhone5,1"])   return @"iPhone5";
     if ([platform isEqualToString:@"iPhone5,2"])   return @"iPhone5";
     if ([platform isEqualToString:@"iPhone5,3"])   return @"iPhone 5c (A1456/A1532)";
     if ([platform isEqualToString:@"iPhone5,4"])   return @"iPhone 5c (A1507/A1516/A1526/A1529)";
     if ([platform isEqualToString:@"iPhone6,1"])   return @"iPhone 5s (A1453/A1533)";
     if ([platform isEqualToString:@"iPhone6,2"])   return @"iPhone 5s (A1457/A1518/A1528/A1530)";
     */


    if(IS_Phone)
    {
        if([self platform].length > 6 )
        {

            NSString * numberPlatformStr = [[self platform] substringWithRange:NSMakeRange(6, 1)];
            NSInteger numberPlatform = [numberPlatformStr integerValue];
            // 是否是5s以上的設備
            if(numberPlatform > 5)
            {
                return YES;
            }
            else
            {
                return NO;
            }

        }
        else
        {
            return NO;
        }
    }
    else
    {
        // 我們不支持iPad 設備
        return NO;
    }

}

@end

demo

TouchIDDemo

參考資料

LocalAuthentication源碼學習
iOS App中使用Touch ID及注意事項
Touch ID API responsive is very slow
How to remove Enter Password and canel button from Touch id Alert view
TouchID - Detect new fingerprints added - When does evaluatedPolicyDomainState change?
evaluatedpolicydomainstate蘋果官方文檔
如果有問題或者建議歡迎留言,大家一起學習探討.

iOS 指紋識別常見問題彙總

一.基本知識

LocalAuthentication.h

LAPublicDefines.h

LAError.h

LAContext.h

二.常見問題

1. 指紋識別的版本問題

2. 指紋識別的LAPolicy

3. 指紋識別LAContext的方法

4. feedback按鈕顯示

5. CancelTitle按鈕顯示

6. 指紋識別慢的問題

7.彈窗顯示級別問題

8.檢測指紋庫中指紋是否發生改變

9.支持機型判斷

demo

參考資料

IOS學習之一個示例弄懂代理(delegate)和協議

iOS 代理反向傳值

iOS - 關於NSURLCache

iOS 文件讀寫（一）

URL Schemes 使用詳解

Mac下配置sublime實現LaTeX

https://yachay.unat.edu.pe/blog/index.php?comment_area=format_blog&comment_component=blog&comment_co

linux以太網驅動總結