designing-avalonia-customcontrol-architecture

用途：在创建 AvaloniaUI 桌面应用新项目或设计控件架构时，定义以 CustomControl 为基础的基本解决方案结构。主要能力：以自定义控件库项目组织代码，每个控件项目下含 Properties（AssemblyInfo.cs）、Themes（Generic.axaml 作为 ControlTheme 定义，各控件单独 axaml 主题文件）以及各控件 .cs 文件；通过 ControlTheme 实现主题与逻辑完全分离，借助 CSS Classes 提供灵活样式变体，用伪类（如 :pointerover、:pressed）管理状态，通过 ResourceInclude 实现主题模块化，并支持按文件拆分以利于团队协作。使用方式：生成 AXAML 代码时使用 CustomControl 配合 ControlTheme；在普通 ResourceDictionary（Generic.axaml、Styles 等）中使用 ResourceInclude，仅在 Application.Resources（App.axaml）中使用 MergeResourceInclude。与 WPF 的关键差异：文件扩展名 .xaml 对 .axaml；样式定义 Style + ControlTemplate 对 ControlTheme；状态管理 Trigger、DataTrigger 对伪类与样式选择器；CSS 支持 WPF 无、AvaloniaUI 有（Classes 属性）；资源合并 MergedDictionaries + ResourceDictionary 对 MergedDictionaries + ResourceInclude；依赖属性 DependencyProperty 对 StyledProperty、DirectProperty。限制：资料未提供安装命令、代码内容与具体使用步骤的更多细节，部分事实暂未提供。