Modules功能模块体系

Modules 功能模块体系位置Source/Modules每个模块通常包含Extension.cs / Extention.cs 注册入口 Options.cs 配置选项 Presenter.xaml UI 展示器 Themes/Generic.xaml 默认样式 Resources.*.resx 多语言资源模块列表模块功能H.Modules.About关于页面。H.Modules.Feedback反馈模块。H.Modules.Globalization多语言切换。H.Modules.Guide新手引导。H.Modules.Help帮助入口。H.Modules.Home首页模块。H.Modules.Identity用户、角色、权限管理。H.Modules.License授权、许可、会员管理。H.Modules.Login登录、注册、当前用户。H.Modules.Messages.Dialog对话框消息。H.Modules.Messages.Form表单消息。H.Modules.Messages.Notice通知消息。H.Modules.Messages.Snack轻提示消息。H.Modules.Operation操作日志。H.Modules.Project项目管理。H.Modules.Setting设置页面。H.Modules.SplashScreen启动画面。H.Modules.Sponsor赞助展示。H.Modules.Style样式配置。H.Modules.Theme主题切换。H.Modules.Upgrade自动升级。以登录模块为例AddLoginViewPresenter()注册登录界面。AddTestLoginService()注册测试登录服务。UseLoginOptions()把登录选项加入设置系统。如果要接真实后端替换ILoginService实现即可。以主题模块为例AddTheme()注册主题加载服务和主题选择界面。UseThemeOptions()加入主题配置。LoadThemeOptionsService根据配置加载资源字典。Modules 模块系统详解一、模块系统概述模块是 WPF-Control 框架的功能封装单元将相关的 UI、逻辑和配置打包在一起便于复用和组合。核心思想模块负责组合将服务和 UI 整合为可复用的功能单元。二、模块结构2.1 典型模块文件结构H.Modules.About/ ├── Extension.cs # 注册入口扩展方法 ├── Options.cs # 配置选项类 ├── Presenter.xaml # UI 展示器 ├── Presenter.xaml.cs # 展示器逻辑 ├── Themes/ │ └── Generic.xaml # 默认样式 └── Properties/ ├── Resources.resx # 中文资源 ├── Resources.en.resx # 英文资源 └── ... # 其他语言资源2.2 各文件职责文件作用关键字Extension.cs服务注册入口AddAbout(),UseAboutOptions()Options.cs配置选项IAboutOptions,[Display]属性Presenter.xamlUI 界面XAML 布局Presenter.xaml.cs视图逻辑继承IocTGeneric.xaml默认样式资源字典Resources.resx多语言资源国际化支持三、模块注册模式3.1 核心模式Add UsepublicstaticclassExtention{// 1. AddXXX注册服务到 IOC 容器publicstaticvoidAddAbout(thisIServiceCollectionservices,ActionIAboutOptionssetupActionnull){services.AddOptions();// 添加选项支持services.TryAdd(ServiceDescriptor.SingletonIAboutViewPresenter,AboutViewPresenter());// 配置选项回调if(setupAction!null)services.Configure(newActionAboutOptions(setupAction));}// 2. UseXXX启用配置加入设置系统publicstaticvoidUseAboutOptions(thisIApplicationBuilderservice,ActionIAboutOptionsactionnull){action?.Invoke(AboutOptions.Instance);IocSetting.Instance.Add(AboutOptions.Instance);// 加入设置系统}}3.2 使用流程publicpartialclassApp:ApplicationBase{// 第一步注册模块ConfigureServicesprotectedoverridevoidConfigureServices(IServiceCollectionservices){services.AddAbout(options{// 可选配置模块选项});}// 第二步启用配置ConfigureprotectedoverridevoidConfigure(IApplicationBuilderapp){app.UseAboutOptions(options{// 可选进一步配置});}}四、关键模块详解4.1 About 模块功能介绍显示应用的基本信息版本号、公司信息、隐私政策等。核心代码// Presenter 定义[Icon(FontIcons.Info)][Display(Name关于,GroupNameSettingGroupNames.GroupSystem)]publicclassAboutViewPresenter:IocAboutViewPresenter,IAboutViewPresenter,IAboutViewPresenter{// 继承 IocT 自动获得 Instance 属性}// Options 定义[Display(Name关于,GroupNameSettingGroupNames.GroupSystem)]publicclassAboutOptions:IocOptionInstanceAboutOptions,IAboutOptions{publicstringVersion{get;set;}publicstringCompany{get;set;}publicstringCopyright{get;set;}}使用示例// 显示关于页面Ioc.GetServiceIAboutViewPresenter().Show();// 或者使用命令ShowAboutCommand.Instance.Execute(null);4.2 Login 模块功能介绍提供登录、注册界面和认证服务。核心流程AddLoginViewPresenter() → 注册登录界面 Presenter AddTestLoginService() → 注册测试登录服务可替换 UseLoginOptions() → 加入设置系统 运行时 OnLogin() → ILoginService.Login() → 验证成功 → 显示主窗口扩展点// 注册测试登录服务services.AddTestLoginService();// 替换为真实后端services.AddSingletonILoginService,MyRealLoginService();4.3 Theme 模块功能介绍主题切换和样式管理。核心流程AddTheme() → 注册主题服务 UseThemeOptions() → 加入主题配置 LoadThemeOptionsService → 根据配置加载资源字典使用示例// 切换主题Ioc.GetServiceISwitchThemeViewPresenter().Switch(ThemeType.Dark);// 获取当前主题ThemeTypecurrentThemeOptions.Instance.ThemeType;4.4 Setting 模块功能介绍设置页面管理统一管理应用配置。核心特点自动收集所有IOption实现按分组显示设置项支持搜索和筛选五、模块分类5.1 模块功能矩阵类别模块功能说明基础模块About,Help,Feedback关于、帮助、反馈认证模块Identity,Login,License用户、角色、权限、登录、授权界面模块Theme,Style,Globalization主题、样式、多语言消息模块Dialog,Form,Notice,Snack对话框、表单、通知、轻提示功能模块Project,Operation,Guide,Upgrade项目管理、操作日志、新手引导、自动升级5.2 消息模块详解H.Modules.Messages/ ├── Dialog/ # 模态对话框 ├── Form/ # 表单消息 ├── Notice/ # 通知消息 └── Snack/ # 轻提示消息底部弹出使用示例// 对话框消息awaitIoc.GetServiceIMessageService().ShowMessageAsync(提示信息);// Snack 消息轻提示Ioc.GetServiceISnackMessageService().Show(操作成功);// 通知消息Ioc.GetServiceINoticeService().Send(newNoticeMessage{Title标题,Content内容});六、创建自定义模块6.1 步骤一定义接口publicinterfaceIMyModuleViewPresenter{voidShow();}publicinterfaceIMyModuleOptions{stringTitle{get;set;}boolEnabled{get;set;}}6.2 步骤二实现选项类[Icon(FontIcons.Star)][Display(Name我的模块,GroupName自定义)]publicclassMyModuleOptions:IocOptionInstanceMyModuleOptions,IMyModuleOptions{privatestring_title默认标题;[Display(Name标题)]publicstringTitle{get_title;set{_titlevalue;RaisePropertyChanged();}}privatebool_enabledtrue;[Display(Name启用)]publicboolEnabled{get_enabled;set{_enabledvalue;RaisePropertyChanged();}}}6.3 步骤三实现 Presenter[Icon(FontIcons.Star)][Display(Name我的模块,GroupName自定义)]publicclassMyModuleViewPresenter:IocMyModuleViewPresenter,IMyModuleViewPresenter,IMyModuleViewPresenter{publicvoidShow(){// 显示模块界面MyModuleWindowwindownewMyModuleWindow();window.ShowDialog();}}6.4 步骤四创建扩展方法publicstaticclassMyModuleExtension{publicstaticvoidAddMyModule(thisIServiceCollectionservices,ActionIMyModuleOptionssetupActionnull){services.AddOptions();services.TryAddSingletonIMyModuleViewPresenter,MyModuleViewPresenter();if(setupAction!null)services.Configure(newActionMyModuleOptions(setupAction));}publicstaticvoidUseMyModuleOptions(thisIApplicationBuilderapp,ActionIMyModuleOptionsactionnull){action?.Invoke(MyModuleOptions.Instance);IocSetting.Instance.Add(MyModuleOptions.Instance);}}6.5 步骤五注册和使用// 在 App.xaml.cs 中注册protectedoverridevoidConfigureServices(IServiceCollectionservices){services.AddMyModule(options{options.Title自定义标题;});}protectedoverridevoidConfigure(IApplicationBuilderapp){app.UseMyModuleOptions();}// 在代码中使用Ioc.GetServiceIMyModuleViewPresenter().Show();七、模块配置机制7.1 Options 模式// 定义配置类publicclassMyOptions:IocOptionInstanceMyOptions{publicstringName{get;set;}默认值;[Display(Name启用功能)]publicboolEnableFeature{get;set;}true;}// 注册配置services.ConfigureMyOptions(options{options.Name自定义名称;});// 获取配置MyOptions.Instance.Name;// 静态访问7.2 属性标记特性作用[Display]设置显示名称、分组、描述[Icon]设置图标[ReadOnly]标记只读属性[DefaultValue]设置默认值[PropertyItem]指定属性编辑器类型八、模块与服务的关系┌─────────────────────────────────────────────────────────────┐ │ Modules │ │ 功能模块组合UI 逻辑 │ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │ │ About │ │ Login │ │ Theme │ │ Setting │ │ │ └────┬────┘ └────┬────┘ └────┬────┘ └────┬────┘ │ │ │ │ │ │ │ │ ▼ ▼ ▼ ▼ │ ├─────────────────────────────────────────────────────────────┤ │ Services │ │ 能力提供层 │ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │ │ Logger │ │ Message │ │ Setting │ │ AppPath │ │ │ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │ ├─────────────────────────────────────────────────────────────┤ │ IOC │ │ 服务连接与管理 │ └─────────────────────────────────────────────────────────────┘九、最佳实践9.1 模块命名规范H.Modules.{功能名}/ ├── {功能名}Options.cs ├── {功能名}ViewPresenter.xaml ├── {功能名}ViewPresenter.xaml.cs ├── Extension.cs └── Themes/Generic.xaml9.2 扩展方法命名前缀含义示例AddXXX注册模块服务AddAbout(),AddLogin()UseXXXOptions启用配置UseAboutOptions(),UseThemeOptions()AddXXXService注册特定服务AddTestLoginService()9.3 配置选项设计// ✅ 推荐继承 IocOptionInstancepublicclassMyOptions:IocOptionInstanceMyOptions,IMyOptions{}// ✅ 推荐使用 Display 特性[Display(Name显示名称,GroupName分组名,Description描述)]publicstringProperty{get;set;}// ✅ 推荐提供默认值publicstringProperty{get;set;}默认值;十、总结模块系统是 WPF-Control 框架的功能组织核心封装性每个模块是独立的功能单元可组合性通过 Add/Use 模式灵活组合可扩展性轻松添加自定义模块配置化通过 Options 模式统一管理配置掌握模块系统的使用可以快速构建功能丰富的 WPF 应用程序。