名称:avalonia-zafiro-development 描述:使用 Zafiro 工具包进行 Avalonia UI 开发的强制性技能、约定和行为规则。
Avalonia Zafiro 开发
此技能定义了使用 Avalonia UI 和 Zafiro 工具包开发跨平台应用程序的强制性约定和行为规则。这些规则优先考虑可维护性、正确性和函数式反应式方法。
核心支柱
- 函数式反应式 MVVM:使用 DynamicData 和 ReactiveUI 的纯 MVVM 逻辑。
- 安全性与可预测性:使用
Result类型进行显式错误处理,避免使用异常进行流程控制。 - 跨平台卓越性:严格保持 ViewModels 独立于 Avalonia,并优先使用组合而非继承。
- Zafiro 优先:利用现有的 Zafiro 抽象和辅助功能,避免冗余。
指南
- 核心技术与架构:基本技能和架构原则。
- 命名与编码标准:命名、字段和错误处理的规则。
- Avalonia、Zafiro 与反应式规则:用户界面、Zafiro 集成和 DynamicData 管道的具体指南。
- Zafiro 快捷方式:常见 Rx/Zafiro 操作的简明映射。
- 常见模式:高级模式,如
RefreshableCollection和验证。
编码前流程
- 先搜索:在代码库中搜索类似实现或现有的 Zafiro 辅助功能。
- 可重用扩展:如果辅助功能缺失,建议创建新的可重用扩展方法,而不是内嵌复杂逻辑。
- 反应式管道:确保在适用时使用 DynamicData 操作符,而不是普通 Rx。