Android-Goldfinger 前置检查必修课：canAuthenticate 的 3 种用法避免崩溃

Android-Goldfinger 前置检查必修课canAuthenticate 的 3 种用法避免崩溃【免费下载链接】Android-GoldfingerAndroid library to simplify Biometric authentication implementation.项目地址: https://gitcode.com/gh_mirrors/an/Android-GoldfingerAndroid-Goldfinger 是一款专门简化 Android 生物识别认证Biometric authentication接入的轻量级开源库它把繁琐的BiometricPrompt与加密解密逻辑封装成几行简洁的 API。无论你是刚接触指纹登录的新手还是在已有支付、密码保险箱功能中集成生物识别调用生物识别弹窗之前的第一课都是学会正确使用canAuthenticate前置检查。本文用 3 种实用用法帮你彻底避开「设备无硬件」「未录入指纹」导致的运行时崩溃。为什么必须做 canAuthenticate 前置检查很多崩溃的根源在于用户设备根本没有指纹硬件或者系统设置里一个指纹都没录入你却直接弹出了生物识别对话框。系统会立刻回调错误码处理不当轻则弹窗异常重则直接 Crash。canAuthenticate正是官方提供的「能力探测」接口它会在调用前告诉你当前设备是否满足认证条件。Android-Goldfinger 把它包装成了Goldfinger接口上的两个方法源码位于core/src/main/java/co/infinum/goldfinger/Goldfinger.java核心实现在core/src/main/java/co/infinum/goldfinger/GoldfingerImpl.java内部调用BiometricManager.canAuthenticate()返回值等于BIOMETRIC_SUCCESS时才返回true。用法一无参数版本 canAuthenticate()已被标记废弃这是最早期也是最简单的写法只判断「当前默认认证方式是否可用」if (goldfinger.canAuthenticate()) { // 可以发起生物识别认证 }它在库中已被标注Deprecated原因是它无法区分认证类型你无法得知探测的是「指纹」还是「人脸」也无法控制强弱安全等级。新手建议直接跳过它虽然它不会报错但属于「能用但不推荐」的历史接口。用法二带参数版本 canAuthenticate(int authenticators)推荐这是官方推荐的现代用法通过传入认证类型常量精确探测设备支持哪种生物识别。Android-Goldfinger 在Goldfinger.java中明确建议使用带参版本并直接对接BiometricManager.canAuthenticate(int)。最常见的两种长尾场景2.1 探测强生物识别BIOMETRIC_STRONGboolean strongReady goldfinger.canAuthenticate( BiometricManager.Authenticators.BIOMETRIC_STRONG );BIOMETRIC_STRONG代表 Class 3 级强生物识别如屏下指纹、3D 人脸安全性最高适合支付、转账等敏感操作。2.2 探测弱生物识别BIOMETRIC_WEAKboolean weakReady goldfinger.canAuthenticate( BiometricManager.Authenticators.BIOMETRIC_WEAK );BIOMETRIC_WEAK代表 Class 2 级弱生物识别适合普通的应用解锁场景。你可以根据业务安全等级分别控制按钮是否可点击示例工程example/src/main/java/co/infinum/example/ChooseImplementationActivity.java中就有完整的强弱类型开关演示strongCheckBox.setEnabled(goldfinger.canAuthenticate(BiometricManager.Authenticators.BIOMETRIC_STRONG)); weakCheckBox.setEnabled(goldfinger.canAuthenticate(BiometricManager.Authenticators.BIOMETRIC_WEAK));用法三组合探测 兜底方案最稳妥的防崩溃组合拳只调用一次canAuthenticate还不够最稳妥的姿势是「组合探测 兜底降级」。Android-Goldfinger 额外提供了两个辅助方法帮你定位问题到底出在哪一环探测方法返回 true 的含义返回 false 时的处理建议hasBiometricHardware(int)设备存在生物识别硬件隐藏入口提示升级设备hasEnrolledBiometrics(int)已录入至少一个生物特征引导用户去系统设置录入canAuthenticate(int)硬件、录入全部就绪兜底弹窗或降级为密码登录推荐的完整三段式检查代码如下Goldfinger goldfinger new Goldfinger.Builder(context).build(); if (!goldfinger.hasBiometricHardware(BiometricManager.Authenticators.BIOMETRIC_WEAK)) { // 无硬件隐藏指纹入口不要弹出任何生物识别对话框 return; } if (!goldfinger.hasEnrolledBiometrics(BiometricManager.Authenticators.BIOMETRIC_WEAK)) { // 未录入引导用户去系统设置添加指纹/人脸 return; } if (!goldfinger.canAuthenticate(BiometricManager.Authenticators.BIOMETRIC_WEAK)) { // 仍然不可用兜底降级为账号密码登录 return; } // 全部通过安全地发起认证 goldfinger.authenticate(params, callback);这套「硬件 → 录入 → 可用」的三级检查几乎覆盖了所有可能导致崩溃的边界情况也是金融类 App 的标准做法。额外防坑提示老机型与返回值语义Android 6.0 以下机型库会自动回退到GoldfingerMock见core/src/main/java/co/infinum/goldfinger/GoldfingerMock.java此时canAuthenticate恒返回false你的检查逻辑天然安全不会崩溃。返回值是布尔而非状态码Android-Goldfinger 帮你把复杂的错误码转换成了true/false你不用再关心BIOMETRIC_ERROR_NO_HARDWARE这类常量代码可读性更高。每次进入页面都应重新检查用户可能在系统设置中随时删除指纹建议在onResume中刷新按钮可用状态而不是只在首次启动时检查一次。总结一行检查杜绝九成崩溃记住这三条黄金规则生物识别接入从此不踩坑✅ 优先使用canAuthenticate(int authenticators)明确指定认证类型✅ 配合hasBiometricHardware与hasEnrolledBiometrics做三级探测✅ 检查不通过时优雅降级绝不强行弹窗。掌握了 canAuthenticate 的这 3 种用法你的 Android 生物识别认证就能在各类机型上稳定运行把崩溃风险降到最低。配合 Android-Goldfinger 简洁的 API 设计从检查到认证整个过程不过十余行代码强烈推荐在下一个项目里直接体验。【免费下载链接】Android-GoldfingerAndroid library to simplify Biometric authentication implementation.项目地址: https://gitcode.com/gh_mirrors/an/Android-Goldfinger创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考