鸿蒙应用开发实战【93】— 实战短信批量导入完整流程

鸿蒙应用开发实战【93】— 实战短信批量导入完整流程

本文是「号码助手全栈开发系列」第 93 篇，持续更新中…
开源社区：https://openharmonycrossplatform.csdn.net

前言

短信批量导入是号码助手最具实用价值的功能之一：用户复制一条或多条包含验证码/注册通知的短信，系统自动识别出平台名和手机号，让用户一键创建应用绑定。本篇剖析从文本解析到入库的完整实现。

本篇涵盖：SmsParser 智能解析算法、Platform Keywords 匹配策略、PasteImportPage 候选列表 UI、剪贴板读取@ohos.pasteboard、候选采纳/忽略流程、跨表数据写入。

一、整体架构

剪贴板/手动输入 │ ▼ SmsParser.parse(text) ← 智能解析引擎 │ ▼ ParseResult[] ← 识别结果（平台名 + 手机号） │ ▼ PasteImportPage UI ← 候选列表展示（待确认/已采纳/已忽略） │ ├── 采纳 → AppBindingDao.create() + SmsCandidateDao.create() │ └── 忽略 → SmsCandidateDao.create('已忽略')

二、智能解析引擎 SmsParser

文件：features/sms/SmsParser.ets

2.1 解析输出

/** 单条解析候选结果 */exportinterfaceParseResult{platform:string// 识别到的平台/应用名称phone:string// 识别到的手机号raw:string// 原始输入文本片段}

2.2 平台关键词库（部分）

内置 60+ 个已知平台关键词，按行业分组、长词优先：

constPLATFORM_KEYWORDS:string[]=[// 银行（长词优先）'招商银行','工商银行','建设银行','农业银行','中国银行','交通银行','浦发银行','中信银行','光大银行','民生银行','平安银行','广发银行',// 支付 / 金融'支付宝','微信支付','云闪付','数字人民币',// 电商'拼多多','天猫','淘宝','京东','唯品会','小红书','得物','闲鱼',// 外卖餐饮'饿了么','美团外卖','美团',// 出行'滴滴出行','哈啰出行','滴滴',// 社交'微博','抖音','快手','QQ',// 内容娱乐'哔哩哔哩','B站','爱奇艺','优酷视频','腾讯视频',// 办公'钉钉','飞书','企业微信','腾讯会议',// ...'微信'// 放在最后避免"微信支付"被提前匹配]

2.3 长词优先策略

for(constkwofPLATFORM_KEYWORDS){if(trimmed.includes(kw)){// 避免已被更长词包含的短词letsubsumed=falsefor(constalreadyofmatched){if(already.includes(kw)){subsumed=truebreak}}if(!subsumed){platformSet.push(kw)matched.add(kw)}}}

例如文本中包含"携程旅行"，匹配到"携程旅行"后就不会再单独匹配"携程"。

2.4 手机号提取

constPHONE_PATTERN='(1[3-9]\\d{9})'// 中国大陆手机号constphoneReg=newRegExp(PHONE_PATTERN,'g')

2.5 组合策略

if(平台名&&手机号){// 笛卡尔积：每个平台名 × 每个手机号for(constplatformofplatformSet)for(constphoneofphoneSet)results.push({platform,phone,raw})}elseif(只有平台名){// 只有平台名}elseif(只有手机号){// 只有手机号}

三、PasteImportPage 页面实现

文件：pages/PasteImportPage.ets

3.1 剪贴板读取

privateasyncreadClipboard():Promise<void>{try{constboard=pasteboard.getSystemPasteboard()constdata=awaitboard.getData()consttext=data.getPrimaryText()if(text&&text.length>0){this.smsText=text promptAction.showToast({message:'已读取剪贴板内容'})}}catch(e){hilog.error(0x0000,'App','readClipboard failed:: %{public}s',JSON.stringify(e))promptAction.showToast({message:'无法读取剪贴板，请手动粘贴'})}}

3.2 解析触发

privatedoParse():void{this.parsing=trueconstresults=SmsParser.parse(this.smsText)this.candidates=results.map((r,idx)=>({key:`candidate_${Date.now()}_${idx}`,platform:r.platform,phone:r.phone,status:'待确认',raw:r.raw}))this.hasParseAttempted=truethis.parsing=false}

3.3 采纳一条候选（核心写入）

privateasyncadoptCandidate(key:string):Promise<void>{constitem=this.candidates.find(c=>c.key===key)if(!item||item.status!=='待确认')returntry{constnow=Date.now()// 写入 app_bindings 表awaitAppBindingDao.create({app_name:item.platform,icon_key:ICON_COLORS[Math.floor(Math.random()*ICON_COLORS.length)],category:'APP',card_id:selectedCardId,status:'使用中',remark:`来自短信识别，手机号：${item.phone}`,source:'短信识别',created_at:now,updated_at:now})// 写入 sms_candidates 表（持久化识别记录）awaitSmsCandidateDao.create({raw_text:item.raw,matched_platform:item.platform,matched_phone:item.phone,status:'已采纳',created_at:now})// 更新 UI 状态item.status='已采纳'promptAction.showToast({message:`已添加"${item.platform}"`})}catch(e){hilog.error(0x0000,'App','adoptCandidate failed:: %{public}s',JSON.stringify(e))}}

3.4 忽略一条候选

privateasyncignoreCandidate(key:string):Promise<void>{awaitSmsCandidateDao.create({raw_text:item.raw,matched_platform:item.platform,matched_phone:item.phone,status:'已忽略',created_at:Date.now()})item.status='已忽略'}

四、数据写入路径

采纳候选 ├── AppBindingDao.create() → app_bindings 表 │ app_name: "支付宝" │ card_id: 1 │ status: "使用中" │ source: "短信识别" └── SmsCandidateDao.create() → sms_candidates 表 raw_text: "【支付宝】验证码 1234，..." matched_platform: "支付宝" status: "已采纳"

五、实际解析演示

输入文本：

【支付宝】验证码 123456，您正在登录，如非本人操作请忽略。 【招商银行】您的验证码是 654321，请勿泄露。 【美团外卖】订单已送达，如有问题请联系 400-888-8888

解析结果：

注意：上述短信中没有手机号，只有平台名。如果文本包含「手机号 13800138000 正在注册 拼多多」，则会同时识别平台名和手机号。

六、卡号选择循环

// 通过 ActionMenu 让用户选择绑定到哪个卡号constresult=awaitpromptAction.showActionMenu({title:'选择绑定卡号',buttons:this.cards.map(c=>({text:`${c.label}·${c.phone_number}`,color:AppColors.TEXT}))})this.selectedCardIndex=result.index

小结

如果这篇文章对你有帮助，欢迎点赞👍、收藏⭐、关注🔔，你的支持是我持续创作的动力！

相关资源：

• 开源鸿蒙跨平台社区：https://openharmonycrossplatform.csdn.net
• HarmonyOS pasteboard API：https://developer.huawei.com/consumer/cn/doc/harmonyos-references/pasteboard
• HarmonyOS 官方文档：https://developer.huawei.com/consumer/cn/doc/
• HarmonyOS hilog文档：https://developer.huawei.com/consumer/cn/doc/harmonyos-references/hilog
• HarmonyOS testing：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/unit-test
• HarmonyOS 安全与权限：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/permissions-overview