Bitwarden Android：开源密码管理器客户端

项目简介

Bitwarden Android 是 Bitwarden 密码管理器与验证器（Authenticator）的 Android 客户端开源代码，使用 Kotlin 与 Jetpack Compose 构建。项目采用 GPL-3.0 许可证，代码托管在 GitHub，官网为 https://bitwarden.com。

应用支持手机与平板，横竖屏均可使用；最低支持 Android 10（SDK 29），目标 SDK 为 37。

主要功能

从项目依赖与更新说明可以确认的能力包括：

• 密码管理与登录项创建：可在生成器（Generator）标签页直接创建新的登录项。
• 自动填充（Autofill）：基于 AndroidX Autofill 构建内联填充界面，可在其他应用中快速填入账号密码。
• 生物识别解锁：通过 AndroidX Biometrics 使用指纹等生物特征或设备凭据解锁保险库，并针对 Keystore 授权瞬时失败做了保持解锁的处理。
• 条码扫描：借助 CameraX 与 ZXing 实现条码扫描与生成，用于验证器等功能。
• 本地加密存储：使用 AndroidX Security 管理密钥并加密文件与 SharedPreferences，Room3 提供本地数据持久化。
• 推送与崩溃上报：非 F-Droid 构建变体集成 Firebase Cloud Messaging 与 Crashlytics。
• 键盘导航与焦点状态：界面元素提供焦点边框，并改进键盘操作体验。

安装与使用

普通用户请从官方渠道获取应用，本仓库主要面向参与开发与构建的贡献者。README 给出的本地构建流程要点：

1. 克隆仓库：

git clone https://github.com/bitwarden/android

2. 在项目根目录创建 user.properties，按需写入：

   • gitHubToken：具有 read:packages 权限的 classic GitHub Personal Access Token。
   • localSdk：布尔值，决定是否从本地 maven 仓库加载 SDK。

3. 将 docs/bitwarden-style.xml 导入 Android Studio 的代码风格方案（Preferences > Editor > Code Style > Manage > Import）。

4. 配置 Gradle JDK 为 21 版本（Preferences > Build, Execution, Deployment > Build Tools > Gradle）。

5. 可选：在仓库根目录运行脚本安装 detekt pre-commit 钩子，提交前自动执行静态检查。

注意事项

• 代码需遵循 docs/STYLE_AND_BEST_PRACTICES.md 中的规范，提交 PR 前应先格式化，并避免在同一个提交中混合格式化与逻辑改动。
• 应用依赖 AndroidX 系列组件（Compose、Room3、Security、WorkManager 等）以及 Dagger Hilt、Retrofit、OkHttp、Coil、Timber、ZXing 等第三方库。
• 部分能力（推送、崩溃上报、应用内评价）仅在非 F-Droid 构建变体中提供。
• 项目以 GPL-3.0 发布，二次分发需遵守相应许可证条款。

本作品整理自 GitHub 开源项目 bitwarden/android，原作者 @bitwarden，许可证 GPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。