WinAppSDK 是什么

WinUI 3 不是一个孤立的 UI 库，它跑在 Windows 应用 SDK（WinAppSDK）之上。这个 SDK 把现代窗口、输入、合成、通知这些能力打包成一套不依赖特定 Windows 版本的 API。理解了 SDK 的分层，你才知道哪些是 UI、哪些是系统能力。

WinUI 3 = WinAppSDK 提供的现代控件与合成 + 你的业务页面。
分层速记
  • UI 层XAML 控件、样式、布局。
  • 系统层窗口、通知、存储、启动。
  • 运行时随 SDK 分发，不强绑系统版本。
WinUI 3 配图：中央一块半透明圆角应用窗口轮廓，窗口内外漂浮发光的几何方块与连线节点
窗口居中，控件方块在四周被光链串起。

窗口与应用生命周期

App.xaml.cs 里 OnLaunched 是入口。进阶要掌握的是窗口管理：用 AppWindow 拿到底层窗口句柄，自定义标题栏、改尺寸、多窗口。现代应用常自绘标题栏，把客户区拉满，这一切都靠 Window.AppWindow 完成。

// 伪代码：拿到 AppWindow 并自定义
var aw = Window.AppWindow;
aw.TitleBar.ExtendsContentIntoTitleBar = true;

导航与页面组织

企业应用大多是导航视图加内容区。用 NavigationView 做侧边导航，Frame 做页面容器，点击跳转时记住选中项与返回栈。页面之间传参，走页面的参数而不是静态变量，方便单元测试与回退。

资源、样式与主题

颜色、字体、间距都收敛在 ResourceDictionary。主题走 Light/Dark 两套资源，自动跟随系统。进阶做法是做一份品牌色覆盖字典，让控件外观统一换肤，而不是在每个页面里硬写颜色。

通知与系统集成

现代应用要能弹 toast 通知、能注册后台任务、能关联文件类型。这些能力 WinAppSDK 都提供了对应 API。常见的坑是通知需要正确的应用标识，未打包的应用和打包的应用行为不同，发布前必须分场景验证。

进阶清单
  • 自定义标题栏客户区拉满。
  • 导航框架NavigationView + Frame。
  • 主题换肤资源字典统一覆盖。
  • 通知集成打包态单独验证。