Skip to content
L1ypPublic

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

TotpApp

一个基于 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:assembleDebug

Windows 下使用:

.\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 批量迁移格式。

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages