CodeWF.AvaloniaControls.Dock.Themes 12.0.5.2

CodeWF.AvaloniaControls.Dock

名称	NuGet	下载量
CodeWF.AvaloniaControls.Dock
CodeWF.AvaloniaControls.Dock.Themes

面向 Avalonia 12 的 Dock 扩展控件与主题资源。本仓库将可复用的 Dock 控件和 Dock 主题包拆分维护，应用可以按需只引用需要的部分。

仓库规范

• 当前版本：12.0.4.12，版本号统一维护在根目录 Directory.Build.props 的 <Version> 节点。
• NuGet 包项目统一支持 net8.0;net10.0；Demo、App、测试与内部应用项目统一使用 net11.0 / net11.0-windows。
• 根目录 logo.svg、logo.png、logo.ico 是唯一图标源，子工程只通过 MSBuild Link 引用，不维护图标副本。
• 运行时帮助、Markdown 示例、内置备忘录、设计说明等业务文档按功能保留；仓库级入口文档使用根目录 README.md 和 UpdateLog.md。

安装

Install-Package CodeWF.AvaloniaControls.Dock
Install-Package CodeWF.AvaloniaControls.Dock.Themes

如果应用本身还没有引用 Semi，也需要添加 Semi.Avalonia，因为 CodeWF 的 Tool 标题栏会复用 Semi 色彩资源。

Install-Package Semi.Avalonia

主题配置

<Application
    xmlns:codewf="https://codewf.com"
    xmlns:fluent="clr-namespace:Avalonia.Themes.Fluent;assembly=Avalonia.Themes.Fluent"
    xmlns:semi="https://irihi.tech/semi">
  <Application.Styles>
    <fluent:FluentTheme />
    <semi:SemiTheme Locale="zh-CN" />
    <codewf:DockSemiTheme />
  </Application.Styles>
</Application>

DockSemiTheme 会加载开源的 Dock.Avalonia.Themes.Fluent Dock 主题，并应用 CodeWF 对 Tool chrome 按钮和 Tool 标题栏的细节调整。请保留 FluentTheme，用于 Dock 基础布局样式链；同时在 DockSemiTheme 之前加载 SemiTheme，保证 SemiColorText0、SemiColorFill0、SemiColorBorder 等 Semi 资源键可用。

从旧配置升级时，请将 DockCodeWFTheme 替换为 DockSemiTheme。本主题包不依赖非开源的 Semi.Avalonia.Dock 包。

Tool 标题栏

DockSemiTheme 提供 CodeWFToolChromeControlTheme，用于需要紧凑商务风格标题栏的 Tool 面板。默认标题左对齐，使用中性色文本，不使用彩色激活标题样式，并将关闭按钮保持在右侧。

应用可以覆盖 CodeWFToolTitleTabHeaderTemplate 来提供 Tool 专用标题图标，也可以覆盖 CodeWFToolTitleBarContentTemplate 来提供右侧标题栏内容。应用专用图标和操作应留在应用层；Dock 包只提供共享的标题栏结构和资源。

仓库结构

• src/CodeWF.AvaloniaControls.Dock：可复用的 Dock 控件扩展
• src/CodeWF.AvaloniaControls.Dock.Themes：独立的 Fluent 基础 Dock 主题包，复用 Semi 色彩资源键
• src/CodeWF.AvaloniaControls.DockReactiveUIDemo：包含嵌套 Dock 与进程嵌入说明的 ReactiveUI 示例
• CodeWF.AvaloniaControls.Dock.slnx：Dock 库、主题包和示例项目的解决方案视图

脚本

• pack.bat：还原、构建并打包 CodeWF.AvaloniaControls.Dock 和 CodeWF.AvaloniaControls.Dock.Themes 到 artifacts/packages
• publish_all.bat：将所有 Dock 示例应用发布到 publish/
• publishbase.bat：示例发布脚本使用的共享发布辅助脚本

说明

• CodeWF.AvaloniaControls.DockReactiveUIDemo 保留 Avalonia.Themes.Fluent 作为基础样式和布局链，然后加载 SemiTheme，使 Dock 标题栏资源可以复用 Semi 色彩令牌。
• Prism.DryIoc.Avalonia 固定在 8.1.97.11073，因为 9.x 分支是商业版本。
• 控件包不依赖 Semi。主题包只引用 MIT 许可的 Semi.Avalonia 包来共享色彩资源，不包含 Semi.Avalonia.Dock 或 Ursa 依赖。
• NuGet 包包含根目录下的简单 logo 资源：logo.png、logo.svg 和 logo.ico。

第三方开源审计

2026-06-02 根据 NuGet 元数据、还原后的 project.assets.json、包 nuspec 文件以及上游源码和许可证链接完成检查。优先采用 MIT、Apache-2.0、BSD 许可证。源码可见但不属于优先许可证的依赖，在使用前必须复审。

整改内容：

• 移除原有 Dock 主题路径，改为使用开源的 Dock.Avalonia.Themes.Fluent 主题。
• 将 DockSemiTheme 接入 Fluent Dock 资源，并叠加 CodeWF Tool chrome 细节调整。
• 复用开源 Semi 色彩资源，用于 CodeWF Tool 标题栏，不使用非开源的 Semi.Avalonia.Dock 包。
• 移除依赖非 Fluent 主题键的自维护 Dock XAML 资源。

传递依赖检查结果：当前还原的依赖资源均源码可见且许可证可追溯。未使用闭源或黑盒 Dock 主题包。

Package Versioning Convention

Keep NuGet package versions and Central Package Management settings in Directory.Packages.props, including shared version properties such as AvaloniaVersion. Keep Directory.Build.props focused on build, compiler, and NuGet package metadata. When referenced, VC-LTL and YY-Thunks should use their latest prerelease versions for OS platform compatibility.