指紋驗證現在很常見,通常會和數字密碼、手勢密碼一起搭配使用。本文示範兩條路:直接用系統的 LocalAuthentication,以及套用現成的第三方封裝。
支援條件:指紋識別最低機型為 iPhone 5s,最低系統為 iOS 8。用純程式碼實作其實不難。
第一步:加入 LocalAuthentication.framework。



第二步:在 AppDelegate 中設定 rootViewController。
#import "AppDelegate.h"
#import "ViewController.h"
@interface AppDelegate ()
@end
@implementation AppDelegate
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
_window = [[UIWindow alloc] initWithFrame:[UIScreen mainScreen].bounds];
_window.backgroundColor = [UIColor whiteColor];
[_window makeKeyAndVisible];
ViewController *vc = [[ViewController alloc] init];
UINavigationController *na = [[UINavigationController alloc] initWithRootViewController:vc];
_window.rootViewController = na;
return YES;
}
@end
第三步:引入標頭。
#import <LocalAuthentication/LocalAuthentication.h>
第四步:實作驗證。LAContext 在官方文件中其實只有兩個方法:
-canEvaluatePolicy:error: // - (BOOL)canEvaluatePolicy:(LAPolicy)policy error:(NSError * __autoreleasing *)error; -evaluatePolicy:localizedReason:reply: // - (void)evaluatePolicy:(LAPolicy)policy localizedReason:(NSString *)localizedReason reply:(void(^)(BOOL success, NSError *error))reply;
一個判斷裝置是否支援,一個執行驗證並回傳結果。以前網路上很多文章第一步都先判斷系統版本,現在其實不需要了,呼叫 canEvaluatePolicy 就足夠。
- (void)viewDidLoad {
[super viewDidLoad];
self.title = @"TouchIDSimpleDemoOne";
LAContext *context = [[LAContext alloc] init];
NSError *error = nil;
NSString *result = @"需要進行身份驗證";
if ([context canEvaluatePolicy:LAPolicyDeviceOwnerAuthenticationWithBiometrics error:&error]) {
[context evaluatePolicy:LAPolicyDeviceOwnerAuthenticationWithBiometrics
localizedReason:result
reply:^(BOOL success, NSError *error) {
if (success) {
// 驗證成功,請切回主執行緒處理 UI
NSLog(@"驗證成功");
} else {
// 依失敗原因分別處理
NSLog(@"%@", error.localizedDescription);
switch (error.code) {
case LAErrorSystemCancel: {
NSLog(@"切換到其他 App,系統取消驗證 Touch ID");
break;
}
case LAErrorUserCancel: {
NSLog(@"使用者取消驗證 Touch ID");
break;
}
case LAErrorUserFallback: {
NSLog(@"使用者選擇輸入密碼");
[[NSOperationQueue mainQueue] addOperationWithBlock:^{
// 使用者選擇其他驗證方式,切回主執行緒處理
}];
break;
}
default: {
NSLog(@"LAErrorAuthenticationFailed,授權失敗");
[[NSOperationQueue mainQueue] addOperationWithBlock:^{
// 其他情況,切回主執行緒處理
}];
break;
}
}
}
}];
} else {
// 不支援指紋識別,印出錯誤詳情
switch (error.code) {
case LAErrorTouchIDNotEnrolled: {
NSLog(@"裝置 Touch ID 不可用,使用者未錄入");
break;
}
case LAErrorPasscodeNotSet: {
NSLog(@"系統未設定密碼");
break;
}
case LAErrorTouchIDNotAvailable: {
NSLog(@"裝置 Touch ID 不可用,例如未開啟");
break;
}
default: {
NSLog(@"系統未設定密碼");
break;
}
}
NSLog(@"%@", error.localizedDescription);
}
}
LAError 的完整列舉如下,實作時可對照處理:
// 指紋驗證回傳值
typedef NS_ENUM(NSInteger, LAError) {
/// 驗證未成功,因為使用者未提供有效憑證
LAErrorAuthenticationFailed = kLAErrorAuthenticationFailed,
/// 驗證被使用者取消(例如點了 Cancel 按鈕)
LAErrorUserCancel = kLAErrorUserCancel,
/// 驗證被取消,因為使用者點了 fallback 按鈕(Enter Password)
LAErrorUserFallback = kLAErrorUserFallback,
/// 驗證被系統取消(例如其他應用程式切到前台)
LAErrorSystemCancel = kLAErrorSystemCancel,
/// 無法啟動驗證,因為裝置未設定密碼
LAErrorPasscodeNotSet = kLAErrorPasscodeNotSet,
/// 無法啟動驗證,因為裝置的 Touch ID 不可用
LAErrorTouchIDNotAvailable = kLAErrorTouchIDNotAvailable,
/// 無法啟動驗證,因為 Touch ID 沒有錄入任何指紋
LAErrorTouchIDNotEnrolled = kLAErrorTouchIDNotEnrolled,
/// 驗證未成功,連續多次失敗導致 Touch ID 被鎖,
/// 需要輸入密碼解鎖
LAErrorTouchIDLockout NS_ENUM_AVAILABLE(10_11, 9_0) = kLAErrorTouchIDLockout,
/// 驗證被應用程式取消(例如驗證進行中呼叫了 invalidate)
LAErrorAppCancel NS_ENUM_AVAILABLE(10_11, 9_0) = kLAErrorAppCancel,
/// 傳入的 LAContext 先前已被 invalidate
LAErrorInvalidContext NS_ENUM_AVAILABLE(10_11, 9_0) = kLAErrorInvalidContext
} NS_ENUM_AVAILABLE(10_10, 8_0);
這就是一個可用的最小 demo。實務上還要注意兩點:reply block 是在背景佇列回呼的,任何 UI 操作都要切回主執行緒;另外 LAContext 物件必須在驗證期間保持存活,別讓它提早被釋放。
如果不想自己處理那麼多錯誤分支,可以考慮 [WJTouchID](https://github.com/hu670014125/WJTouchID)。呼叫只要一兩行,但回呼方法還是得寫不少。
1. 複製檔案進來

2. 引入標頭
#import "WJTouchID.h"
3. 遵守協議
@interface ViewController () <WJTouchIDDelegate>
4. 建立物件
@property (nonatomic, strong) WJTouchID *touchID;
5. 呼叫
- (void)viewDidLoad {
[super viewDidLoad];
// 初始化
WJTouchID *touchid = [[WJTouchID alloc] init];
[touchid startWJTouchIDWithMessage:WJNotice(@"自定義訊息", @"The Custom Message")
fallbackTitle:WJNotice(@"", @"Fallback Title")
delegate:self];
self.touchID = touchid;
}
6. 實作回呼
@required // TouchID 驗證成功 - (void)WJTouchIDAuthorizeSuccess; // TouchID 驗證失敗 - (void)WJTouchIDAuthorizeFailure; @optional // 當前裝置不支援指紋識別 - (void)WJTouchIDIsNotSupport; // 當前 App 被掛起取消了授權(如突然來電、應用進入前台) - (void)WJTouchIDAuthorizeErrorAppCancel; // 取消 TouchID 驗證(使用者點擊了取消) - (void)WJTouchIDAuthorizeErrorUserCancel; // 在 TouchID 對話框中點擊輸入密碼按鈕 - (void)WJTouchIDAuthorizeErrorUserFallback; // 驗證過程中被系統取消,例如突然來電、按了 Home 鍵、鎖屏 - (void)WJTouchIDAuthorizeErrorSystemCancel; // 無法啟用 TouchID,裝置沒有設定密碼 - (void)WJTouchIDAuthorizeErrorPasscodeNotSet; // 連續多次失敗導致 Touch ID 被鎖,需用密碼解鎖 - (void)WJTouchIDAuthorizeErrorTouchIDLockout; // 授權過程中 LAContext 物件被釋放 - (void)WJTouchIDAuthorizeErrorInvalidContext; // 裝置沒有錄入 TouchID,無法啟用 - (void)WJTouchIDAuthorizeErrorTouchIDNotEnrolled; // 該裝置的 TouchID 無效 - (void)WJTouchIDAuthorizeErrorTouchIDNotAvailable;
這些方法實作完,功能基本就齊了。下一篇會示範在 App 被喚醒時啟動指紋驗證,分別用彈出控制器與彈出自訂 view 兩種方式實作。