Windows App SDK 开发环境搭建完全指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_01007/article/details/148549808

Windows App SDK 开发环境搭建完全指南

WindowsAppSDK The Windows App SDK empowers all Windows desktop apps with modern Windows UI, APIs, and platform features, including back-compat support, shipped via NuGet. 项目地址: https://gitcode.com/gh_mirrors/wi/WindowsAppSDK

前言

Windows App SDK 是微软推出的现代化 Windows 应用开发框架，为开发者提供了统一的 API 和工具集。本文将详细介绍如何搭建完整的 Windows App SDK 开发环境，帮助开发者快速上手项目开发。

开发工具准备

1. Windows SDK 安装

Windows App SDK 开发需要以下两个 Windows SDK 版本：

Windows 10 SDK 10.0.17763.0 (RS5)
- 这是最低要求的 SDK 版本
- 可通过包管理工具安装
- 也可从微软官网下载安装程序手动安装
Windows 11 SDK 10.0.26100.2454 (24H2)
- 提供最新的 Windows 11 API 支持
- 需要从微软官网下载安装

注意：Visual Studio 2022 默认不包含这些 SDK，需要单独安装。

2. Visual Studio 2022 配置

Windows App SDK 开发需要 Visual Studio 2022 并安装以下组件：

必需工作负载

.NET 桌面开发
使用 C++ 的桌面开发
通用 Windows 平台开发

重要组件

.NET 6.0/7.0 运行时和 SDK
C++ 相关工具链（包括 ARM64/x64/x86 版本）
Windows 10/11 各版本 SDK
C++/WinRT 支持
NuGet 包管理器
MSBuild 构建系统

专业建议：可以使用 Visual Studio 的配置导入功能，一次性安装所有必需组件，避免遗漏。

3. NuGet 恢复

项目依赖通过 NuGet 管理，需要执行以下步骤：

下载最新版 nuget.exe 命令行工具
在项目根目录执行恢复命令
确保所有依赖包正确下载

一次性环境配置

运行 DevCheck.cmd 脚本（需要管理员权限）完成以下配置：

验证开发者模式：确保 Windows 已启用开发者模式
检查 VS 组件：确认所有必需组件已安装
证书配置：创建测试证书用于包签名
测试环境：安装 TAEF 测试服务
依赖验证：检查项目依赖版本是否正确

注意：测试证书通常一年后过期，届时需要重新运行此脚本更新证书。

项目构建指南

Visual Studio 构建

打开 WindowsAppRuntime.sln 解决方案
确保选择正确的平台（如 x64），避免使用 "Any CPU"
通过菜单或右键菜单构建整个解决方案或特定项目

命令行构建

使用 msbuild 可以实现更灵活的构建方式：

# 清理解决方案
msbuild WindowsAppSDK.sln -t:Clean -p:Configuration=Debug -p:Platform=X64

# 构建解决方案
msbuild WindowsAppSDK.sln -t:Build -p:Configuration=Debug -p:Platform=X64

# 重建解决方案
msbuild WindowsAppSDK.sln -t:Rebuild -p:Configuration=Debug -p:Platform=X64

高级技巧：

使用 -bl 参数生成二进制日志，便于问题排查
使用 -ds 参数获取详细构建摘要

常见问题解决

证书过期问题

症状：

构建时出现签名错误
错误信息提到找不到符合条件的证书

解决方案：重新运行 DevCheck.cmd 脚本更新测试证书

测试指南

Windows App SDK 使用 TAEF (Test Authoring and Execution Framework) 作为测试框架：

Visual Studio 测试

通过 Test Explorer 查看和运行测试
支持运行/调试单个或一组测试

命令行测试

# 运行指定测试 DLL
te.exe TestProject\TestProject.dll

# 运行名称匹配特定模式的测试
te.exe TestProject\TestProject.dll /name=*Feature*

# 获取详细测试输出
te.exe TestProject\TestProject.dll /logoutput:low