chinboy
5.3 KiB
AtomUI.Core 模块概览
AtomUI.Core 是 AtomUI 的框架入口和主题基础设施项目，RootNamespace 为 AtomUI。它承载主题、Token、动画、MotionScene、资源加载、反射扩展和通用工具，并引用独立的 AtomUI.Localization 运行时。
职责
- 提供
AppBuilder.WithAtomUIDefaultOptions()和Application.UseAtomUI()两个主要入口。 - 管理唯一运行时
ThemeManager、五阶段主题事务、稳定 ThemeContext、局部作用域图以及独立 TopLevel 的 context lease/resource bridge。 - 定义生成式全局/Control Own Token schema、所有 Control 可覆盖完整 Global Token 的规则、不可变
ThemeSnapshot、稳定资源键，以及SharedTokenResource/XxxTokenResource强类型资源扩展。 - 组合根
IAtomUIBuilder的主题与本地化子 Builder，并把ILanguageManager、ILocalizer暴露给应用。 - 提供动画 Transition、MotionScene、颜色与几何工具。
- 依赖
AtomUI.Native支撑窗口级底层能力。
关键目录
主题实现按照 主题系统架构 的职责边界组织：
| 目录 | 说明 |
|---|---|
Theme/ |
唯一运行时 ThemeManager、五阶段事务、ThemeContext、作用域图、TopLevel lease/bridge 及公开主题入口 |
Theme/Algorithms/ |
算法契约、默认/暗色/紧凑计算器、调色板和颜色计算辅助 |
Theme/Configuration/ |
ThemeConfig、ControlThemeConfig、配置规范化、继承与覆盖合并 |
Theme/Definitions/ |
主题来源、默认选择、XML v1、文件读取、语法模型、Schema 绑定和 diagnostics |
Theme/Schema/ |
生成式 Token schema、Control/算法 descriptor、ControlTheme asset descriptor 与 manifest 契约 |
Theme/Compilation/ |
纯 ThemeCompiler、不可变 ThemeSnapshot 和 Snapshot 缓存 |
Theme/Resources/ |
Snapshot-backed ResourceProvider、全局 SharedTokenResource、生成式 XxxTokenResource、ControlTheme asset manifest、resolver 和样式加载辅助 |
Theme/DesignTokens/ |
仅供编译阶段使用的 DesignToken、ControlToken builder、定义和 value converter |
Localization/ |
根 Builder 的本地化扩展；Catalog、Snapshot、Manager 和资源扩展位于 AtomUI.Localization 项目 |
Animations/ |
Avalonia Transition 扩展 |
MotionScene/ |
进入、离开、移动、折叠等 Motion 抽象，以及供上层控件复用的 internal 动效执行生命周期词汇 |
Assets/Themes/ |
内置主题定义 |
Reflection/、Input/、Media/、Utils/ |
面向上层控件复用的内部工具 |
对外关系
AtomUI.Core 被 AtomUI.Controls.Shared、AtomUI.Controls、AtomUI.Icons.*、AtomUI.Fonts.*、
AtomUI.Desktop.Controls 等项目引用。各 Control 包通过源生成器为每个对外可主题化 Control 提供独立 exact CLR
type/identity、允许零 Own Token 的 descriptor、ControlTheme asset manifest 和一次包级注册入口；Core 冻结
registry 后不扫描上层程序集或 AXAML。它对多个上层项目开放 InternalsVisibleTo，因此修改内部 API 时需要同时
检查上层 Control 包。
Core 拥有 AbstractControlDesignToken、ControlDesignTokenAttribute 和终端 descriptor 的运行时协议，但不拥有具体
Control 家族的共享视觉语义。跨 Desktop/Mobile 的抽象 Control Token 定义属于 AtomUI.Controls；Generator 在编译期
扁平化这些定义，Core 运行时不遍历继承链。完整契约见
Control Design Token 继承架构。
图片加载生命周期职责
Core 增加内部 IAtomUIOwnedService、Builder factory 收集和 ApplicationScope 的 attach/回滚/逆序 dispose。该机制供
Shared 的 ImageLoader 使用，但 Core 不定义图片 Source、请求、缓存、HTTP、codec 或控件状态，也不反向引用
AtomUI.Controls.Shared。
owned service 必须在 UseAtomUI() 构建阶段一次性冻结，按注册顺序 attach，启动失败和应用销毁按逆序清理。图片 loader 的
Application 映射由 Shared 的 ImageLoaderStore 管理；Core 不增加 ApplicationImageLoader、图片 service locator 或进程级
静态 cache。完整生命周期见
图片加载管线、并发与生命周期。
相关文档
- 内容展开与收起动效设计：共享动效职责与上层控件接入契约，实现证据由各控件维护。
- 主题系统架构
- Control Design Token 继承架构
- Semantic Part 系统设计
- AtomUI 本地化系统架构
- 主题定制指南
- 主题定义 XML v1 规范
- AtomUI Theme Definition XML Schema v1
- 启动与注册链路
- 运行平台策略
- 统一图片加载系统