Android指纹识别，提升APP用户体验，从这里开始！(1)_fingerprintmanagercompat

在指纹识别功能的实践中，我将其做成了开源库发布在了 Github 上，可通过 gradle 进行依赖，使用方法比较简单，两三行代码，再传入一个验证结果监听即可。

下面对部分实现过程做一下介绍，详细的 Api 及源码请移步 Github。

Github 地址

示例

Android 6.0 指纹识别框，开发者自定义：

Android 9.0 指纹识别框，系统提供：

其中指纹 icon 和取消按钮的文字颜色，由属性 colorPrimary 的颜色值决定。

指纹识别管理类

FingerprintVerifyManager 是指纹识别库的入口，对指纹识别进行管理，通过 FingerprintVerifyManager.Builder 对指纹识别进行初始化。

在这个类中，有根据手机系统版本调用不同的指纹识别 Api（FingerprintManagerCompat 或者 BiometricPrompt），其中 BiometricPrompt 支持开启或者关闭，默认关闭。

public FingerprintVerifyManager(Builder builder) {
IFingerprint fingerprint;
// >= Android P
if (AndrVersionUtil.isAboveAndrP()) {
//在 Android P 上是否展示系统提供的识别框
if (builder.enableAndroidP)
fingerprint = FingerprintAndrP.newInstance();
else
fingerprint = FingerprintAndrM.newInstance();
} else if (AndrVersionUtil.isAboveAndrM()) {// Android 6.0 =< Version
fingerprint = FingerprintAndrM.newInstance();
} else {// < Android 6.0 ，官方未开放指纹识别，某些机型自行支持的情况暂不做处理
builder.callback.onError(builder.context.getString(R.string.biometricprompt_verify_error_below_m));
return;
}

……

fingerprint.authenticate(builder.context, bean, builder.callback);
}

其中 IFingerprint 是指纹识别的接口，兼容 Android 6.0 的 FingerprintAndrM 和兼容 Android 9.0 的 FingerprintAndrP 都实现了此接口。

public interface IFingerprint {

/**

• 初始化并调起指纹识别
• @param context
• @param verificationDialogStyleBean 指纹识别框样式
• @param callback 通知开发者指纹识别结果
  */
  void authenticate(Activity context, VerificationDialogStyleBean verificationDialogStyleBean, FingerprintCallback callback);

}

基于Android 6.0 实现指纹识别

上文有提及，FingerprintAndrM 是基于 Android 6.0 的具体的指纹识别实现类：

