WinUI 3 迁移指南

原名：winui3-migration-guide

评估并规划 WPF、UWP 或旧 Windows 桌面界面向 WinUI 3 的迁移。

中文 Skills 技能说明

适合 Windows 客户端现代化。先盘点控件、窗口、打包、系统 API 和第三方依赖，再采用可回退的分阶段方案；不承诺所有功能可直接一键迁移。

上游能力依据

上游原始适用说明：UWP-to-WinUI 3 migration reference. Maps legacy UWP APIs to correct Windows App SDK equivalents with before/after code snippets. Covers namespace changes, threading (CoreDispatcher to DispatcherQueue), windowing (CoreWindow to AppWindow), dialogs, pickers, sharing, printing, background tasks, and the most common Copilot code generation mistakes.

上游 SKILL.md 主要章节（保留原文标题）：

• Namespace Changes
• Top 3 Most Common Copilot Mistakes
• 1. ContentDialog Without XamlRoot
• 2. MessageDialog Instead of ContentDialog
• 3. CoreDispatcher Instead of DispatcherQueue
• Windowing Migration
• Window Reference
• Window Management
• Title Bar
• Dialogs and Pickers Migration

使用边界

先读取项目约定、依赖版本和现有测试，再提出最小改动。写文件、运行脚本、提交代码或发布前应检查差异并保留回退路径。

作者、翻译与许可证

原作者

GitHub, Inc. 与 awesome-copilot contributors

中文翻译

CEOFans翻译

许可证

MIT

上游来源

https://github.com/github/awesome-copilot/tree/3f0bba475ec40b9680e1d0311b9caffeec5ad4c3/skills/winui3-migration-guide

适用范围

平台：linux、macos、windows；标签：架构与规划、WinUI 3 迁移指南

安全提示

基础静态扫描不等于绝对安全。技能可能调用命令、浏览器、云服务或本地文件，请在最小权限环境中使用，高风险操作必须人工确认。

如发现侵权、许可证或安全问题，可在本页前台提交投诉，管理员复核后可立即下架。