1. 项目背景与需求分析
最近在开发一个需要频繁处理验证码的Android应用时，我发现手动输入验证码不仅效率低下，还容易出错。于是萌生了开发一个专门用于管理验证码的应用的想法——一个能够自动分类、存储和快速检索验证码的工具。
这类工具的核心价值在于：
- 解决验证码管理混乱的问题（短信、邮件、APP推送混在一起）
- 提供快速检索和复制功能，避免手动输入错误
- 实现验证码的自动分类和过期提醒
- 保护敏感信息，防止验证码泄露
2. 技术方案设计
2.1 整体架构
采用经典的MVVM架构：
- Model层：Room数据库存储验证码数据
- ViewModel层：处理业务逻辑和数据转换
- View层：Jetpack Compose构建UI
kotlin复制// 数据库实体示例
@Entity(tableName = "captchas")
data class Captcha(
@PrimaryKey(autoGenerate = true) val id: Int = 0,
val code: String,
val source: String, // 来源：短信/邮件/APP
val receivedTime: Long,
val expireTime: Long,
val isUsed: Boolean = false
)
2.2 关键功能实现
2.2.1 短信验证码自动捕获
通过Android的SMS Retriever API实现：
- 在AndroidManifest.xml中声明权限
- 实现SMSRetrieverClient
- 注册广播接收器监听短信
kotlin复制// 短信监听实现
val client = SmsRetriever.getClient(context)
val task = client.startSmsRetriever()
task.addOnSuccessListener {
// 短信监听启动成功
}
task.addOnFailureListener {
// 处理错误
}
2.2.2 验证码智能识别
使用正则表达式匹配常见验证码格式：
kotlin复制// 常见验证码正则模式
val patterns = listOf(
"\\b\\d{4}\\b", // 4位数字
"\\b\\d{6}\\b", // 6位数字
"[A-Z0-9]{4,8}" // 字母数字组合
)
2.2.3 数据存储方案
采用Room数据库+DataStore配置：
- Room负责结构化数据存储
- DataStore存储用户偏好设置
- 使用Flow实现数据观察
3. 核心功能实现细节
3.1 自动分类功能
实现原理：
- 分析验证码来源（短信、邮件、APP通知）
- 提取发送方标识（如手机号、邮箱、APP名称）
- 基于关键词匹配自动分类
kotlin复制fun autoCategorize(content: String): String {
return when {
content.contains("支付宝") -> "支付宝"
content.contains("微信") -> "微信"
content.contains("银行") -> "银行"
else -> "其他"
}
}
3.2 过期自动清理
通过WorkManager实现定时任务：
kotlin复制val cleanupRequest = PeriodicWorkRequestBuilder<CleanupWorker>(
1, TimeUnit.HOURS // 每小时检查一次
).build()
WorkManager.getInstance(context).enqueue(cleanupRequest)
清理逻辑：
kotlin复制override suspend fun doWork(): Result {
val expired = database.captchaDao()
.getExpiredCaptchas(System.currentTimeMillis())
database.captchaDao().deleteCaptchas(expired)
return Result.success()
}
3.3 安全保护措施
- 数据加密：
kotlin复制// 使用AndroidKeyStore加密敏感数据
val keyGenerator = KeyGenerator.getInstance(
KeyProperties.KEY_ALGORITHM_AES,
"AndroidKeyStore"
)
keyGenerator.init(
KeyGenParameterSpec.Builder(
"captcha_key",
KeyProperties.PURPOSE_ENCRYPT or KeyProperties.PURPOSE_DECRYPT
).setBlockModes(KeyProperties.BLOCK_MODE_GCM)
.setEncryptionPaddings(KeyProperties.ENCRYPTION_PADDING_NONE)
.build()
)
- 应用锁：支持生物识别/密码保护
4. UI设计与用户体验
4.1 主界面设计
采用Jetpack Compose实现：
- 顶部：搜索栏
- 中部：分类标签
- 底部：验证码列表
- 浮动按钮：手动添加
kotlin复制@Composable
fun CaptchaListScreen(viewModel: CaptchaViewModel) {
val captchas by viewModel.captchas.collectAsState()
LazyColumn {
items(captchas) { captcha ->
CaptchaItem(captcha, onCopy = {
viewModel.copyToClipboard(captcha.code)
})
}
}
}
4.2 关键交互细节
- 复制到剪贴板：
kotlin复制fun copyToClipboard(text: String) {
val clipData = ClipData.newPlainText("captcha", text)
clipboardManager.setPrimaryClip(clipData)
}
- 滑动删除：
kotlin复制val dismissState = rememberDismissState(
confirmValueChange = {
if (it == DismissValue.DismissedToEnd) {
viewModel.deleteCaptcha(captcha)
}
true
}
)
5. 性能优化与测试
5.1 数据库优化
- 添加索引：
kotlin复制@Entity(tableName = "captchas", indices = [
Index(value = ["source"]),
Index(value = ["expireTime"])
])
- 使用Paging3处理大量数据：
kotlin复制val pagingSource = database.captchaDao().getCaptchasPagingSource()
val pager = Pager(
config = PagingConfig(pageSize = 20),
pagingSourceFactory = { pagingSource }
)
5.2 内存优化
- 图片资源压缩
- 使用Coil高效加载图片
- 避免在Composable中创建对象
6. 实际开发中的经验总结
6.1 遇到的典型问题
-
短信权限问题：
- 在Android 10+上需要动态申请READ_SMS权限
- 解决方案：使用SMS Retriever API避免直接请求敏感权限
-
后台限制：
- 某些厂商系统会限制后台服务
- 解决方案：添加前台服务通知，引导用户关闭电池优化
6.2 性能优化技巧
- 对于频繁更新的UI，使用
derivedStateOf减少重组：
kotlin复制val filteredCaptchas by remember {
derivedStateOf {
captchas.filter { it.source == currentFilter }
}
}
- 数据库操作使用协程避免阻塞UI线程
6.3 安全建议
- 不要存储原始短信内容
- 加密存储敏感验证码
- 提供快速清除所有数据的功能
7. 扩展功能思路
- 多设备同步：通过Firebase或自建服务器实现
- 自动填充：使用Android Autofill框架
- 验证码统计：分析验证码使用频率和来源
- 自定义规则：允许用户设置自己的验证码匹配规则
这个项目从构思到实现大约花费了两周时间，核心难点在于平衡功能性和安全性。在实际使用中，验证码管理效率提升了至少3倍，特别是对于需要处理多个账号的用户来说非常实用。如果要做进一步优化，我会考虑加入端到端加密的多设备同步功能。