
指紋驗證相關的 API 都在 Local Authentication 框架中:
#import <LocalAuthentication/LocalAuthentication.h>
記得在專案的 Build Phases 中把 LocalAuthentication.framework 加入 linked libraries。
第一個用來判斷裝置是否支援指紋驗證:
- (BOOL)canEvaluatePolicy:(LAPolicy)policy
error:(NSError * __autoreleasing *)error;
第二個用來真正發起驗證,它會跳出系統提供的 Touch ID 提示框:
- (void)evaluatePolicy:(LAPolicy)policy
localizedReason:(NSString *)localizedReason
reply:(void(^)(BOOL success, NSError *error))reply;
兩個主要屬性:localizedFallbackTitle 決定提示框左側按鈕的文字(預設是 Enter Password),localizedReason 則是告訴使用者「為什麼需要驗證」的說明文字。

驗證失敗時的畫面
LAContext *context = [LAContext new]; // 指紋輸入失敗後,替代方案按鈕上的文字 context.localizedFallbackTitle = @"沒有忘記密碼";
NSError *error = nil;
if ([context canEvaluatePolicy:LAPolicyDeviceOwnerAuthenticationWithBiometrics error:&error]) {
NSLog(@"支援指紋識別");
[context evaluatePolicy:LAPolicyDeviceOwnerAuthenticationWithBiometrics
localizedReason:@"指紋解鎖"
reply:^(BOOL success, NSError * _Nullable error) {
if (success) {
NSLog(@"驗證成功,刷新主介面");
} else {
NSLog(@"%@", error.localizedDescription);
switch (error.code) {
case LAErrorSystemCancel:
NSLog(@"系統取消授權,例如其他 App 切入"); break;
case LAErrorUserCancel:
NSLog(@"使用者取消驗證 Touch ID"); break;
case LAErrorAuthenticationFailed:
NSLog(@"授權失敗"); break;
case LAErrorPasscodeNotSet:
NSLog(@"系統未設定密碼"); break;
case LAErrorTouchIDNotAvailable:
NSLog(@"裝置 Touch ID 不可用,例如未開啟"); break;
case LAErrorTouchIDNotEnrolled:
NSLog(@"裝置 Touch ID 不可用,使用者未錄入"); break;
case LAErrorUserFallback:
[[NSOperationQueue mainQueue] addOperationWithBlock:^{
NSLog(@"使用者選擇輸入密碼,切回主線程處理");
}];
break;
default:
[[NSOperationQueue mainQueue] addOperationWithBlock:^{
NSLog(@"其他情況,切回主線程處理");
}];
break;
}
}
}];
} else {
NSLog(@"不支援指紋識別");
switch (error.code) {
case LAErrorTouchIDNotEnrolled:
NSLog(@"Touch ID is not enrolled"); break;
case LAErrorPasscodeNotSet:
NSLog(@"A passcode has not been set"); break;
default:
NSLog(@"Touch ID not available"); break;
}
NSLog(@"%@", error.localizedDescription);
}
回呼在子線程。reply block 是在非主線程呼叫的,任何 UI 更新(跳轉頁面、刷新介面)都必須切回主線程,這也是範例中出現 addOperationWithBlock 的原因。
錯誤碼要分類處理。使用者主動按「輸入密碼」屬於 LAErrorUserFallback,與「驗證失敗」的處理邏輯完全不同,前者應該導向密碼輸入流程而非直接報錯。
整套 API 設計得相當簡潔,蘋果已經把生物特徵辨識的複雜度都收進系統裡,開發者只要處理好授權判斷與錯誤分支即可。需要注意的是,本機驗證只能確認「是本人」,若要做服務端信任,仍需搭配自有的憑證機制。有疑問歡迎留言交流。