[MAUI 项目实战] 笔记App：程序设计

前言

有人说现在记事类app这么多，市场这么卷，为什么还想做一个笔记类App？

一来，去年小孩刚出生，需要一个可以记录喂奶时间的app，发现市面上没有一款app能够在两步内简单记录一个时间，可能iOS可以通过备忘录配合捷径做到快速记录，但是安卓上就没有类似的app。

二是，自去年做的音乐播放器以来，很长一段时间我在博客上的XF，MAUI都是在介绍局部的功能，[MAUI 项目实战]专题也很长没更新了，这次通过笔记类App做一次完整项目，包括如何上架MAUI应用等内容一并更新了。

一开始用MAUI简单做了一个功能，就记录喂奶量 + 喂奶时间 + 提醒。后期逐步做成一个可以动态添加摘要片段的功能。取名为《凡事摘要》。

目前安卓版本已发布打包，并上架腾讯应用商城：凡事摘要，iOS版本的部分页面还有问题需要调试，最近比较忙，我会抽出时间继续完善。在这个时间点我决定把App所有的代码都放在GitHub上，方便大家学习。也欢迎有兴趣的小伙伴一起参与。

框架

使用Abp框架，我之前写过如何 将Abp移植进.NET MAUI项目，本项目也是按照这篇博文完成项目搭建。

这次的项目，主要通过原型和工厂模式建设基于模板的笔记内容。

没有使用过多的跨平台特性，如果需要了解更多MAUI跨平台知识，请参考之前音乐播放器系列文章。

定义

• Note - 笔记，可以成整页打开的内容
• NoteTemplate - 笔记模板，或称为场景，是可以快速创建笔记的模板
• NoteSegment - 笔记片段，它是一个笔记（Note）的组成
• NoteSegmentTemplate - 笔记片段模板，对应场景中可快速创建笔记片段的模板
• NoteSegmentPayload - 笔记片段负载，存储具体笔记片段的内容
• NoteSegmentService - 笔记片段服务类，为笔记片段，或笔记片段模板提供增删改等具体的业务逻辑
• NoteSegmentServiceFactory - 笔记片段服务工厂，为笔记片段服务类提供工厂方法

核心类

INoteSegment：它是笔记片段的抽象类，模板类NoteSegmentTemplate和笔记片段类NoteSegment都实现了INoteSegment

它包含了笔记片段的属性，如标题、颜色、图标、是否隐藏、是否可删除、排序、状态、类型等。同时它关联一个笔记片段负载类INoteSegmentPayload

public interface INoteSegment
{
    string Color { get; set; }
    string Desc { get; set; }
    string Icon { get; set; }
    bool IsHidden { get; set; }
    bool IsRemovable { get; set; }
    int Rank { get; set; }
    string Status { get; set; }
    string Title { get; set; }
    string Type { get; set; }

    INoteSegmentPayload GetNoteSegmentPayload(string key);
    INoteSegmentPayload GetOrSetNoteSegmentPayload(string key, INoteSegmentPayload noteSegmentPayload);
    void SetNoteSegmentPayload(INoteSegmentPayload noteSegmentPayload);
}

INoteSegementService：凡事摘要拥有不同的笔记类型，如：时间戳片段，文本片段，文件片段等，App中可以通过添加片段按钮查看所有类型。

这些片段通过片段服务类（NoteSegementService）来描述该如何存储，使用Payload中的数据。

不同的片段类型，通过不同的片段服务类来实现。比如，在时间戳片段中，我们要存储当前时间和计算倒计时，而文件片段中，我们要存储文件路径，文件名，文件大小，文件类型等信息。

这些都是通过片段服务类来实现的。

具体类型如下：

类型	描述
DateTimeSegmentService	时间戳片段服务类
KeyValueSegmentService	数值片段服务类
FileSegmentService	文件片段服务类
TextSegmentService	文本片段服务类
TodoSegmentService	待办片段服务类
WeatherSegmentService	天气片段服务类
LocationSegmentService	地点片段服务类
TimerSegmentService	闹钟片段服务类
ContactSegmentService	联系人片段服务类
VoiceSegmentService	录音片段服务类
MediaSegmentService	媒体片段服务类
ScriptSegmentService	绘制片段服务类
DocumentSegmentService	文件片段服务类

片段服务类包含了一个INoteSegment，它是当前的笔记片段对象

INoteSegmentServiceFactory:

片段服务类的工厂类，除此之外还有一个INoteSegmentTemplateServiceFactory，他们都是根据笔记片段，或者笔记模板中的片段类型创建对应的片段服务类。

用于笔记的片段服务类的工厂类:

public interface INoteSegmentServiceFactory: ISingletonDependency
{
    INoteSegmentService GetNoteSegmentService(NoteSegment noteSegment);
}

用于笔记模板的片段服务类的工厂类

public interface INoteSegmentTemplateServiceFactory: ISingletonDependency
{
    INoteSegmentService GetNoteSegmentService(NoteSegmentTemplate noteSegmentTemplate);
}

NoteSegmentService作为笔记片段服务的基类，它继承了ViewModelBase，实际上服务基类是各笔记片段视图层的ViewModel，视图界面元素通过绑定服务类中的属性来显示或更新数据。

每一种服务类都对应的一个视图。渲染时，Xaml通过NoteSegmentDataTemplateSelector模板选择器来选择对应的视图。有关界面部分将在另一篇文章介绍。

项目地址

GitHub:MatoProductivity