Lesphere.Desktop.Local
2.0.1
dotnet add package Lesphere.Desktop.Local --version 2.0.1
NuGet\Install-Package Lesphere.Desktop.Local -Version 2.0.1
<PackageReference Include="Lesphere.Desktop.Local" Version="2.0.1" />
<PackageVersion Include="Lesphere.Desktop.Local" Version="2.0.1" />
<PackageReference Include="Lesphere.Desktop.Local" />
paket add Lesphere.Desktop.Local --version 2.0.1
#r "nuget: Lesphere.Desktop.Local, 2.0.1"
#:package Lesphere.Desktop.Local@2.0.1
#addin nuget:?package=Lesphere.Desktop.Local&version=2.0.1
#tool nuget:?package=Lesphere.Desktop.Local&version=2.0.1
乐枢桌面框架
未来药店与乐枢控制台共用的 .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,不保存业务主表、权限或登录令牌。具体打印驱动、业务编辑器、导航服务与接口调用仍在应用内。
命名与归类规则
- 项目表示依赖边界,目录表示能力;目录和命名空间一致,例如
Tables/DataGridSelectionSource.cs对应Lesphere.Desktop.Controls.Tables。 - 一个公共类型一个文件,文件名与类型名一致;业务用途不清晰的
Common、Helpers、Utils、Manager不作为收纳目录。 - 名字表达职责:控件用
TitleBar / Descriptions,配置用Presets,快照用Snapshot,记录用Record,一段有开始和结束的操作用Session。 - 包名已表达
Desktop / Local,内部类型不重复叠加前缀;不留下旧类型转发、兼容别名或重复实现。 - 公共界面只处理展示和交互。保存、鉴权、注销和宿主退出由应用执行;确认框只返回用户选择。
- 引入公共组件前先对照未来药店;两端存在差异时明确数据和行为差异,不能重新设计一套视觉样式冒充统一。
- 公共类和方法写中文 XML 注释,说明生命周期、状态范围与失败行为。
打包与引用
开发时将三个仓库放在同级目录。先在本仓库执行:
.\tools\pack.ps1
# 只改 Controls:在其 csproj 递增版本,再执行 .\tools\pack.ps1 -Package Controls。
# 只改 Local:在其 csproj 递增版本,再执行 .\tools\pack.ps1 -Package Local。
脚本严格构建并生成所选包,默认选择两个包;输出位于 .artifacts/packages/。发现目标版本已存在时,在构建前拒绝覆盖。未变化的包继续消费已有产物,不连带升级。没有全局环境修改,不自动发布到公网。
当前 Controls 为 2.1.2,Local 为 2.0.1,目标框架为 net11.0;Controls 使用 AtomUI 6.2.15 及 Avalonia 12.1.6 重新编译。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" />
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 | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net11.0 is compatible. |
-
net11.0
- Microsoft.Data.Sqlite (>= 11.0.0)
- System.Security.Cryptography.ProtectedData (>= 11.0.0)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on Lesphere.Desktop.Local:
| Package | Downloads |
|---|---|
|
Lesphere.Desktop.Controls
乐枢桌面公共控件:窗口、列表、表单和对话框,统一沿用未来药店的 AtomUI 视觉规范。 |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 2.0.1 | 123 | 11/16/2026 |