当前位置：首页 > news >正文

【maaath】Flutter for OpenHarmony 短信管理应用实战

news 2026/5/4 6:30:17

Flutter for OpenHarmony 短信管理应用实战

作者：maaath

欢迎加入开源鸿蒙跨平台社区： https://openharmonycrossplatform.csdn.net

前言

在移动应用开发领域，跨平台框架一直是开发者关注的焦点。Flutter 作为 Google 推出的 UI 框架，以其高效的渲染引擎和丰富的组件库著称。而 OpenHarmony 作为国产操作系统的新兴力量，正在吸引越来越多的开发者加入其生态建设。本文将通过一个实际的短信管理应用案例，探索 Flutter 在 OpenHarmony 平台上的开发实践，实现真正的跨平台开发。

项目概述

本次实践的短信管理应用是一个功能完整的移动应用，包含以下核心功能模块：

会话管理：支持查看、搜索、筛选短信会话
消息收发：模拟消息发送功能，支持送达状态展示
模板管理：预设快捷回复模板，提高沟通效率
垃圾拦截：基于关键词的智能垃圾短信过滤
数据统计：实时展示短信数据的各项指标
备份导出：支持数据的导出和导入

数据模型设计

良好的数据模型是应用架构的基础。在 Flutter 实现中，我们采用 Dart 语言定义数据类：

classSmsConversation{finalStringid;finalStringcontactName;finalStringcontactPhone;finalStringavatar;finalStringlastMessage;finalint lastMessageTime;finalint unreadCount;finalbool isPinned;finalbool isBlocked;finalbool isFavorite;finalList<SmsMessage>messages;SmsConversation({requiredthis.id,requiredthis.contactName,requiredthis.contactPhone,requiredthis.avatar,requiredthis.lastMessage,requiredthis.lastMessageTime,this.unreadCount=0,this.isPinned=false,this.isBlocked=false,this.isFavorite=false,this.messages=const[],});}enumMessageStatus{sending,sent,delivered,failed}enumMessageType{text,template,spam}

相比 ETS 的 interface 定义，Dart 的 class 提供了更强的面向对象特性，包括构造函数、getter/setter 以及方法定义。这种设计使得数据模型更加健壮，也便于后续的扩展和维护。

状态管理方案

在 Flutter 中，状态管理是开发中的核心环节。本项目采用 Provider 模式，这是一种轻量级且易于理解的状态管理方案：

