Lesphere.Desktop.Controls 2.1.3

dotnet add package Lesphere.Desktop.Controls --version 2.1.3
                    
NuGet\Install-Package Lesphere.Desktop.Controls -Version 2.1.3
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Lesphere.Desktop.Controls" Version="2.1.3" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Lesphere.Desktop.Controls" Version="2.1.3" />
                    
Directory.Packages.props
<PackageReference Include="Lesphere.Desktop.Controls" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Lesphere.Desktop.Controls --version 2.1.3
                    
#r "nuget: Lesphere.Desktop.Controls, 2.1.3"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Lesphere.Desktop.Controls@2.1.3
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Lesphere.Desktop.Controls&version=2.1.3
                    
Install as a Cake Addin
#tool nuget:?package=Lesphere.Desktop.Controls&version=2.1.3
                    
Install as a Cake Tool

乐枢桌面框架

未来药店与乐枢控制台共用的 .NET 11 桌面组件。界面以未来药店的 AtomUI 样式为基准;后端公共能力归属同级 lesphere-framework,桌面框架不依赖业务应用或服务端程序集。

包与分类

只划分两个实际可独立使用的 NuGet 包,不为每个控件建立一个项目。

NuGet 包 目录 / 命名空间末级 组件与职责
Lesphere.Desktop.Controls Windowing WorkspaceTitleBar:内容树中的标题栏布局、公开窗口拖动与双击;WorkspaceTabOverflowPanel:公开溢出会话模板
同上 Tables DataGridSelectionSource<T>:表格当前页集合、稳定行键及单选状态
同上 Forms ReadOnlyDescriptions:详情字段的只读、复制与长文本展示
同上 Dialogs DialogPresets:表单/详情弹窗约定;ConfirmationDialogs:业务确认与关闭系统确认
同上 Themes 标题栏主题、列表、弹窗及工作中心样式;沿用 AtomUI 动态资源
Lesphere.Desktop.Local Storage StateStore、StateScope:加密本机存储与服务/租户/用户隔离
同上 Drafts DraftSession、DraftSnapshot:未提交文档的恢复点
同上 Transfers TransferJournal、TransferSession、TransferRecord:本机传输历史、进度会话与记录
同上 Preferences WindowPlacement:个人窗口尺寸与最大化偏好
同上 IO SizeLimitedWriteStream:有界写入,不把远程文件整体加载进内存
同上 Updates 签名清单、策略校验、有界下载、安全解压、程序目录切换与启动握手

src/Lesphere.Desktop.Updater 是独立更新可执行程序,不新增 NuGet 包。它必须复制到安装目录之外运行,重新检查签名策略、等待原客户端自行退出,再切换程序;新客户端初始化后通过当前用户命名管道确认。没有启动确认时尝试恢复上一程序目录,不回退业务数据库。当前尚未完成端到端安装及断电恢复验收,不能仅凭基础测试宣称自动升级可正式投用。

Controls 依赖 AtomUI 6.2.15 / Avalonia 12.1.6,不依赖本机数据库或业务 ViewModel。Local 不依赖 UI,不保存业务主表、权限或登录令牌。具体打印驱动、业务编辑器、导航服务与接口调用仍在应用内。

命名与归类规则

  1. 项目表示依赖边界,目录表示能力;目录和命名空间一致,例如 Tables/DataGridSelectionSource.cs 对应 Lesphere.Desktop.Controls.Tables。
  2. 一个公共类型一个文件,文件名与类型名一致;业务用途不清晰的 Common、Helpers、Utils、Manager 不作为收纳目录。
  3. 名字表达职责:控件用 TitleBar / Descriptions,配置用 Presets,快照用 Snapshot,记录用 Record,一段有开始和结束的操作用 Session。
  4. 包名已表达 Desktop / Local,内部类型不重复叠加前缀;不留下旧类型转发、兼容别名或重复实现。
  5. 公共界面只处理展示和交互。保存、鉴权、注销和宿主退出由应用执行;确认框只返回用户选择。
  6. 引入公共组件前先对照未来药店;两端存在差异时明确数据和行为差异,不能重新设计一套视觉样式冒充统一。
  7. 公共类和方法写中文 XML 注释,说明生命周期、状态范围与失败行为。

打包与引用

开发时将三个仓库放在同级目录。先在本仓库执行:

.\tools\pack.ps1
# 只改 Controls:在其 csproj 递增版本,再执行 .\tools\pack.ps1 -Package Controls。
# 只改 Local:在其 csproj 递增版本,再执行 .\tools\pack.ps1 -Package Local。

脚本严格构建并生成所选包,默认选择两个包;输出位于 .artifacts/packages/。发现目标版本已存在时,在构建前拒绝覆盖。未变化的包继续消费已有产物,不连带升级。没有全局环境修改,不自动发布到公网。

