生成的代码已准备好进行评审,无法自动交付。 在最后这一步中,你将练习识别一个看似合理的框架错误,并在不止于编译的层面上验证 Task Tally。
故意测试助手
与助手开始新的对话,使其不依赖于前面提示的约束。 询问:
Add a confirmation dialog before deleting a task from my Windows XAML app.
Show only the using directives and the dialog construction code.
不受约束的助手可能会返回:
using Windows.UI.Xaml.Controls;
var dialog = new ContentDialog
{
Title = "Delete task?",
PrimaryButtonText = "Delete",
CloseButtonText = "Cancel"
};
这是 UWP 命名空间。
ContentDialog 在 WinUI 3 中也存在,这使得该错误在代码评审时很容易被忽略。
对于此项目,命名空间必须为:
using Microsoft.UI.Xaml.Controls;
var dialog = new ContentDialog
{
Title = "Delete task?",
PrimaryButtonText = "Delete",
CloseButtonText = "Cancel",
XamlRoot = this.XamlRoot
};
WinUI 3 ContentDialog 引用 URL 包括 microsoft.ui.xaml.controls。 UWP ContentDialog 引用使用 windows.ui.xaml.controls。
这就是为什么仅仅因为“Windows 文档里提到了这种类型”还不够。 检查框架、命名空间、版本和应用模型。
对生成的代码使用框架检查
当助手添加Windows API 时,请使用以下问题对其进行检查:
| 检查 | 应该注意什么 |
|---|---|
| Framework | 这份文档是关于 WinUI 3 和 Windows 应用 SDK 的吗? |
| 命名空间 | UI 代码是否使用 Microsoft.UI.Xaml,而不是 System.Windows 或 Windows.UI.Xaml? |
| 版本 | API 在项目引用的Windows 应用 SDK版本中是否可用? |
| 应用模型 | API 是否需要包标识、应用功能或窗口初始化? |
| 线程处理 | 调用必须在 UI 线程上运行吗? 是否会等待异步操作完成? |
| UX | 方案是否有内置 WinUI 控件或模式? |
| Accessibility | 生成的 UI 是否具有名称、标签、键盘访问和可见焦点? |
| 证据 | 你是否已对变更路径进行了构建、运行和测试? |
请助理提供支持其选择的 Learn URL,然后自行打开该 URL。
验证任务计数
进行最后一次验证:
- 删除应用的本地数据或从全新安装开始。 确认出现空状态,并且仅输入空格将禁用 “添加任务 ”。
- 添加多个任务,标记一个完成,然后删除另一个任务。 确认剩余数量已更新,并且已删除正确的项。
- 重启应用。 确认任务标题和完成状态已还原。
- 将
if (System.Diagnostics.Debugger.IsAttached) throw new IOException("Test save failure.");添加为TaskStorage.SaveAsync的第一行,重新生成,并在调试器中运行该应用。 触发保存,并确认InfoBar报告的是保存失败,而不是保存成功。 然后删除临时条件并重新构建。 - 使用 Tab 和 Shift+Tab 浏览每个交互式元素。
- 使用屏幕阅读器或适用于 Windows 的 Accessibility Insights 检查名称、角色和焦点顺序。
- 调整应用的大小、测试浅色、深色和对比度主题,并为 x64 生成,无需编译器、XAML、绑定或分析器警告。
优化提示,而不仅仅是代码
如果检查失败,请在下一个提示中保存更正和原因:
The generated code used Windows.UI.Xaml.Controls, which is the UWP
namespace. This project is WinUI 3. Replace it with the corresponding
Microsoft.UI.Xaml API, verify the API in the Windows App SDK reference,
build the x64 project, and explain why the original namespace was wrong.
这为助手提供了有用的证据,并强化了项目边界。 对于较长生存期的项目,请在编码助手读取的存储库说明中放置稳定的约束,例如框架、打包模型、目标体系结构和生成命令。
后续步骤
你已经构建了一个小型 WinUI 3 应用并练习了一个可以重复使用的工作流:
提问→生成→构建→检查→验证→优化
继续:
- 构建 WinUI 3 笔记应用,循序渐进地以代码为主介绍 XAML、导航和文件存储。
- 面向更大型 MVVM 架构的WinUI 中的数据绑定、依赖注入和单元测试。
- 使用 WinUI 3 示例库 验证运行中的示例里的控件和交互模式。
- Windows 应用 SDK API 引用以确认生成的 API 选项。