Android-Goldfinger 停止维护后的迁移指南:替代方案与升级路径【免费下载链接】Android-GoldfingerAndroid library to simplify Biometric authentication implementation.项目地址: https://gitcode.com/gh_mirrors/an/Android-Goldfinger一句话总结Android-Goldfinger 是一款曾广受欢迎的 Android 生物识别认证库官方已宣布停止维护。本文为你梳理完整的迁移指南从风险评估、替代方案对比到基于 androidx.biometric 的分步升级路径帮你平稳完成 Android 指纹认证功能的过渡。Android-Goldfinger 是什么:曾被广泛使用的生物识别库Android-Goldfinger 由 Infinum 团队开源核心定位是简化 Android 生物识别指纹、人脸等认证的实现。在它出现的年代原生指纹 API 碎片化严重开发者需要处理FingerprintManager、KeyStore、Cipher等一系列繁琐逻辑而 Goldfinger 把这些全部封装成了几行代码✅ 一行代码完成初始化与认证✅ 内置认证 加密/解密能力用于指纹解锁后自动登录等场景✅ 提供基于 RxJava 的响应式模块✅ 基于 androidx.biometric 封装兼容性好它的核心源码并不复杂整体结构非常清晰很适合作为学习参考模块说明源码位置核心模块认证、加密、解密、参数校验Goldfinger.java核心实现BiometricPrompt 的具体封装GoldfingerImpl.javaRx 模块响应式风格的认证 APIRxGoldfinger.java示例代码登录、支付等典型用法LoginActivity.java停止维护的真相:为什么必须尽快迁移项目 README 的第一行就写着Deprecated已弃用并明确表示该库不再受支持也不会再收到任何更新。这意味着不再适配新系统Android 新版本如 Android 13 对生物识别权限与回调的变化不会得到兼容性修复安全风险累积密钥管理、加密算法等敏感逻辑缺少维护可能成为安全隐患依赖链越拖越深它还依赖旧版 androidx.biometric继续使用会阻碍你的依赖升级结论很明确越早规划迁移成本越低。好消息是Goldfinger 本身就是 androidx.biometric 的轻量封装所以迁移并没有想象中那么可怕。迁移前的盘点:先确认你的使用场景动手前先对照自己的代码确认你属于哪种场景这决定了迁移的工作量使用场景特征迁移难度纯认证只用authenticate()做指纹确认如支付⭐ 低认证 加密/解密用了encrypt()/decrypt()如指纹自动登录⭐⭐⭐ 中Rx 响应式使用了goldfinger-rx模块⭐⭐ 中你可以参考示例项目来快速定位自己的用法PaymentActivity.java 是纯认证LoginActivity.java 是加密/解密场景。首选替代方案:直接用 androidx.biometric 官方方案最推荐的替代方案不是第三方库而是 Android 官方提供的 androidx.biometric。理由很简单Goldfinger 底层就是它API 心智模型几乎一一对应官方长期维护持续适配新系统没有额外依赖减少供应链风险先记住两者的对应关系表迁移时照着改即可Goldfinger APIandroidx.biometric 对应方案new Goldfinger.Builder(context).build()new BiometricPrompt(activity, executor, callback)goldfinger.canAuthenticate(authenticators)BiometricManager.from(context).canAuthenticate(authenticators)PromptParams.BuilderBiometricPrompt.PromptInfo.Buildergoldfinger.authenticate(params, callback)biometricPrompt.authenticate(promptInfo)goldfinger.cancel()biometricPrompt.cancelAuthentication()Callback.onResultAuthenticationCallback系列回调纯认证场景的迁移几乎是翻译级别的工作量。例如 Goldfinger 的初始化Goldfinger goldfinger new Goldfinger.Builder(this) .logEnabled(true) .build();迁移后对应为BiometricPrompt biometricPrompt new BiometricPrompt(activity, executor, new BiometricPrompt.AuthenticationCallback() { /* 处理回调 */ });加密解密场景:迁移中最需要重视的部分如果你的应用用了encrypt()/decrypt()Goldfinger 通过内部 AesCipherFactory.java 和 Base64CipherCrypter.java 实现迁移时需要自己接管三条链路密钥管理通过 Android Keystore 生成 AES 密钥并关联到仅认证后可解锁Cipher 创建认证前创建加密/解密用的Cipher实例CryptoObject 绑定把Cipher包装成BiometricPrompt.CryptoObject传入认证核心思路是认证成功回调里拿到已解锁的 Cipher再用它做真正的加密/解密。这部分逻辑建议单独抽取成一个工具类方便复用和测试。如果你需要参考原实现可以直接克隆源码研读git clone https://gitcode.com/gh_mirrors/an/Android-Goldfinger其中 CryptoObjectFactory.java 与 CrypterProxy.java 是两个最值得借鉴的类。分步升级路径:5 步完成迁移第 1 步:移除旧依赖在build.gradle中删除com.infinum:goldfinger和com.infinum:goldfinger-rx并升级androidx.biometric到最新稳定版。第 2 步:替换能力检测把goldfinger.canAuthenticate(...)替换为BiometricManager的检测逻辑并正确处理返回值成功、无硬件、未录入、硬件不可用等。第 3 步:替换认证流程创建BiometricPrompt与PromptInfo在AuthenticationCallback中实现成功/失败/取消的 UI 反馈。Goldfinger 把结果封装成TypeSUCCESS/INFO/ERROR和Reason枚举迁移时对照onAuthenticationSucceeded、onAuthenticationFailed、onAuthenticationError三个回调即可。第 4 步:处理加密/解密按上文三条链路实现 Keystore 密钥管理与 Cipher 加解密注意替换原来的 Base64 编解码与 IV 存储逻辑。第 5 步:删除兼容层代码Goldfinger 内部有GoldfingerMockAndroid 6.0 以下返回假实现等兼容代码迁移后这些都不再需要可以一并清理。Rx 场景怎么处理goldfinger-rx提供了RxGoldfinger.authenticate()这类 Observable 风格的 API。迁移方案有两种推荐直接在AuthenticationCallback回调里用PublishSubject桥接几行代码即可还原 Observable 体验或者保持响应式架构但用官方 API RxBinding 类工具自行封装参考 RxGoldfingerImpl.java 的实现思路你会发现它的核心也只是把回调转成Observable自己实现并不复杂。迁移避坑清单⚠️Android 13 权限变化需要声明USE_BIOMETRIC权限并移除已废弃的指纹权限⚠️锁屏凭据如果允许设备密码/图案作为备选需正确设置setAllowedAuthenticators与setNegativeButtonText两者不能同时使用⚠️加密后的存量数据旧数据是用 Goldfinger 的密钥生成的迁移后 Keystore 别名不一致会解密失败务必规划数据平滑迁移或提示用户重新录入⚠️混淆规则删除 Goldfinger 相关的 keep 规则改为 androidx.biometric 所需的配置迁移后的验证清单真机验证指纹/人脸认证成功、失败、取消三种回调验证多次错误后的锁定lockout行为验证加密数据在新老版本间能否正确解密覆盖 Android 6.0 ~ 最新系统的兼容性测试检查onAuthenticationError中的错误码映射是否完整总结Android-Goldfinger 停止维护对仍在使用的项目来说是一个明确的信号是时候迁移了。好在它基于 androidx.biometric 封装纯认证场景迁移成本极低加密/解密场景也只是把封装好的逻辑拆回来自己实现。按照本文的对应关系表和 5 步升级路径配合官方 BiometricPrompt 文档绝大多数项目都能在一天内完成核心迁移。迁移完成后你收获的不只是摆脱一个无人维护的依赖更是对 Android 生物识别底层机制更完整的掌控。趁现在依赖还简单尽早动手吧【免费下载链接】Android-GoldfingerAndroid library to simplify Biometric authentication implementation.项目地址: https://gitcode.com/gh_mirrors/an/Android-Goldfinger创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考