当前 Controls 为 2.1.3,Local 为 2.0.1,目标框架为 net11.0;Controls 使用 AtomUI 6.2.15 及 Avalonia 12.1.6 重新编译。2.1.3 新增两端共用的认证页主题与样式,统一浅色配色、输入框及按钮交互,不改变工作台主题。Local 2.0.1 补齐公开包说明,运行时行为不变。目标框架变化需要两套桌面同时升级并重新还原,不可直接替换旧运行目录中的 DLL。历史 Local 1.0.7 的包与缓存差异证据继续保留。

公共控件提供 UseLesphereDesktopControls(),通过 AtomUI 生成的包清单声明 DataGrid 及其 Desktop Controls 依赖;应用在 AppBuilder.UseAtomUI 回调中显式启用,不直接引用版本化注册组名称。主题样式仍由正常 AXAML 合并,不重排或替换 AtomUI 的根资源字典。

using Lesphere.Desktop.Controls.Themes;

// 配置回调只声明控件包;初始化、主题与字体提交由 AtomUI 管理。
builder.UseLesphereDesktopControls();

此前版本的迁移依据见 AtomUI 6.2.13 迁移说明,历史验收见 前端验收记录。

AtomUI 6.2.14 的工作区标题栏已迁入正常窗口内容树,溢出列表通过 OverflowPopupTemplate 使用公开会话;两端不再扫描内部滚动器或弹层。布局、接口及验收边界见 溢出兼容性记录。

两套桌面通过 PackageReference 使用包,版本集中在各自 Directory.Packages.props;正式版本的两个桌面包从 nuget.org 还原,本地 .artifacts/packages 用于发布前验证。业务能力包仍使用各自受控源。

<PackageReference Include="Lesphere.Desktop.Controls" />
<PackageReference Include="Lesphere.Desktop.Local" />

各应用只声明实际使用的包。执行 tools/publish-nuget.ps1 -PackOnly 可以复核已生成包的白名单、版本、依赖和构建文件摘要;移除 -PackOnly 才会上传。凭据仅从 NUGET_API_KEY 获取,不出现在命令参数、日志或包里。本机也可设置 LESPHERE_NUGET_PACKAGE_FAMILY=Desktop 后调用同级后端框架的既有本机凭据入口,调用结束恢复该选择;默认仍只发布后端三个包。

常用样式资源路径:

<StyleInclude Source="avares://Lesphere.Desktop.Controls/Themes/ListStyles.axaml" />
<StyleInclude Source="avares://Lesphere.Desktop.Controls/Themes/DialogStyles.axaml" />
<StyleInclude Source="avares://Lesphere.Desktop.Controls/Themes/WorkCenterStyles.axaml" />
<StyleInclude Source="avares://Lesphere.Desktop.Controls/Themes/AuthenticationStyles.axaml" />

WorkCenterStyles.axaml 以未来药店现有视觉值定义通知、传输、打印快捷弹层的尺寸、圆角、阴影,以及完整页面的间距、卡片和标题;不统一业务模型或收件、导出、打印规则。两端在各自视图中显式引入。

标题栏的 WorkspaceTitleBarTheme.axaml 是 ResourceDictionary,用 ResourceInclude 合并到窗口资源,再将主题赋给 WorkspaceTitleBar。工作区窗口设置 IsTitleBarVisible="False",在内容根布局首行放置 WorkspaceTitleBar,其 LeftAddOn 承载标签、RightAddOn 承载账号与操作区;标签的 OverflowPopupTemplate 使用同资源字典中的 WorkspaceTabOverflowTemplate。不要将该标题栏放回 NotifyCreateTitleBar 的装饰树。表单与详情配置分别通过 DialogPresets.Editor(...)、DialogPresets.Details(...) 创建。

验证

.\tools\pack.ps1
# 已有版本会被拒绝;后续按实际变化选择包并递增版本。
& ..\lesphere-pharmacy\tools\verify.ps1 -CaptureUi
& ..\lesphere-platform\tools\verify.ps1 -CaptureUi

必须串行运行。现有行为测试留在实际调用方,覆盖标签页、选择保持、弹窗、身份隔离、草稿和硬件凭据;不复制一套只断言文件名的测试。首次切换包引用必须还原;后续依赖未变可加 -SkipRestore。

本机目录、密钥、打印回执和清理边界见 桌面本机状态。测试仅使用隔离临时数据库。产物统一存于 bin、obj、.artifacts,不得将真实数据库或密钥当作缓存清理。

Product Compatible and additional computed target framework versions.
.NET net11.0 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
2.1.3 82 11/17/2026
2.1.2 92 11/16/2026