classSmsViewModelextendsChangeNotifier{List<SmsConversation>_conversations=[];List<SmsTemplate>_templates=[];SmsSettings_settings=SmsSettings();List<SmsConversation>getconversations=>_conversations;Future<void>loadConversations()async{// 从本地存储加载数据finalprefs=awaitSharedPreferences.getInstance();finaljsonStr=prefs.getString('conversations');if(jsonStr!=null){finalList<dynamic>jsonList=json.decode(jsonStr);_conversations=jsonList.map((e)=>SmsConversation.fromJson(e)).toList();}else{// 使用模拟数据_conversations=SmsMockData.generateMockConversations();}notifyListeners();}Future<void>sendMessage(StringconversationId,Stringcontent)async{finalmessage=SmsMessage(id:'msg_${DateTime.now().millisecondsSinceEpoch}',conversationId:conversationId,content:content,timestamp:DateTime.now().millisecondsSinceEpoch,isIncoming:false,status:MessageStatus.sending,);// 更新本地状态finalindex=_conversations.indexWhere((c)=>c.id==conversationId);if(index!=-1){_conversations[index].messages.insert(0,message);_conversations[index].lastMessage=content;_conversations[index].lastMessageTime=message.timestamp;}notifyListeners();// 模拟发送过程awaitFuture.delayed(Duration(milliseconds:500));message.status=MessageStatus.sent;notifyListeners();awaitFuture.delayed(Duration(seconds:1));message.status=MessageStatus.delivered;notifyListeners();}}

这种设计将业务逻辑与 UI 分离，使得代码结构更加清晰。当数据发生变化时，通过notifyListeners()通知 UI 层更新界面，实现了响应式编程。

会话列表页面实现

会话列表是短信应用的核心页面之一。在 Flutter 中，我们使用 ListView.builder 实现高效的列表渲染：

classSmsListPageextendsStatelessWidget{finalList<SmsConversation>conversations;finalFunction(SmsConversation)onConversationTap;constSmsListPage({Key?key,requiredthis.conversations,requiredthis.onConversationTap,}):super(key:key);@overrideWidgetbuild(BuildContextcontext){// 分离置顶和非置顶会话finalpinned=conversations.where((c)=>c.isPinned).toList();finalnormal=conversations.where((c)=>!c.isPinned).toList();returnListView.builder(itemCount:pinned.length+normal.length,itemBuilder:(context,index){finalconversation=index<pinned.length?pinned[index]:normal[index-pinned.length];return_ConversationItem(conversation:conversation,onTap:()=>onConversationTap(conversation),);},);}}class_ConversationItemextendsStatelessWidget{finalSmsConversationconversation;finalVoidCallbackonTap;const_ConversationItem({requiredthis.conversation,requiredthis.onTap,});@overrideWidgetbuild(BuildContextcontext){returnListTile(leading:Stack(children:[CircleAvatar(radius:25,backgroundColor:Colors.grey[200],child:Text(conversation.avatar,style:TextStyle(fontSize:20)),),if(conversation.unreadCount>0)Positioned(right:0,top:0,child:Container(padding:EdgeInsets.all(4),decoration:BoxDecoration(color:Colors.red,shape:BoxShape.circle,),child:Text(conversation.unreadCount>99?'99+':conversation.unreadCount.toString(),style:TextStyle(color:Colors.white,fontSize:10),),),),],),title:Row(children:[if(conversation.isPinned)Padding(padding:EdgeInsets.only(right:4),child:Text('📌',style:TextStyle(fontSize:12)),),Expanded(child:Text(conversation.contactName,maxLines:1,overflow:TextOverflow.ellipsis,style:TextStyle(fontWeight:conversation.unreadCount>0?FontWeight.bold:FontWeight.w500,),),),],),subtitle:Text(conversation.lastMessage,maxLines:1,overflow:TextOverflow.ellipsis,style:TextStyle(color:Colors.grey),),trailing:Text(_formatTime(conversation.lastMessageTime),style:TextStyle(color:Colors.grey,fontSize:12),),onTap:onTap,);}String_formatTime(int timestamp){finalnow=DateTime.now().millisecondsSinceEpoch;finaldiff=now-timestamp;finaloneDay=24*60*60*1000;if(diff<60*1000)return'刚刚';if(diff<60*60*1000)return'${(diff/60000).floor()}分钟前';if(diff<oneDay){finaldate=DateTime.fromMillisecondsSinceEpoch(timestamp);return'${date.hour.toString().padLeft(2, '0')}:${date.minute.toString().padLeft(2, '0')}';}return'${date.month}/${date.day}';}}

Flutter 的 widget 组合特性在这里得到了充分体现。通过合理拆分组件，我们将复杂的列表项分解为可复用的子组件，既提高了代码的可读性，也便于后续的维护和测试。

垃圾短信拦截功能

智能拦截是现代短信应用的标配功能。在 Flutter 实现中，我们采用规则引擎的方式：

classSpamFilterService{finalList<SpamRule>_rules=[];Future<void>loadRules()async{// 从存储加载规则}boolcheckSpam(Stringcontent){for(finalrulein_rules){if(!rule.isEnabled)continue;try{finalregex=RegExp(rule.pattern);if(regex.hasMatch(content)){returntrue;}}catch(e){// 正则表达式无效时，使用简单匹配if(content.contains(rule.keyword)){returntrue;}}}returnfalse;}Future<void>addRule(Stringkeyword,SpamActionaction)async{finalrule=SpamRule(id:'spam_${DateTime.now().millisecondsSinceEpoch}',keyword:keyword,pattern:'.*$keyword.*',action:action,isEnabled:true,);_rules.add(rule);await_saveRules();}}

这种设计允许用户自定义拦截规则，通过关键词匹配和正则表达式两种方式，灵活应对各类垃圾短信。

设置页面与数据持久化

应用设置页面的实现展示了 Flutter 在表单处理方面的便利性：

classSmsSettingsPageextendsStatelessWidget{finalSmsSettingssettings;finalFunction(String,dynamic)onSettingChanged;constSmsSettingsPage({Key?key,requiredthis.settings,requiredthis.onSettingChanged,}):super(key:key);@overrideWidgetbuild(BuildContextcontext){returnScaffold(appBar:AppBar(title:Text('短信设置')),body:ListView(children:[_buildSection('基础设置',[_buildSwitchTile('送达报告','接收短信送达回执',Icons.check_circle_outline,settings.deliveryReport,(value)=>onSettingChanged('deliveryReport',value),),_buildSwitchTile('自动备份提醒','定期提醒备份短信',Icons.notifications_outlined,settings.enableBackupReminder,(value)=>onSettingChanged('enableBackupReminder',value),),]),_buildSection('过滤设置',[_buildSwitchTile('垃圾短信过滤','自动识别并拦截垃圾短信',Icons.block,settings.enableSpamFilter,(value)=>onSettingChanged('enableSpamFilter',value),),]),],),);}Widget_buildSection(Stringtitle,List<Widget>children){returnColumn(crossAxisAlignment:CrossAxisAlignment.start,children:[Padding(padding:EdgeInsets.fromLTRB(16,16,16,8),child:Text(title,style:TextStyle(color:Colors.grey)),),...children,],);}}