@RequiresApi(api = Build.VERSION_CODES.M)
public class FingerprintAndrM implements IFingerprint {

private final String TAG = FingerprintAndrM.class.getName();
private Activity context;

private static FingerprintAndrM fingerprintAndrM;
//指纹验证框
private static FingerprintDialog fingerprintDialog;
//指向调用者的指纹回调
private FingerprintCallback fingerprintCallback;

//用于取消扫描器的扫描动作
private CancellationSignal cancellationSignal;
//指纹加密
private static FingerprintManagerCompat.CryptoObject cryptoObject;
//Android 6.0 指纹管理
private FingerprintManagerCompat fingerprintManagerCompat;

@Override
public void authenticate(Activity context, VerificationDialogStyleBean bean, FingerprintCallback callback) {

//判断指纹识别是否可用
if (!canAuthenticate(context, callback))
return;

this.context = context;
this.fingerprintCallback = callback;
//Android 6.0 指纹管理 实例化
fingerprintManagerCompat = FingerprintManagerCompat.from(context);

//取消扫描，每次取消后需要重新创建新示例
cancellationSignal = new CancellationSignal();
cancellationSignal.setOnCancelListener(() -> fingerprintDialog.dismiss());

//调起指纹验证
fingerprintManagerCompat.authenticate(cryptoObject, 0, cancellationSignal, authenticationCallback, null);
//指纹验证框
fingerprintDialog = FingerprintDialog.newInstance(context).setActionListener(dialogActionListener).setDialogStyle(bean);
fingerprintDialog.show(context.getFragmentManager(), TAG);
}

public static FingerprintAndrM newInstance() {
if (fingerprintAndrM == null) {
synchronized (FingerprintAndrM.class) {
if (fingerprintAndrM == null) {
fingerprintAndrM = new FingerprintAndrM();
}
}
}
//指纹加密，提前进行Cipher初始化，防止指纹认证时还没有初始化完成
try {
cryptoObject = new FingerprintManagerCompat.CryptoObject(new CipherHelper().createCipher());
} catch (Exception e) {
e.printStackTrace();
}
return fingerprintAndrM;
}

/**

• 指纹验证框按键监听
  */
  private FingerprintDialog.OnDialogActionListener dialogActionListener = new FingerprintDialog.OnDialogActionListener() {
  @Override
  public void onUsepwd() {
  if (fingerprintCallback != null)
  fingerprintCallback.onUsepwd();
  }

@Override
public void onCancle() {//取消指纹验证，通知调用者
if (fingerprintCallback != null)
fingerprintCallback.onCancel();
}

@Override
public void onDismiss() {//验证框消失，取消指纹验证
if (cancellationSignal != null && !cancellationSignal.isCanceled())
cancellationSignal.cancel();
}
};

/**

• 指纹验证结果回调
  */
  private FingerprintManagerCompat.AuthenticationCallback authenticationCallback = new FingerprintManagerCompat.AuthenticationCallback() {
  @Override
  public void onAuthenticationError(int errMsgId, CharSequence errString) {
  super.onAuthenticationError(errMsgId, errString);
  fingerprintDialog.setTip(errString.toString(), R.color.biometricprompt_color_FF5555);
  }

@Override
public void onAuthenticationHelp(int helpMsgId, CharSequence helpString) {
super.onAuthenticationHelp(helpMsgId, helpString);
fingerprintDialog.setTip(helpString.toString(), R.color.biometricprompt_color_FF5555);
}

@Override
public void onAuthenticationSucceeded(FingerprintManagerCompat.AuthenticationResult result) {
super.onAuthenticationSucceeded(result);
fingerprintDialog.setTip(context.getString(R.string.biometricprompt_verify_success), R.color.biometricprompt_color_82C785);
fingerprintCallback.onSucceeded();
fingerprintDialog.dismiss();
}

@Override
public void onAuthenticationFailed() {
super.onAuthenticationFailed();
fingerprintDialog.setTip(context.getString(R.string.biometricprompt_verify_failed), R.color.biometricprompt_color_FF5555);
fingerprintCallback.onFailed();
}
};

/*

• 在 Android Q，Google 提供了 Api BiometricManager.canAuthenticate() 用来检测指纹识别硬件是否可用及是否添加指纹
• 不过尚未开放，标记为"Stub"(存根)
• 所以暂时还是需要使用 Andorid 6.0 的 Api 进行判断
• /
  private boolean canAuthenticate(Context context, FingerprintCallback fingerprintCallback) {
  /
• 硬件是否支持指纹识别
• */
  if (!FingerprintManagerCompat.from(context).isHardwareDetected()) {
  fingerprintCallback.onError(FingerprintManager.FINGERPRINT_ERROR_HW_NOT_PRESENT, context.getString(R.string.biometricprompt_verify_error_no_hardware));
  return false;
  }
  //是否已添加指纹
  if (!FingerprintManagerCompat.from(context).hasEnrolledFingerprints()) {
  fingerprintCallback.onNoneEnrolled();
  return false;
  }
  return true;
  }

}

这里面要重点关注 CancellationSignal 与指纹识别框的关联，也就是识别框消失，就一定要取消指纹扫描器的扫描操作，否则在超时时间内，用户将无法再次拉起指纹识别（尽管可以弹出指纹识别框）。

基于Android 9.0 实现指纹识别

上文有提及，FingerprintAndrP 是基于 Android 9.0 的具体的指纹识别实现类：

