一个基于 Kotlin Multiplatform 与 Compose Multiplatform 的 Android 动态口令应用原型,交互风格遵循 Material 3。应用面向 Android 16(targetSdk 36),并使用 compileSdk 37 以兼容 Compose 1.12 的最新稳定依赖。
- RFC 6238 TOTP(HMAC-SHA1、6 位、30 秒周期),并用官方测试向量校验。
- 使用 Google Code Scanner 扫描标准
otpauth://totp二维码,无需申请相机权限。 - 同一服务器可添加任意多个账号,每条记录拥有独立标识。
- 每个账号可填写独立备注,便于区分账号用途。
- 创建、重命名和删除分组;删除分组时账号会自动转为未分组。
- 按分组筛选,或按服务器、账号、备注搜索。
- Material 3 动态取色、深色模式、边到边布局与自适应网格。
- 可设置默认隐藏验证码,点击后仅临时显示 10 秒。
- 账号、备注、分组和 TOTP 密钥自动保存到本地,应用重启后恢复。
- 本地状态使用 Android Keystore 管理的 AES-256-GCM 密钥加密,再由 DataStore 原子写入。
- 支持注册、登录、修改/重置密码,以及显式上传或下载 Spring Boot 云端保管库。
- 云端服务与系统管理后台已拆分到独立项目
E:\android-work\TotpAppAdmin。
androidApp:Android 应用入口,包名为com.l1yp.totp,使用 AGP 9 内置 Kotlin,targetSdk 36。shared:KMP 共享模块,包含 Compose UI、状态容器、存储抽象和纯 Kotlin TOTP 实现;Android 端接入加密 DataStore,当前配置 Android 与 JVM 目标。E:\android-work\TotpAppAdmin\backend:独立 Spring Boot + Jimmer 服务,包含认证、加密保管库、Flyway 和基础 RBAC。E:\android-work\TotpAppAdmin\web:Vue 3 管理端,包含用户、角色、权限、菜单和登录日志管理。
独立 Android 入口与 Android-KMP library plugin 的组合符合 AGP 9 的推荐结构,也便于后续增加 iOS、Desktop 及对应平台的安全存储实现。
需要 JDK 17 或更高版本,以及 Android SDK Platform 37。
./gradlew :shared:desktopTest
./gradlew :androidApp:assembleDebugWindows 下使用:
.\gradlew.bat :shared:desktopTest
.\gradlew.bat :androidApp:assembleDebug
# 后端与管理端请在 E:\android-work\TotpAppAdmin 中运行 Full Stack 配置云端同步采用显式上传/下载与版本号冲突保护,不会在后台静默覆盖本地数据。Android Debug 默认连接 http://127.0.0.1:8080,USB 调试前运行 adb reverse tcp:8080 tcp:8080;生产发布前应改为 HTTPS 服务地址。二维码当前支持标准 SHA1 TOTP,不支持 HOTP、SHA256/512 或 Google Authenticator 批量迁移格式。