@RequiresApi(api = Build.VERSION_CODES.P)
public class FingerprintAndrP implements IFingerprint {

private static FingerprintAndrP fingerprintAndrP;
//指向调用者的指纹回调
private FingerprintCallback fingerprintCallback;

//用于取消扫描器的扫描动作
private CancellationSignal cancellationSignal;
//指纹加密
private static BiometricPrompt.CryptoObject cryptoObject;

@Override
public void authenticate(Activity context, VerificationDialogStyleBean verificationDialogStyleBean, FingerprintCallback callback) {

//判断指纹识别是否可用
if (!canAuthenticate(context, callback))
return;

this.fingerprintCallback = callback;

/*

• 初始化 BiometricPrompt.Builder
  */
  ……

//构建 BiometricPrompt
BiometricPrompt biometricPrompt = builder.build();

//取消扫描，每次取消后需要重新创建新示例
cancellationSignal = new CancellationSignal();
cancellationSignal.setOnCancelListener(() -> {
});

/*

• 拉起指纹验证模块，等待验证
• Executor：
• context.getMainExecutor()
  */
  biometricPrompt.authenticate(cryptoObject, cancellationSignal, context.getMainExecutor(), authenticationCallback);
  }

public static FingerprintAndrP newInstance() {
if (fingerprintAndrP == null) {
synchronized (FingerprintAndrM.class) {
if (fingerprintAndrP == null) {
fingerprintAndrP = new FingerprintAndrP();
}
}
}
//指纹加密，提前进行Cipher初始化，防止指纹认证时还没有初始化完成
try {
cryptoObject = new BiometricPrompt.CryptoObject(new CipherHelper().createCipher());
} catch (Exception e) {
e.printStackTrace();
}

return fingerprintAndrP;
}

/**

• 认证结果回调
  */
  private BiometricPrompt.AuthenticationCallback authenticationCallback = new BiometricPrompt.AuthenticationCallback() {
  @Override
  public void onAuthenticationError(int errorCode, CharSequence errString) {
  super.onAuthenticationError(errorCode, errString);
  if (fingerprintCallback != null) {
  if (errorCode == 5) {//用户取消指纹验证，不必向用户抛提示信息
  fingerprintCallback.onCancel();
  return;
  }
  fingerprintCallback.onError(errorCode, errString.toString());
  }
  }

@Override
public void onAuthenticationHelp(int helpCode, CharSequence helpString) {
super.onAuthenticationHelp(helpCode, helpString);
if (fingerprintCallback != null)
fingerprintCallback.onError(helpCode, helpString.toString());
}

@Override
public void onAuthenticationSucceeded(BiometricPrompt.AuthenticationResult result) {
super.onAuthenticationSucceeded(result);
if (fingerprintCallback != null)
fingerprintCallback.onSucceeded();
}

@Override
public void onAuthenticationFailed() {
super.onAuthenticationFailed();
if (fingerprintCallback != null)
fingerprintCallback.onFailed();
}
};

/*

• 在 Android Q，Google 提供了 Api BiometricManager.canAuthenticate() 用来检测指纹识别硬件是否可用及是否添加指纹
• 不过尚未开放，标记为"Stub"(存根)
• 所以暂时还是需要使用 Andorid 6.0 的 Api 进行判断
• */
  private boolean canAuthenticate(Context context, FingerprintCallback fingerprintCallback) {

/*

• 硬件是否支持指纹识别
• */
  if (!FingerprintManagerCompat.from(context).isHardwareDetected()) {
  自我介绍一下，小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。

深知大多数初中级Android工程师，想要提升技能，往往是自己摸索成长或者是报班学习，但对于培训机构动则近万的学费，着实压力不小。自己不成体系的自学效果低效又漫长，而且极易碰到天花板技术停滞不前！

因此收集整理了一份《2024年Android移动开发全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上Android开发知识点，真正体系化！

由于文件比较大，这里只是将部分目录截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且会持续更新！

如果你觉得这些内容对你有帮助，可以扫码获取！！（备注：Android）

如何成为Android高级架构师！

架构师必须具备抽象思维和分析的能力，这是你进行系统分析和系统分解的基本素质。只有具备这样的能力，架构师才能看清系统的整体，掌控全局，这也是架构师大局观的形成基础。 你如何具备这种能力呢？一是来自于经验，二是来自于学习。

架构师不仅要具备在问题领域上的经验，也需要具备在软件工程领域内的经验。也就是说，架构师必须能够准确得理解需求，然后用软件工程的思想，把需求转化和分解成可用计算机语言实现的程度。经验的积累是需要一个时间过程的，这个过程谁也帮不了你，是需要你去经历的。

但是，如果你有意识地去培养，不断吸取前人的经验的话，还是可以缩短这个周期的。这也是我整理架构师进阶此系列的始动力之一。

---

成为Android架构师必备知识技能

对应导图的学习笔记(由阿里P8大牛手写，我负责整理成PDF笔记）

部分内容展示

《设计思想解读开源框架》

• 目录
  
• 热修复设计
  
• 插件化框架设计
  
  《360°全方面性能优化》
  
• 设计思想与代码质量优化
  
• 程序性能优化
  

《互联网大厂面试真题解析、进阶开发核心学习笔记、全套讲解视频、实战项目源码讲义》点击传送门即可获取！

E-1712720791040)]

• 插件化框架设计
  [外链图片转存中…(img-ElX46w4o-1712720791040)]
  《360°全方面性能优化》
  [外链图片转存中…(img-pOxLd1FA-1712720791040)]
• 设计思想与代码质量优化
  [外链图片转存中…(img-OJB0yLac-1712720791041)]
• 程序性能优化
  [外链图片转存中…(img-6I3wEKGT-1712720791041)]

《互联网大厂面试真题解析、进阶开发核心学习笔记、全套讲解视频、实战项目源码讲义》点击传送门即可获取！